Trail of Bits

Skill Improver — Productivity skill for Claude Code

Productivity community Advanced

Trail of Bits security skill for skill improver.

How to install Skill Improver

Installs to ~/.claude/skills/skill-improver/

Terminal

git clone --depth 1 https://github.com/trailofbits/skills /tmp/skills \
  && mkdir -p ~/.claude/skills \
  && cp -r /tmp/skills/plugins/skill-improver ~/.claude/skills/skill-improver

Clones the whole repository, because a skill folder can carry scripts and resources beside its SKILL.md.

What Skill Improver does

Iteratively reviews and fixes Claude Code skill quality issues until they meet standards. Runs automated fix-review cycles using the `skill-reviewer` agent from the `plugin-dev` plugin.

Alternatives in Productivity

Gov Metrics — Governance metrics — measure whether the gates actually work 83 ★
Paper Trail New Sota — Create a new State-of-the-Art review on a topic, guaranteed without hallucinated citations 5 ★
Harness Improver — Stage 09 at close, or any time mid-engagement

Repository README

This is the README for trailofbits/skills, shared by 13 entries in this directory. It describes the repository, not this entry specifically.

Skill Improver Plugin

Iteratively reviews and fixes Claude Code skill quality issues until they meet standards. Runs automated fix-review cycles using the `skill-reviewer` agent from the `plugin-dev` plugin.

Requirements

plugin-dev plugin must be installed (provides skill-reviewer agent)

Commands

/skill-improver \ [--max-iterations N]

Start an improvement loop for a skill.

/skill-improver ./plugins/my-plugin/skills/my-skill
/skill-improver ./skills/my-skill/SKILL.md --max-iterations 15

/cancel-skill-improver [SESSION_ID]

Stop the active improvement loop. Changes made during the loop are preserved.

How It Works

/skill-improver resolves the skill path and creates a session state file
The skill-improver methodology reviews, fixes, and re-reviews iteratively
A stop hook continues the loop until the quality bar is met or max iterations (default: 20) are reached
The loop ends when Claude outputs or the limit is hit

Multiple sessions can run simultaneously on different skills. Each gets a unique session ID and separate state file in `.claude/`.

See [SKILL.md](skills/skill-improver/SKILL.md) for detailed methodology and issue categorization.

Troubleshooting

"subagent not found": Install the plugin-dev plugin
Loop never completes: Check state with cat .claude/skill-improver.*.local.md, cancel with /cancel-skill-improver
Orphaned state files: Remove with trash .claude/skill-improver.*.local.md