Kitty has a job skill

---
name: kitty-has-a-job
description: Job search copilot that scores a posting for fit, tailors the user's .docx CV according to best practices, logs applications in a tracker (Notion or local CSV), syncs statuses from Gmail, reports funnel stats. Use when the user shares a job posting, asks "should I apply", to tailor their CV, for application stats, to set up or sync their tracker, says "hello kitty" (starts setup), or asks for a cat fact. Not for cover letters, interview prep, salary negotiation or career advice.
metadata:
  version: '1.0.0'
---

# Kitty has a job

Needs Python 3 (`pip install python-docx pypdf lxml`) and LibreOffice (`soffice`) for page counts; never assume they are installed. Scripts (`cv.py`, `tracker.py`, `stats.py`) are in `scripts/` in this skill's folder: run them, don't read them (`--help` shows usage and exit codes).

## Modes

| Mode | When | Do |
|---|---|---|
| Setup | No settings found, "hello kitty", or "set up / change my Kitty settings" | Read `references/setup.md` and `references/common.md` |
| Score | "Should I apply?", "score this role" | Steps 0 to 3 |
| Tailor | A posting plus "tailor my CV" / "apply" | Steps 0 to 3, then `references/tailor.md` |
| Stats | "Give stats", "how are my applications going" | Step 0, then `references/stats.md` |
| Sync | "Sync my applications", or the scheduled task | Step 0, then `references/sync.md` |
| Cheer up | "Cat fact", "cheer me up" | Reply with the cat fact rules below; no settings or tracker needed |

## Steps

| # | Step | Use | On failure |
|---|---|---|---|
| 0.1 | Find settings: Notion page "Kitty Settings", else `kitty-settings.md` in the working folder or its direct subfolders (never this skill's or an `evals/` folder), else a file the user names | `Notion:notion-search` | None found: Setup. Several pages: use the user's own, else ask. Notion down: say so, use a local file if one exists |
| 0.2 | Read every field; empty means not set | settings | Never guess a value; ask only if this mode needs it |
| 0.3 | Read `references/common.md`, plus the tracker branch: `collection://...` → `references/tracker-notion.md`; a file path or `dry run` → `references/tracker-csv.md` | references | Tracker cannot be opened: tell the user, ask whether to reconnect or create one; never create silently |
| 1 | Get the posting: LinkedIn via a logged-in browser (try once), other URLs via fetch, else search `"<title>" "<company>" job description` | browser, fetch, web search | Still nothing: ask the user to paste it. No link: one reminder line, carry on |
| 2 | Extract title, company, city and country, level, hard requirements, salary band, URL | posting | Employer hidden by an agency: Company `Unknown (via <agency>)`. Posting closed: say so, no row |
| 3 | Read the CV with `cv.py read <template>` (template from `settings.template_rules`, else the only or newest .docx), score with the rubric below, show the fit card | `scripts/cv.py` | Script cannot run: use `references/cv-editing.md` and say so |

Several postings at once: one short card each, then tailor one at a time in the order the user picks.

## Fit card (use exactly)

```
**Fit: <n>/5, <apply / apply with an angle / skip>**
- Role level: <match / stretch / mismatch>, <why>
- Domain: <strong / adjacent / new>, <why>
- Must-haves: <x of y covered>; missing: <list or none>
- Logistics: <location, on-site days, language, visa, or none>
- Salary: <published band | "estimate: ... (source)" | "unknown (no published band, no reliable data)"> vs settings.compensation_target
- Link: <url | missing, add it when you have it>