writing-skills

Test-driven skills documentation applies a RED-GREEN-REFACTOR cycle to skill authorship. You observe baseline failures by running pressure scenarios without the skill, then update the SKILL.md to correct those failures and verify consistency.

The RED-GREEN-REFACTOR cycle for process documentation involves writing failing baseline tests for pressure scenarios, updating the skill documentation to make them pass, and refactoring the content to ensure clarity, consistency, and repeatability.

You validate Claude skill frontmatter and descriptions by enforcing a structured workflow that checks for required name and description fields, verifies three-section description formats, and runs safe deployment controls to reduce risk.

No external dependencies are required to apply TDD-guided skill authorship. The framework operates independently to enforce frontmatter validation, description sections, and deployment checklists for creating and editing process-skills.

Using TDD for skill documentation requires defining explicit pressure scenarios upfront, meaning ambiguous or highly exploratory processes may be difficult to baseline test until concrete failure conditions are established.

Yes, writing-skills enforces deployment safety checks for new Claude skills by providing red flags, rationalization tables, and safe deployment controls to reduce risk when adding or editing process documentation.