cv-upgrade
Skill1 starsChanged 2 months agoMITView on GitHub
Audit and improve a CV using the vendored Career-Agents reviewer and strategist profiles — ATS parse safety, keyword alignment, impact rewrites, narrative and headline. Produces a prioritised report and a rewritten CV. Use when asked to improve, review, ATS-check or tailor a CV, or after /cv-intake surfaces weaknesses.
In this repository37 other files it gives its agents.
- wsb-data-pipelineSkill
- docx-exportSkill
- harvard-mdxSkill
- humanise-docx-reportSkill
- make-pdfSkill
- bom-builderSkill
- ring-testSkill
- batch-draftSkill
- cold-emailSkill
- cv-intakeSkill
- find-contactSkill
- followupSkill
- humanize-emailSkill
- log-outreachSkill
- outreach-statusSkill
- target-researchSkill
- erc-statusSkill
- log-sessionSkill
- score-auditSkill
- submission-checkSkill
- sumo-statusSkill
- trial-runSkill
- vr-statusSkill
- academic-registerSkill
- aviation-data-sourcesSkill
- business-frameworksSkill
- consultancy-registerSkill
- excel-deliverablesSkill
- forecasting-methodsSkill
- operations-frameworksSkill
- secondary-data-sourcesSkill
- archive-indexSkill
- event-proposalSkill
- meeting-minutesSkill
- read-boxnoteSkill
- captureSkill
- new-scriptSkill
The file
We split this skill into the rules it gives an agent
9 rules. About 0 are common, 8 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈8
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 23
Read the DOCX source too if there is one — it is the editable original and the better thing to change.
- Distinctive: line 27
No text inside images, headers or footers.
- Distinctive: line 28
No tables or multi-column layouts in the experience section
- Very specific: line 48
Follow the Clean Technical Document standard: US Letter, 1-inch margins, centered black title, dark teal #0F4761 sentence-case headings, …
- Distinctive: line 50
Keep the original. Save as a new version, never overwrite
- Distinctive: line 93
Never add a skill or tool the person cannot discuss for five minutes.
- Distinctive: line 94
Never inflate a title, a role or a level.
- Distinctive: line 95
Never remove dates or hide a gap.
- Distinctive: line 97
Keep it to one page for a student or an early-career candidate.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
/cv-upgrade, make the CV better
Usage: /cv-upgrade "<Person Name>" · /cv-upgrade "<Second Person>" --role "Junior Accountant"
Runs the Career-Agents profiles against a CV, under this repo's honesty contract. Those agents are third-party and are not included here; see third-party/README.md for how to install them. Record in your own project where your rules override upstream — the metric rule is the one that matters most, because a CV bullet with a fabricated percentage fails an interview.
Preconditions
- A CV exists in
<person>/cv/ /cv-intakehas run, soprofile.mdandevidence.mdexist to check claims against
Steps
- Extract the CV text. PyMuPDF is available:
Read the DOCX source too if there is one — it is the editable original and the better thing to change.python -c "import fitz,io,sys; sys.stdout=io.TextIOWrapper(sys.stdout.buffer,encoding='utf-8',errors='replace'); d=fitz.open(r'<path>'); [print(p.get_text()) for p in d]" - ATS parse audit — spawn
ats-resume-reviewer. Check:- Standard section headers (Experience, Education, Skills, Projects). Creative headers do not parse
- No text inside images, headers or footers. Parsers drop them
- No tables or multi-column layouts in the experience section
- Dates in a consistent, parseable format, and in reverse-chronological order
- Contact details as live text, not a graphic
- Text-based PDF, not a scan
- Bullets under two lines each
- Narrative audit — spawn
resume-strategist. Check:- Does the summary answer why-you-why-now in one glance, or is it a list of adjectives?
- Is there a single coherent thesis, or three competing ones?
- Does the top third of page one carry the strongest evidence? That is all a six-second skim sees
- Does every headline claim have a linkable artifact?
- Student-specific pass — spawn
internship-application-strategistwhen the person is a student or a recent graduate. It mines coursework, projects, societies and competitions for evidence that is on the CV but framed as filler. - Verify every claim against
profile.mdandevidence.md. Flag anything on the CV that has no source, and anything in the evidence bank strong enough to be on the CV but missing from it. - Write the report to
<person>/cv/CV-REVIEW-YYYY-MM-DD.md. - Produce the rewritten CV only when asked. The report comes first, because most of its findings are decisions for the person, not for an agent. When a rewrite is wanted:
- Edit the DOCX source where one exists, never the exported PDF
- Follow the Clean Technical Document standard: US Letter, 1-inch margins, centered black title, dark teal
#0F4761sentence-case headings, thin gray#7F7F7Fborders on every table cell, bold headers, minimal shading, real page breaks, no visible\newpage - Render the PDF and inspect every page for blank pages, clipping, overlap and broken flow
- Keep the original. Save as a new version, never overwrite
Output format
# CV review — <person>, YYYY-MM-DD
**Source:** <file>, <n> pages
**Target roles:** <what this CV is aimed at>
## Verdict
<two sentences. What is strong, what is costing interviews.>
## Fix first
| # | Issue | Where | Fix | Effort |
|---|---|---|---|---|
## ATS parse
| Check | Result | Note |
|---|---|---|
## Impact rewrites
| Original | Rewritten | Why |
|---|---|---|
## Narrative
Headline: <verdict>
Summary: <verdict>
Top-third test: <what a six-second skim actually picks up>
## Claims without a source
- <claim> — <not in profile.md / evidence.md>
## Evidence missing from the CV
- <thing in evidence.md strong enough to be here>
## Questions
1. <what only they can answer>Rules
- Never invent or estimate a metric. Upstream asks for a metric per achievement; this repo's honesty contract outranks it. Where no real number exists, write a qualitative impact line. A fabricated percentage survives the screen and dies in the interview.
- Never add a skill or tool the person cannot discuss for five minutes.
- Never inflate a title, a role or a level. Scope and impact do that work honestly.
- Never remove dates or hide a gap. Frame it.
- Preserve their voice. A CV rewritten into agency-speak reads worse and interviews worse.
- Keep it to one page for a student or an early-career candidate.
- Report first, rewrite second. Most findings need the person's answer, not a guess.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

