What problem does it solve?
Agent skill ecosystems expand rapidly, but manually maintaining dozens of skills is unsustainable. Traditional review only checks structural formatting, missing real-world effectiveness issues. This skill provides a systematic, automated way to evaluate and continuously improve agent skills using both static analysis and live testing.
Core Features & Use Cases
- 8-Dimension Evaluation Rubric: Scores skills across structure (60 points) and effectiveness (40 points) with detailed criteria including frontmatter quality, workflow clarity, edge case coverage, and live test performance.
- Hill-Climbing Optimization: Automatically diagnoses the weakest dimension, generates targeted improvements, and uses a git ratchet mechanism to keep only score-increasing changes.
- Human-in-the-Loop Workflow: Pauses after each optimization cycle to show diffs and score changes, requiring user confirmation before proceeding.
- Visual Result Cards: Generates styled HTML achievement cards showing before/after scores, dimension breakdowns, and key improvements.
- Use Case: A developer managing 60+ Claude Code skills can run a full optimization cycle to systematically improve quality, with each skill evaluated against realistic test prompts.
Quick Start
Use the darwin-skill optimizer to evaluate and improve your agent skills by running the optimization loop on your skill collection.