Skill Improver
Runs an autonomous review-and-fix improvement loop over a Claude Code skill until a...
Install
npx skills add trailofbits/skills --skill skill-improver -g -a claude-code -y- Repository
- trailofbits/skills7.9k
- Category
- AI and agents
- Updated
- 7d ago
- License
- CC-BY-SA-4.0
- Context cost
- Mediumabout 1,672 tokens
- Runs scripts
- No, instructions only
What it does
Runs an autonomous review-and-fix improvement loop over a Claude Code skill until a review comes back clean, with a cross-round findings ledger, escalation when fixes stop converging, and a mechanical scope guard. Reviews are performed by the plugin-dev skill-reviewer agent. Use to fix skill quality issues, iteratively refine a skill, or resume a loop after an escalation ('fix my skill', 'improve this skill until it passes review', 'skill improvement loop'). NOT for a one-time review, use the plugin-dev skill-reviewer agent directly.
Skill Improver
Improve a Claude Code skill by running /code-improver:improve, a dynamic workflow
that loops a reviewer and a fixer subagent until a review reports zero critical/major
findings, then strips its own residue. This entry point wires the loop to the
plugin-dev:skill-reviewer agent, so the plugin-dev plugin must be installed
(marketplace claude-plugins-official). The loop, its ledger, and its guards live in
the workflow; this skill resolves the target and relays the outcome.
Starting the loop
The user provided: $ARGUMENTS (if empty, take the target skill from the conversation).
1. Resolve the skill path
- If the input ends with
/SKILL.mdand the file exists, use its directory - If the input is a directory containing
SKILL.md, use that path - Otherwise
Glob(pattern="**/SKILL.md")and filter by skill name or path substring:- Multiple matches: ask the user to choose
- No matches: report the available skills
- Single match: proceed
2. Resolve the loop script
Resolve improve.js from this SKILL.md's installed location
to an absolute path and confirm the file exists. Its plugin directory is pluginRoot.
Use this exact plugin copy; if the file is missing, stop.
3. Invoke the workflow
Run it with the Workflow tool, {scriptPath: "<the path from step 2>", args: {...}}:
{
"target": "<resolved absolute path>",
"reviewer": {
"kind": "agent",
"name": "plugin-dev:skill-reviewer",
"notes": "The target is a Claude Code skill directory; review it as a skill (frontmatter, triggering description, progressive disclosure, referenced files)."
},
"pluginRoot": "<the plugin directory from step 2>",
"maxRounds": 5
}

