Commands

---
description: Analyze skill gaps across your tracked jobs (aggregate) or one posting (targeted), then build a prioritized, web-sourced learning plan and save a report.
argument-hint: "[job url | pasted posting | (blank for aggregate)]"
allowed-tools:
  - Read
  - Write
  - Edit
  - Bash
  - Glob
  - Grep
  - WebSearch
  - WebFetch
---

# /upskill — Skill Gap Analysis

> **Spec:** REQ-3001–3011, ARCH-0040 (Career Development), ARCH-0008
> **Backed by:** the `career-development` Plane-1 skill
> **Used by:** the dashboard Upskill surface (reads the `upskill/report-*.md` files this produces)

Activate the **`career-development`** skill and run its full workflow:

1. **Pick the mode** (REQ-3001):
   - `/upskill` (no argument) → **aggregate** mode — analyze every job in
     `job_search_tracker.csv`. If the tracker is empty, say so and suggest targeted mode
     instead of writing an empty report.
   - `/upskill <url>` (or pasted posting text) → **targeted** mode — analyze one posting.
     If the URL can't be fetched, ask for a paste (DEC-011); never abort.
2. **Load data** (REQ-3002, REQ-3003) — candidate profile always; tracker + most recent
   previous report in aggregate mode; the fetched/pasted posting in targeted mode.
3. **Pass 1 — hard-skill diff** (REQ-3004) — required/preferred skills vs. profile,
   fit-weighted in aggregate mode; generous matching removes skills already held.
4. **Pass 2 — synthesis** (REQ-3005) — domain / soft / tooling / credential gaps.
5. **Gap heatmap** (REQ-3006, REQ-3011) — Critical/High/Medium/Low table printed first;
   Low gaps listed but not planned.
6. **Learning plan** (REQ-3007) — 2–3 **real, web-searched** resources per Critical/High
   gap (and Medium when <5 gaps total), with study direction and time estimate. Never
   fabricate resources (ARCH-0007).
7. **Study order** (REQ-3008) — dependency-aware numbered sequence with total time.
8. **Save the report** (REQ-3009, REQ-3010) — always write
   `upskill/report-YYYY-MM-DD.md` (aggregate) or
   `upskill/report-YYYY-MM-DD-<company>-<role>.md` (targeted), including the since-last
   delta in aggregate mode.

Full behavior lives in `.claude/skills/career-development/SKILL.md`.