improvement-plan — Claude Code skill: setup and features
The improvement-plan Claude Code skill turns a composite resume and profile score into a ranked list of fixes. It runs after scoring or when asked what to address first.
no license ★ 73 updated 2026-11-11
/plugin marketplace add Vets-Who-Code/ai-era-job-kit
/plugin install ai-era-job-kit@ai-era-job-kitWhat improvement-plan does
The skill builds a prioritized improvement plan from a composite score. A failed resume gate comes first; remaining sections are ranked by points left, using each section’s weight and its gap to 100. The plan lists failed checks and their fixes, with machine and human scores averaged.
Run python3 $KIT/scripts/scorecard.py plan --composite composite.json --md plan.md to read composite.json and write plan.md. Work starts with portfolio.json and brag/entries, then the resume, LinkedIn, GitHub, and portfolio surfaces are updated. Numbers and skills must be backed by evidence; an unproven skill belongs on a build list, not in a claim.
What it helps with
- rank failed checks by likely score gain
- identify skills that could lift a resume score
- spot mismatches across a resume, LinkedIn, GitHub, and a portfolio
- turn assessment gaps into specific edits
Example prompts for the agent
- Use the composite score to draft an improvement plan and rank the first fixes.
- Read
composite.jsonand write prioritized edits toplan.md. - Compare the resume, LinkedIn, GitHub, and portfolio, then list their mismatches.
How to install improvement-plan
1Plugin marketplace
/plugin marketplace add Vets-Who-Code/ai-era-job-kit/plugin install ai-era-job-kit@ai-era-job-kitThis installs the whole ai-era-job-kit plugin with all its skills
2Skills CLI (Vercel)
npx skills add Vets-Who-Code/ai-era-job-kit --skill improvement-plan -a claude-code3Manually: put the files in place
~/.claude/skills/improvement-plan/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/improvement-plan/
1Skills CLI (Vercel)
npx skills add Vets-Who-Code/ai-era-job-kit --skill improvement-plan -a codex2Manually: put the files in place
.agents/skills/improvement-plan/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Vets-Who-Code/ai-era-job-kit --skill improvement-plan -a cursor2Manually: put the files in place
.cursor/skills/improvement-plan/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Vets-Who-Code/ai-era-job-kit skills/improvement-plan2Manually: put the files in place
.github/skills/improvement-plan/SKILL.md1Skills CLI (Vercel)
npx skills add Vets-Who-Code/ai-era-job-kit --skill improvement-plan -a gemini-cli2Platform CLI
gemini skills install https://github.com/Vets-Who-Code/ai-era-job-kit --path skills/improvement-planManually: put the files in place
.devin/skills/improvement-plan/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about improvement-plan
How do I install improvement-plan in Claude Code?
Add the marketplace with /plugin marketplace add Vets-Who-Code/ai-era-job-kit, then install it with /plugin install ai-era-job-kit@ai-era-job-kit.
What does improvement-plan do?
It turns composite resume and profile scores into a ranked set of fixes. The plan covers failed checks, high-impact resume skills, and mismatches across surfaces.
What does improvement-plan need to run?
It needs Python 3 and a composite.json file for scorecard.py. The generated plan is saved as plan.md.