Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add trailofbits/skills --skill code-improver -a claude-code
Open on GitHub

What 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/mcp with reviewer plugin-dev:skill-reviewer, max three rounds
  • Start improvement loop on src/api with reviewer security-audit:check

How to install code-improver

1Skills CLI (Vercel)

npx skills add trailofbits/skills --skill code-improver -a claude-code

2Manually: put the files in place

~/.claude/skills/code-improver/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/code-improver/

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.

Similar skills

All skills for Code review and refactoring →

From the same set95

The whole set →
writing-lean-proofs writing-lean-proofs is a Claude Code skill for writing and reviewing Lean 4 proofs in line with Mathlib conventions. It comes into play for theorem proving, library design, proof refactoring, and project checks. CX Codex +1 1,800installs trailmark-variant-neighborhood The trailmark-variant-neighborhood skill expands a suspected vulnerability into related code locations for review. Use it before variant analysis, Semgrep, static analysis, or a manual audit. CX Codex +1 1,800installs goal-prompt Generates copy-paste /goal directives for Claude Code and Codex with verified stop conditions and invariant checks. CX Codex +1 1,700installs pr-improver The pr-improver skill cycles through review and fixes for the current branch’s changes. Use it to address findings before opening or updating a pull request. CX Codex +1 1,600installs post-patch-validation post-patch-validation runs exploits and regression checks against both the vulnerable and patched revisions, so you can see whether a security fix actually holds. CX Codex +1 1,400installs review-walkthrough review-walkthrough turns the current branch diff into an HTML walkthrough with logical steps, explanations and review findings. Run it by hand when you want to read a change properly. CX Codex +1 1,200installs patching-bugs The patching-bugs skill takes one known bug through reproduction, a patch, independent proof, regression checks, and a local report. CX Codex +1 699installs reproduce-bug The reproduce-bug Claude Code skill checks whether a named compiler or runtime bug can be reproduced in a local repository. It runs against the project baseline before any edits. CX Codex +1 692installs

Project sponsors

Companies that keep this analytics open