skill-improver

Iteratively reviews and fixes Claude Code skill quality issues using automated fix-review cycles.

Updated May 17, 2026
One-click install
npx skills add https://github.com/irrit-us/agent_misc --skill skill-improver-irrit-us
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-improver
Source: https://github.com/irrit-us/agent_misc/tree/main/skills/skill-improver
Command: npx skills add https://github.com/irrit-us/agent_misc --skill skill-improver-irrit-us

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually reviewing and fixing quality issues in Claude Code skills is slow and inconsistent. This Skill automates the fix-review loop, repeatedly invoking the skill-reviewer agent and applying fixes until the skill meets quality standards. ## Core Features & Use Cases - Automated Fix-Review Loop: Runs repeated review cycles with the skill-reviewer agent, fixing critical and major issues until none remain. - Issue Categorization: Classifies findings as critical, major, or minor, and evaluates minor issues for false positives before applying changes. - Explicit Completion Marker: Terminates the loop only when all critical and major issues are resolved, signaled by a dedicated completion marker. - Use Case: You wrote a new skill and want it to meet project quality standards. Point this Skill at the skill directory and it iterates reviews and fixes until the reviewer passes it. ## Quick Start Ask Claude to improve the skill at your skill directory path using the skill-improver workflow until all critical and major issues are fixed.

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 review and reports issues. skill-improver runs an automated loop that repeatedly calls skill-reviewer and applies fixes until all critical and major issues are resolved.

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; if missing, install it from the Trail of Bits plugin repository.

When should I not use skill-improver?▼

Avoid it for one-time reviews (use /skill-reviewer directly), quick single fixes (edit the file manually), non-skill files, and experimental skills where manual iteration gives more control.

How does the skill-improver loop know when to stop?▼

The loop stops only when the explicit <skill-improvement-complete> marker is output. This happens when the reviewer passes, or all critical and major issues are fixed and remaining minor issues are evaluated as not worth fixing.