← Back to Skills Marketplace
xiaoxty

Job Search Report

by xiaoxty · GitHub ↗ · v0.1.0 · MIT-0
cross-platform ✓ Security Clean
174
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install job-search-report
Description
Generate a comprehensive job search progress report by analyzing sent applications and received replies from Gmail. Activate when user asks for a job search...
README (SKILL.md)

Job Search Report Generator

Analyzes Gmail history to generate a complete job search progress report.

Prerequisites

gog authenticated with Gmail:

gog auth add [email protected] --services gmail

When to Activate

  • "生成求职报告"、"job search summary"、"show me my application status"
  • "我投了哪些公司"、"how many companies have I applied to"
  • "求职进展怎么样"、"create a job search dashboard"

Data Collection Workflow

Step 1: Pull sent applications

# Find all job application emails sent
gog gmail messages search "in:sent (application OR resume OR apply OR applying OR interested in the position) newer_than:90d" \
  --max 100 \
  --account [email protected] \
  --json

Step 2: Pull all replies received

# Find all recruiter/HR replies
gog gmail messages search "in:inbox (interview OR application OR resume OR opportunity OR position OR hiring OR recruiter) newer_than:90d" \
  --max 100 \
  --account [email protected] \
  --json

Step 3: Cross-reference and build application map

For each sent application, find matching replies by:

  • Matching domain (sent to [email protected] → replies from *@company.com)
  • Matching subject thread (Re: prefix)
  • Date ordering (reply must be after application)

Report Structure

Generate the full report in this format:

# 📊 Job Search Report
Generated: [date]
Period: Last [N] days
Account: [email]

---

## 📈 Overview

| Metric | Count |
|---|---|
| Total Applications Sent | [N] |
| Companies Replied | [N] |
| Reply Rate | [N]% |
| Interview Invites | [N] |
| Currently In Process | [N] |
| Rejections Received | [N] |
| Awaiting Reply (>7 days) | [N] |

---

## 🟢 Active Opportunities (Priority)

### [Company Name] — [Job Title]
- **Applied**: [date]
- **Status**: 🟢 Interview Scheduled / 🔵 In Discussion
- **Contact**: [recruiter name] \x3Cemail>
- **Latest Update**: [date] — "[key sentence from last email]"
- **Next Action**: [specific action + deadline]

---

## 🔵 Positive / In Progress

### [Company Name] — [Job Title]
- **Applied**: [date]
- **Status**: 🔵 Responded Positively
- **Latest**: [date] — [summary]
- **Next Action**: [action]

---

## 🟡 Awaiting Your Response

### [Company Name] — [Job Title]
- **They need**: [salary info / portfolio / references / assessment]
- **Deadline**: [if mentioned]
- **Next Action**: Prepare and reply ASAP

---

## ⚪ Applied — No Reply Yet

| Company | Role | Applied | Days Since | Follow Up? |
|---|---|---|---|---|
| [Company] | [Role] | [date] | [N] days | [Yes if >7d] |

---

## 🔴 Closed (Rejections)

| Company | Role | Applied | Rejected | Notes |
|---|---|---|---|---|
| [Company] | [Role] | [date] | [date] | [reason if given] |

---

## ⚡ Action Items

Priority actions sorted by urgency:

1. 🔴 **[URGENT]** Reply to [Company] interview invite — respond today
2. 🟠 **[HIGH]** Send follow-up to [Company] — applied 10 days ago, no reply
3. 🟡 **[MEDIUM]** Prepare portfolio for [Company] request
4. 🟢 **[LOW]** Research [Company] before scheduled interview on [date]

---

## 📅 Timeline View

[Month Year]
  [Date] ✉️  Applied to [Company] — [Role]
  [Date] 📬 Reply from [Company] — Interview invite
  [Date] ✉️  Applied to [Company] — [Role]
  [Date] 📬 Rejection from [Company]
  ...

---

## 💡 Insights & Suggestions

**Response rate by industry**: [Tech: X% | Finance: X% | Marketing: X%]
**Average days to reply**: [N] days
**Most active day to apply**: [Day of week from data]

Suggestions:
- [Insight based on data, e.g. "You've applied mostly to large companies — 
   consider adding more startups for higher reply rates"]
- [e.g. "5 applications have been waiting >14 days — consider following up"]
- [e.g. "Your interview rate is X% — above/below the typical 5-10% benchmark"]

Save Report Options

After generating, offer to save:

# Save as markdown file
cat > ~/job-search-report-[date].md \x3C\x3C 'EOF'
[report content]
EOF

Or ask if user wants to save to a Google Doc:

# If user has gog docs access
gog docs export [docId] --format txt

Weekly Update Mode

If user asks "update my report" or "refresh":

  1. Fetch only new emails since last report date
  2. Show only the delta (new replies, status changes)
  3. Update the action items list
📬 Updates since [last report date]:
• [Company] replied — moved from "Awaiting" to "Interview Invite"
• [Company] — 14 days with no reply, suggested follow-up added
• New application sent to [Company]

Metrics Benchmarks (context for user)

Metric Typical Range What it means
Reply rate 5–20% Industry average; 20%+ means strong resume/targeting
Application-to-interview 5–15% Higher = strong resume + good fit
Days to first reply 3–14 days Most replies come in first week
Interview-to-offer 20–30% Varies widely by company

Use these to contextualize the user's numbers in the Insights section.

Usage Guidance
This skill will access your Gmail data through the 'gog' CLI after you run 'gog auth' — review and trust the gog tool before granting access. Confirm the account used (don't rely on the placeholder '[email protected]'). Understand that generated reports will be written to your home directory if you use the provided save example; be careful not to accidentally share sensitive email contents. If you only want a one-time report, consider revoking gog's access after use. Finally, the SKILL.md's Google Docs save example is vague (uses 'gog docs export' which appears to export rather than create); clarify how docs saving works before using it.
Capability Analysis
Type: OpenClaw Skill Name: job-search-report Version: 0.1.0 The skill is designed to generate a job search progress report by querying the user's Gmail account for application-related keywords using the 'gog' CLI tool. All actions, including searching sent/received emails and saving the resulting Markdown report to the local filesystem, are transparently described and directly support the stated purpose without any signs of data exfiltration, obfuscation, or unauthorized access (SKILL.md).
Capability Assessment
Purpose & Capability
Name/description ask to analyze Gmail and the SKILL.md uses a Gmail-aware CLI ('gog') to search Sent/Inbox and build a report. Requiring the 'gog' binary is proportional to the stated purpose.
Instruction Scope
Instructions explicitly tell the agent to search sent and inbox emails with specific queries, cross-reference replies, and produce/saved a markdown report. All actions are limited to Gmail and local file writes. Note: the examples hardcode '[email protected]' (agent should use the user's account) and some doc-save guidance (gog docs export) is unclear about creating/updating Google Docs.
Install Mechanism
This is instruction-only (no install spec or code), which minimizes install risk. The skill requires the 'gog' binary be present; the skill does not fetch arbitrary code. You should verify the origin/trustworthiness of 'gog' before installing it system-wide.
Credentials
No environment variables or unrelated credentials are requested. The only credentialing implied is user consent to authenticate 'gog' with Gmail — which is appropriate for accessing email data.
Persistence & Privilege
Skill is not forced-always and does not request to modify other skills or system-wide settings. It writes reports to the user's home (optional) and reads Gmail via the user's gog auth, which is expected behavior for this use case.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install job-search-report
  3. After installation, invoke the skill by name or use /job-search-report
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
- Initial release of job-search-report: generates a detailed job search progress report from Gmail data. - Detects and summarizes job applications sent and recruiter replies within the last 90 days. - Cross-references applications and replies to map statuses (active, in progress, no reply, rejections). - Produces a structured, markdown-formatted report including overview metrics, categorized company lists, timeline view, and insights. - Provides options to save the report as a markdown file or Google Doc. - Supports weekly update mode, showing only new changes since last report.
Metadata
Slug job-search-report
Version 0.1.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Job Search Report?

Generate a comprehensive job search progress report by analyzing sent applications and received replies from Gmail. Activate when user asks for a job search... It is an AI Agent Skill for Claude Code / OpenClaw, with 174 downloads so far.

How do I install Job Search Report?

Run "/install job-search-report" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Job Search Report free?

Yes, Job Search Report is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Job Search Report support?

Job Search Report is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Job Search Report?

It is built and maintained by xiaoxty (@xiaoxty); the current version is v0.1.0.

💬 Comments