code-improver — Claude Code skill: what it does, how to install
code-improver runs a review-and-fix loop over any code target — module, plugin, directory — with a reviewer you name yourself.
CC-BY-SA-4.0 1,600 installs ★ 8,341 updated 2026-10-28
npx skills add trailofbits/skills --skill code-improver -a claude-codeWhat code-improver does
The skill is invoked with /code-improver:improve and three parameters: path to the target directory, name of an installed reviewer (skill or agent), and glob patterns the loop may touch. The loop runs through a workflow: it sends the code to the specified reviewer, hands findings to a fixer subagent, then reviews again — until critical and major findings drop to zero. It keeps a cross-round findings ledger, stops when fixes stop converging (same error returns, counts do not decrease), and escalates the decision to the user.
The reviewer must be installed beforehand: there is no bundled default. Without the Workflow tool the skill will not start: the loop logic, ledger, and scope guards live inside the workflow, and an inline imitation does not replicate them. If the loop hits the round cap (five by default), that is not convergence: the skill reports capped, lists remaining blocking issues, and provides metrics.
For Claude Code skills there is skill-improver, for branches there is pr-improver. code-improver is for arbitrary directories or modules where the reviewer is chosen manually.
What it helps with
- run code through a named reviewer until zero findings
- automate a review-fix-review cycle with convergence control
- escalate looping or scope violations
- maintain a findings ledger across improvement rounds
Example prompts for the agent
- Run
/code-improver:improve src/lib --reviewer pr-review-toolkit:review-pr --scope 'src/lib/**' - Improve directory
plugins/mcpwith reviewerplugin-dev:skill-reviewer, max three rounds - Start improvement loop on
src/apiwith reviewersecurity-audit:check
How to install code-improver
1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill code-improver -a claude-code2Manually: put the files in place
~/.claude/skills/code-improver/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/code-improver/
1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill code-improver -a codex2Manually: put the files in place
.agents/skills/code-improver/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill code-improver -a cursor2Manually: put the files in place
.cursor/skills/code-improver/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install trailofbits/skills plugins/code-improver/skills/code-improver2Manually: put the files in place
.github/skills/code-improver/SKILL.md1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill code-improver -a gemini-cli2Platform CLI
gemini skills install https://github.com/trailofbits/skills --path plugins/code-improver/skills/code-improverManually: put the files in place
.devin/skills/code-improver/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add trailofbits/skills --skill code-improver -a opencodeClaude.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 code-improver
How to install code-improver in Claude Code?
Run npx skills add trailofbits/skills --skill code-improver -a claude-code, then open ~/.claude/skills/code-improver/SKILL.md.
What does code-improver do?
It runs an autonomous review-and-fix loop over a chosen directory or module with a reviewer you specify. The loop keeps a findings ledger, checks convergence, and stops when fixes start looping.
Which reviewer does code-improver use?
You choose the reviewer yourself — any installed skill or agent. There is no bundled reviewer; without an explicit name the skill will ask for one.