jobsearch-apply-mcp: Skill for Claude Code

Upskill

---

Overview

/upskill analyses jobs you have tracked and your current profile to identify skill gaps, then produces a heatmap of those gaps and a learning plan with concrete, web-searched study resources and a recommended study order.

Invocation

• /upskill — aggregate mode: analyses all jobs in job_search_tracker.csv, merged with ranked postings (rank_score >= 45) from job_scraper/seen_jobs.json
• /upskill <URL> — targeted mode: analyses a single job posting fetched from the URL

---

Step 1: Detect Mode

Check whether the user provided a URL argument:

• If the invocation was /upskill with no argument → aggregate mode
• If the invocation was /upskill <URL> → targeted mode, store the URL for Step 2

In targeted mode, derive a slug from the job title and company for the report filename (e.g. guardsix-senior-ai-engineer). You will fetch the posting in Step 2.

Step 2: Load Data

Aggregate mode

1. Read job_search_tracker.csv. Extract all rows. The columns are: date, company, sector, role, role_type, channel, status, contact_person, fit_rating, notes, cv_file, cover_letter_file, source, deadline
2. For each row, note the role, company, and fit_rating. The fit_rating column is a 0–100 score where 100 = perfect fit. You will use it to weight gaps — a lower fit rating means the role exposed more gaps.
3. Read job_scraper/seen_jobs.json. Keep entries with "status": "ranked" and rank_score >= 45 — the Moderate Fit floor from 04-job-evaluation.md (below that, a job is Weak/Poor Fit and would otherwise dominate the heatmap with jobs the user shouldn't chase). For each kept entry, note its title, company, rank_score, and — when present — its recorded gaps. An entry with no gaps field (ranked before gap persistence existed) is skipped, counted, and reported once in the terminal: "N ranked jobs were scored before gap persistence and contribute nothing; /rank --all re-scores them." Never back-fill a missing gaps field by guessing from the title.
4. Read .claude/skills/job-application-assistant/01-candidate-profile.md to get the candidate's current skills and experience.
5. Check upskill/ for the most recent aggregate report file (report-YYYY-MM-DD.md) — if one exists, note its date and load it for the diff in Step 8.