skill-improver

Iteratively reviews and fixes Claude Code skill quality issues using the skill-reviewer agent.

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/marumo333/atrox --skill skill-improver-marumo333
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-improver
Source: https://github.com/marumo333/atrox/tree/main/.claude/skills/trailofbits/plugins/skill-improver/skills/skill-improver
Command: npx skills add https://github.com/marumo333/atrox --skill skill-improver-marumo333

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Claude Code skills often accumulate quality issues like missing frontmatter fields, weak trigger descriptions, or broken file references that prevent them from loading or being selected correctly. Manually reviewing and fixing these issues across multiple review rounds is tedious and inconsistent. ## Core Features & Use Cases - Automated Fix-Review Loop: Runs repeated cycles of skill-reviewer analysis and fixes until the skill meets quality standards. - Severity-Based Issue Categorization: Separates critical, major, and minor issues so blocking problems are fixed first while minor suggestions are evaluated for validity. - Explicit Completion Criteria: Uses a strict completion marker to terminate the loop only when all critical and major issues are verified as resolved. - Use Case: You wrote a new skill and want it polished to project standards. Invoke this skill to automatically review, fix, and re-verify it until it passes. ## Quick Start Ask Claude to improve the skill at your skill's directory path using the skill-improver workflow until all critical and major issues are resolved.

Frequently Asked Questions about skill-improver

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically fix quality issues in a Claude Code skill?▼

Invoke the skill-improver workflow with the path to your skill directory. It runs the skill-reviewer agent, categorizes issues by severity, fixes critical and major problems, and repeats until the skill passes review.

What is the difference between skill-improver and skill-reviewer?▼

skill-reviewer performs a one-time quality assessment of a skill, while skill-improver runs an automated loop that applies fixes and re-reviews until standards are met. Use skill-reviewer directly for single reviews.

Does skill-improver require any plugins to work?▼

Yes, it requires the plugin-dev plugin which provides the skill-reviewer agent. Verify it is enabled by running /plugins before starting the improvement loop.

When should I not use an automated skill improvement loop?▼

Avoid it for one-time reviews, quick single fixes, non-skill files, or experimental skills still under exploration. In those cases, run skill-reviewer once or edit the SKILL.md file directly.

Why does the skill improvement loop not stop after fixes are applied?▼

The loop only terminates when the explicit <skill-improvement-complete> marker is output. Natural language statements like "looks good" do not stop it, and the marker must only appear after verifying fixes with skill-reviewer.