Trail of Bits

Skill Improver

Name: Skill Improver
Author: Trail of Bits

Productivity community Advanced

SOURCE https://github.com/trailofbits/skills/tree/main/plugins/skill-improver

Description

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.

Installation

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.

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