superpowers-writing-skills

Test-driven skill creation starts with RED tests that pressure your documentation against edge cases, then GREEN implementation that satisfies those tests, and REFACTOR cycles that close gaps. This Skill automates that RED-GREEN-REFACTOR loop using subagent scenarios to validate guidance before deployment, ensuring skills remain bulletproof under real-world pressure.

A skill requires YAML frontmatter with name and description, followed by SKILL.md with Frontmatter, Overview, When to Use, Core Pattern, Quick Reference, Implementation, and Common Mistakes sections. This structure ensures compliance with Claude search optimization guidelines and supports the test-driven validation cycles this Skill enforces.

Run built-in test campaigns that execute subagent-style pressure scenarios against your skill, surfacing rationalizations and gaps through iterative cycles. The Skill applies rationalization tables to expose flaws in your guidance until it withstands scrutiny, then validates compliance before you deploy.

Yes. This Skill applies test-driven development to creating new skills, editing existing ones, or verifying skills before deployment. Run the same RED-GREEN-REFACTOR cycles on established skills to tighten documentation and close holes that testing reveals.

Standard skill writing often contains untested rationalizations and weak spots. Test-driven skill documentation runs subagent pressure scenarios that exercise your guidance against real constraints, then iterates until it holds solid—preventing deployment of skills that fail under stress.

No prior TDD experience required. This Skill automates the RED-GREEN-REFACTOR pattern for skill documentation, guiding you through baseline tests, implementation validation, and refactor cycles with subagent-based pressure scenarios built into the workflow.