skill-improver

Featured

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.

AI & Automation 8,273 stars 715 forks Updated 6 days ago CC-BY-SA-4.0

Install

View on GitHub

Quality Score: 93/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# 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 foll...

Details

Author
trailofbits
Repository
trailofbits/skills
Created
10 months ago
Last Updated
6 days ago
Language
Python
License
CC-BY-SA-4.0

Similar Skills

Semantically similar based on skill content — not just same category