skill-improve

You can automate Claude skill improvement by running a test-fix-retest loop that executes baseline static tests, diagnoses gaps, and proposes targeted fixes to iteratively upgrade your skill quality. The system rewrites the skill and re-validates changes to decide whether to keep or revert them.

A test-fix-retest workflow for skill improvement is an automated loop that runs baseline static tests on a skill, diagnoses performance gaps, applies targeted fixes by rewriting the skill file, and then re-tests to validate whether the changes improved the score or should be reverted.

Automated skill improvement applies specifically to skills located under the .claude/skills/[name]/SKILL.md directory structure. It requires deterministic access to the /skill-test command and directly reads and writes to the SKILL.md file to apply and validate changes.

To start an automated improvement cycle for an underperforming skill, run the /skill-improve command with your skill name. This initiates the baseline static testing, gap diagnosis, and targeted fixing loop to systematically upgrade the skill's performance.

You should not use an automated test-fix-retest loop if your skill lacks a corresponding /skill-test command for deterministic validation, or if the target skill file is not located within the standard .claude/skills/ directory structure required for reading and writing changes.