job-search

Judge whether a single job posting matches the user's Job Preferences Brief — relevant or not, and if relevant a weak/moderate/strong match — with plain-language reasoning, dealbreakers, and unknowns. Use when the user pastes or references a job posting and asks if it fits their preferences, whether to apply, or how good a match it is, or when job-search-run needs to evaluate postings. For many postings at once, job-search-run drives this skill per posting — do not batch here.

Build or update the user's Job Preferences Brief at a depth they choose — a quick free-form sketch (~1 question), a standard interview, or a thorough pass — producing a prose preferences.md (Summary, Must-haves/dealbreakers, Strong preferences, Nice-to-haves, Red flags). Imports an existing brief too, and can deepen a light brief later. Use when the user wants to set up or refine what they want in a job, or when job-search onboarding needs a brief: "set up my job preferences", "what I want in a job", "redo my preferences interview", "change my must-haves", "import my preferences brief". Not for judging a specific posting (→ evaluate-job-fit).

The operator manual for the Job Search Agent — configure, customize, extend, or troubleshoot the agent itself, or explain how it works. Use when the user asks how the agent works, why a run failed, what it can do, or how to change its behavior — a query, the schedule, the recency window, the detail-read model: "how does my job search agent work", "why did the run fail", "how do I change/add/customize …", "change how often it runs". Not for daily use — onboarding, the home view, and running a search are job-search; the search pass itself is job-search-run.

Run one headless, non-interactive job-search pass — load the preferences brief and config, search agent-data for each saved query, skip postings it has already seen, judge each new posting's relevance, read full descriptions for promising matches, and write a digest. Use to run the scheduled search, check for new jobs, or to run a search on demand: "run a job search now", "pull jobs now", "do a fresh search", or when invoked by a schedule. (For interactive setup or the home view, use job-search; for a single pasted posting, use evaluate-job-fit.)

Set up, check on, and steer the user's job search — the front door and home screen. Use when they want to start or set up a job search, see status, matches, the latest digest, or the pipeline, or change what they're looking for: "set up job search", "start my job search", "I'm looking for a new job", "check my job search", "show me my matches", "what's new in my pipeline", or /job-search. First run onboards end-to-end (prereqs, workspace, preferences interview, queries + frequency, first live search, scheduling); afterward it shows the job-search home with quick actions. Not for a fresh headless pull ("check for new jobs" → job-search-run) or for configuring/troubleshooting the agent itself (→ job-search-agent).