# Freehire Tailor Cv > Tailoring a CV to a vacancy (beta) - Skill: `strelov1/freehire-tailor-cv` (Agent Skill) - Install (CLI): `npx skillmds@latest add strelov1/freehire-tailor-cv` - Raw SKILL.md: https://api.skillmd.com/api/skills/strelov1/freehire-tailor-cv/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: strelov1 (https://skillmd.com/u/strelov1) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/strelov1/freehire-tailor-cv --- # Tailoring a CV to a vacancy (beta) Needs a key: `freehire auth login --token fhk_…` (or `FREEHIRE_TOKEN`). These commands act as the user whose key you signed in with, the same as every other command. A tailored CV is a copy of the candidate's base CV bound to one vacancy. Start one — or reopen the one that exists — with the vacancy's slug, and the whole cycle runs from here: ```bash freehire cv tailor # create/reopen the copy; prints the CV id freehire cv list # the tailored CVs that already exist freehire cv context # the fit analysis to reframe toward (JSON) freehire cv get # the current CV document (JSON) freehire cv edit --set 'path=value' # one edit; --ops '' or stdin for several freehire cv render --out cv.pdf # download the ATS PDF to inspect ``` `cv tailor` is idempotent per vacancy: running it twice for the same slug returns the same copy, so it is safe to start with when you do not know whether one exists. It spends an AI credit the first time it creates the copy (402 when the balance will not cover it) and 409s when the candidate has no résumé on the site to seed a base CV from — tell them to upload one; you cannot do it for them. The id is opaque: read it from `cv tailor` or `cv list`, do not construct or guess one. An id that is not the caller's own comes back as "not found" — the same answer as one that never existed. The workspace URL on the site (`/tailor/?cv=`) carries the same id if the candidate would rather paste it. ## Editing by path An edit is a kind (`set`, `insert`, `remove`, `move`) and a path into the document. Paths reach everything: `summary`, `experience[2].bullets[1]`, `experience[0].stack[0]`, `skills[0].items[3]`, `education[1].degree`, `certifications[0].issuer`, `style.font_size`. Indices are 0-based, counted over what `cv get` returned. ```bash freehire cv edit --set 'summary=Senior backend engineer…' freehire cv edit --set 'experience[0].bullets[1]=Cut p99 latency 40%' --evidence freehire cv edit --insert 'experience[0].bullets[0]=Ran the migration' --evidence freehire cv edit --remove 'skills[2]' freehire cv edit --ops '[{"kind":"move","path":"experience[0].bullets[2]","to":0}]' ``` Send edits that belong together in ONE call: they land as one entry in the candidate's history and cost one round instead of several. The whole batch applies or none of it does — an unknown path or an index past the end is a 422 and the CV is untouched. Every edit is recorded and can be undone on its own from the tailoring workspace, so the candidate can see exactly what you changed and reverse any one of it. ## The honest wall — never fabricate Editing with an API key edits as the tailoring agent, and the server holds you to it: the candidate's own name, email, phone and links are refused, and anything stating what they DID — a summary, a bullet, a technology, a skill — needs `--evidence `, the id of something they asserted. An uncited edit refuses the whole batch. Read `cv context` and split the work: - `missing_have` requirements: the candidate *has* the evidence but the CV omits it — **reframe** an existing bullet toward the vacancy's language (`--set` on the bullet's path, grounded in what they already did). - `missing_gap` requirements: a genuine gap — **ask the candidate first** ("do you know X? how did you use it?"). Only write it after they confirm real experience. On "no", leave it out; a gap belongs in the cover letter, never keyword-stuffed into the CV. - A confirmed new fact goes into the tailored CV, and you should offer to also add it to the candidate's base CV (`freehire cv edit …`) so future tailoring reuses it. The server sanitizes and validates every patch; bad addressing is a 422. Re-render after meaningful edits and keep the CV to 1–2 pages. To measure a stack against the market rather than one vacancy, use the **freehire-market-fit** skill.