writing-skills

Test-driven skill documentation applies a RED-GREEN-REFACTOR workflow to skill creation, writing failing tests before documentation to ensure repeatable, auditable agent results.

The RED-GREEN-REFACTOR workflow is an iterative validation process for skill creation. It enforces frontmatter validity and structured sections by writing failing tests, passing them, and refining SKILL.md documentation.

Validate skill documentation before deployment using pressure scenarios and rationalization tables. These formats counter rationalizations and verify progressive disclosure in the SKILL.md structure.

Yes, writing skills operates without external dependencies. It provides a self-contained framework for quality assurance that enforces frontmatter constraints and token-efficient descriptions directly within your documentation.

The best way to structure a SKILL.md file is using progressive disclosure and cross-references. This token-efficient approach ensures repeatable results by organizing heavy references separately and guiding disciplined skill naming.