writing-skills

Test-driven development for process documentation involves running RED-GREEN-REFACTOR cycles on skill docs to ensure verifiability. You draft a baseline skill, run failing tests without it, then implement the skill and re-run tests to confirm compliance and repeatability.

A RED-GREEN-REFACTOR cycle for skill writing is a TDD approach where RED runs a failing test without the skill, GREEN implements the skill to pass tests, and REFACTOR improves the skill while maintaining compliance. This ensures skills remain verifiable and repeatable.

Skills within plugin directories are validated by applying test-driven development to documentation, running baseline tests, implementing the skill, and confirming compliance through RED-GREEN-REFACTOR cycles and rationalization tracking for deployment readiness.

TDD-based validation requires a SKILL.md file with YAML frontmatter containing name and description fields, a descriptive markdown body, and optional scripts, references, or assets directories that Claude can load as needed during testing.

Process documentation skills fail under stress when they lack test-driven development practices. Without baseline testing and RED-GREEN-REFACTOR cycles, skills are not verifiable or repeatable, making them vulnerable to regression and non-compliance during edge cases.

Yes, you can add optional scripts, references, and assets directories alongside your SKILL.md file. These directories can be loaded by Claude as needed during test-driven validation cycles and deployment readiness checks within plugin directories.