writing-skills

Test-driven documentation applies the RED-GREEN-REFACTOR cycle to skill creation, defining baseline behavior, writing the skill, and refining it based on testing results to reduce errors and improve clarity.

The RED-GREEN-REFACTOR cycle is a structured process for skill creation: defining test scenarios first, writing the skill document to pass those tests, then refining it based on testing results.

Test-driven documentation supports creating different types of skills, including techniques, patterns, and references, ensuring each is thoroughly tested before deployment.

Yes, creating reference guides with this process requires an understanding of superpowers:test-driven-development, as it applies TDD principles to ensure documentation quality and reduce surprises.

The best way to test a skill document is using a subagent to validate it against predefined test scenarios, ensuring the skill behaves correctly and reducing errors before deployment.

Start streamlining process documentation by defining test scenarios for the new skill, writing the skill document, and finally testing it with the subagent to refine the output.