career-ops

career-ops

Your AI job-search co-pilot, installed as a Claude Code skill. Scans portals, scores every posting against your profile, drafts tailored CVs and cover letters, logs everything to a Notion tracker — and stops before clicking Submit so you stay in control.

📖 Full step-by-step walkthrough from install to your first submitted application: MANUAL.md

---

✨ What you get

• 🔍 Portal scanner — LinkedIn, Indeed, Glassdoor, Welcome to the Jungle, Handshake, Reed UK, plus zero-cost ATS APIs (Greenhouse, Ashby, Lever, Workable)
• 📊 A–G evaluation blocks — every posting scored 0–100 against your CV, with reasoning
• 📝 Tailored CVs + cover letters — archetype-driven, ATS-clean, one-page A4
• 🗂️ Notion tracker auto-created — full schema, three dashboard views (Pipeline kanban, By score, Active interviews)
• 🎯 Interview prep — STAR+R stories, company intel, JD-tailored question bank
• ⏰ Scheduled scans — pick a time of day, it runs itself
• 🛑 Never auto-submits — fills forms, drafts answers, stops at Submit

---

🚀 Quickstart

For the full step-by-step walkthrough with every onboarding question explained, every daily-workflow mode, and a troubleshooting section, see MANUAL.md.

1. Install

# macOS / Linux
git clone https://github.com/marz1307/career-ops ~/.claude/skills/career-ops
cd ~/.claude/skills/career-ops && npm install

# Windows (PowerShell)
git clone https://github.com/marz1307/career-ops $env:USERPROFILE\.claude\skills\career-ops
cd $env:USERPROFILE\.claude\skills\career-ops; npm install

That's it. The clone is the skill bundle — engine code, modes, templates, and node deps all live in ~/.claude/skills/career-ops/.

2. Run

Pick any folder to be your workspace (where your CV, profile, applications tracker, and generated PDFs will live):

mkdir ~/career-ops-workspace
cd    ~/career-ops-workspace
claude

Then in the Claude Code chat:

/career-ops

3. Onboarding

The skill walks you through eight questions:

#	Question	Why
1	Where's your CV?	Paste / file path / LinkedIn / draft from scratch
2	LinkedIn URL?	Goes in your profile
3	Portfolio / GitHub?	Optional
4	Target markets?	UK / EU / US / Remote (multi-select)
5	Target roles?	List them, or have the skill infer from your CV
6	Bright Data API key?	Powers LinkedIn / Indeed / Glassdoor scraping
7	Notion integration token?	Auto-creates your Applications database
8	Scheduled scan hour?	07:00 / 12:30 / 18:00 / custom / off

When you're done, your workspace contains cv.md, config/profile.yml, portals.yml, modes/_profile.md, .env, plus a fresh Notion DB with three dashboard views.

---

🧭 How it works

                ┌──────────────┐
                │  /career-ops │   ← you invoke the skill
                └──────┬───────┘
                       ▼
         ┌─────────────────────────────┐
         │  scan portals               │ ← Stage 1 (Discovered)
         └─────────┬───────────────────┘
                   ▼
         ┌─────────────────────────────┐
         │  A–G evaluation             │ ← Stage 2 (Triaged)
         │  Match score 0–100          │   < score_floor → Not pursuing
         └─────────┬───────────────────┘
                   ▼
         ┌─────────────────────────────┐
         │  tailored CV + cover letter │ ← Stage 3 (Drafted)
         │  attached to Notion row     │
         └─────────┬───────────────────┘
                   ▼
              [you review]
                   ▼
         ┌─────────────────────────────┐
         │  apply (you click Submit)   │ ← Stage 4 (Applied)
         └─────────────────────────────┘

Beyond Stage 4 (assessment, phone screen, tech, onsite, offer) is tracked through modes/response-tracker.md.

---

📂 What's in the box