skill-improver

# 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 block skill loading or cause runtime failures: - Missing required frontmatter fields (name, description) — Claude cannot index or trigger the skill - Invalid YAML frontmatter syntax — Parsing fails, skill won't load - Referenced files that don't exist — Runtime errors when Claude follo...