writing-skills

Test-driven development for process documentation uses a RED-GREEN-REFACTOR workflow to turn raw notes into verifiable SKILL.md guidelines. You run baseline pressure scenarios, implement the skill, and re-test to confirm compliance and resist rationalization.

A SKILL.md file requires YAML frontmatter with name and description fields, followed by a concise three-section Markdown structure. This format enforces progressive disclosure and one-source navigation to keep context minimal yet powerful for reliable deployment.

You validate skill documentation against rationalization by running baseline pressure scenarios without the skill, then implementing the SKILL.md and re-testing to confirm compliance. This failure-based testing approach ensures verifiable, reusable guidelines.

Yes, you can use this skill for creating, editing, and validating skills across a library. It supports iterative refinement through the RED-GREEN-REFACTOR workflow to maintain deployment readiness and structured frontmatter compliance.

For deployment readiness, SKILL.md frontmatter must include name and description fields with concise descriptions. You also need to document triggering conditions, patterns, and reference material for future reuse within the three-section Markdown structure.

Use RED-GREEN-REFACTOR for skill writing when you need to turn raw process documentation into verifiable, reusable SKILL.md entries. It is essential when creating new skills, editing existing guidelines, or validating skills for deployment readiness across a library.