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...

Security Scan

The skill's stated purpose (building a job-search report from Gmail) matches its instructions and required binary; it asks the user to authorize a Gmail-capable CLI and only references Gmail data and local file saving.

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 '[e-mail]' (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.

Assessment

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 '[e-mail]'). 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.

Job Search Report Generator

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

Prerequisites

gog authenticated with Gmail:

gog auth add [e-mail] --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 [e-mail] \
  --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 [e-mail] \
  --json

Step 3: Cross-reference and build application map

For each sent application, find matching replies by:

• Matching domain (sent to [e-mail] → 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] <email>
- **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 << '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.