skill-improver
Iteratively reviews and fixes Claude Code skill quality issues until they meet standards. Runs automated fix-review cycles using the skill-reviewer agent. Use to fix skill quality issues, improve skill descriptions, run automated skill review loops, or iteratively refine a skill. Triggers on 'fix my skill', 'improve skill quality', 'skill improvement loop'. NOT for one-time reviews—use /skill-reviewer directly.
npx skills add trailofbits/skills --skill skill-improver --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Skill Improvement Methodology Iteratively improve a Claude Code skill using the skill-reviewer agent until it meets quality standards. ## Prerequisites Requires the `plugin-dev` plugin which provides the `skill-reviewer` agent. Verify it's enabled: run `/plugins` — `plugin-dev` should appear in the list. If missing, install from the Trail of Bits plugin repository. ## Core Loop 1. **Review** - Call skill-reviewer on the target skill 2. **Categorize** - Parse issues by severity 3. **Fix** - Address critical and major issues 4. **Evaluate** - Check minor issues for validity before fixing 5. **Repeat** - Continue until quality bar is met ## When to Use - Improving a skill with multiple quality issues - Iterating on a new skill until it meets standards - Automated fix-review cycles instead of manual editing - Consistent quality enforcement across skills ## When NOT to Use - **One-time review**: Use `/skill-reviewer` directly instead - **Quick single fixes**: Edit the file directly - **Non-skill files**: Only works on SKILL.md files - **Experimental skills**: Manual iteration gives more control during exploration ## Issue Categorization ### Critical Issues (MUST fix immediately) These
- Prerequisites
- Core Loop
- When to Use
- When NOT to Use
- Issue Categorization
- Critical Issues (MUST fix immediately)
- Major Issues (MUST fix)
- Minor Issues (Evaluate before fixing)
- Minor Issue Evaluation
- Invoking skill-reviewer
- Example Fix Cycle
- Completion Criteria
- Rationalizations to Reject
What does the skill-improver skill do?
Iteratively reviews and fixes Claude Code skill quality issues until they meet standards. Runs automated fix-review cycles using the skill-reviewer agent. Use to fix skill quality issues, improve skill descriptions, run automated skill review loops, or iteratively refine a skill. Triggers on 'fix my skill', 'improve skill quality', 'skill improvement loop'. NOT for one-time reviews—use /skill-reviewer directly.
How do I install it?
Run `npx skills add trailofbits/skills --skill skill-improver --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From trailofbits/skills, a repository with 6,426 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.