# code-improver

code-improver runs a review-and-fix loop over any code target — module, plugin, directory — with a reviewer you name yourself.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1600 installs · ★ 8341 repo stars
- Author: trailofbits
- License: CC-BY-SA-4.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/trailofbits/skills/tree/HEAD/plugins/code-improver/skills/code-improver/SKILL.md
- Updated: 2026-10-28
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/code-improver

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add trailofbits/skills --skill code-improver -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/code-improver/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/code-improver/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add trailofbits/skills --skill code-improver -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/code-improver/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add trailofbits/skills --skill code-improver -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/code-improver/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install trailofbits/skills plugins/code-improver/skills/code-improver
```

2. **Manually: put the files in place**
- File: `.github/skills/code-improver/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add trailofbits/skills --skill code-improver -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/trailofbits/skills --path plugins/code-improver/skills/code-improver
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/code-improver/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add trailofbits/skills --skill code-improver -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/trailofbits/skills/tree/HEAD/plugins/code-improver/skills/code-improver/SKILL.md

## When to use it
- 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
- 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`

## Similar
- [claude-flow](https://affpapa.org/en/nevibecode/plugins/claude-flow.md) — plugin · ★ 6 repo stars
- [copilot-goal-skill](https://affpapa.org/en/nevibecode/plugins/copilot-goal-skill.md) — plugin · ★ 18 repo stars
- [opencode](https://affpapa.org/en/nevibecode/skills/opencode.md) — skill · 493 installs
- [ns-autonomous](https://affpapa.org/en/nevibecode/skills/ns-autonomous.md) — skill · 152 installs
- [skill-improver](https://affpapa.org/en/nevibecode/skills/galaxy-dawn-skill-improver.md) — skill · 406 installs
- [agents-md-improver](https://affpapa.org/en/nevibecode/skills/agents-md-improver.md) — skill · 145 installs

From the same set: [trailofbits/skills](https://affpapa.org/en/nevibecode/by/trailofbits/skills.md) — 95 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
