writing-skills

Test-driven development for process documentation enforces a RED-GREEN-REFACTOR cycle to write, test, and refine Skills. It ensures consistent frontmatter, validates patterns through subagent testing, and applies quality gates to prevent sloppy documentation.

Maintaining Skill documentation consistency requires structured frontmatter discipline and rationalization checks. By applying progressive disclosure patterns and quality gates, teams can enforce repeatable quality and prevent red flags in workflow references.

The RED-GREEN-REFACTOR cycle for writing Skills guides you to draft documentation, validate it through subagent testing, and refine the content. This enforces clarity and repeatable quality for patterns and references across teams.

Subagent testing is required to validate Skill documentation reliability. It acts as a quality gate within the RED-GREEN-REFACTOR cycle, ensuring that structured frontmatter, workflows, and references function correctly before deployment.

Quality assurance checks for Skill documentation include rationalization checks, red flag detection, and progressive disclosure patterns. These gates enforce structured frontmatter discipline and ensure repeatable quality during the RED-GREEN-REFACTOR cycle.

You can use test-driven development to validate existing workflow patterns and references by running them through subagent testing and rationalization checks. This enforces clarity and consistency when editing and validating Skills across teams.