writing-skills

Skill documentation validation checks SKILL.md frontmatter against the YAML spec, requiring a valid name and description. This frontmatter validation ensures the document adheres to structural requirements before entering the RED-GREEN-REFACTOR testing phase.

The RED-GREEN-REFACTOR workflow for skill creation is an iterative cycle that drafts a minimal SKILL.md, runs baseline tests, and refines the documentation progressively. It ensures structured, test-driven validation before skills are deployed to a skills library.

Validating SKILL.md frontmatter requires checking that the name and description fields exist and adhere to the YAML spec. This baseline validation is mandatory before progressing through the RED-GREEN-REFACTOR cycle to guarantee deploy-ready documentation.

Yes, the test-driven documentation process applies to both skill creation and editing. It enforces a repeatable RED-GREEN-REFACTOR template for testing and validating updates across a skills library, ensuring iterative refinement maintains deploy-ready quality.

Progressive disclosure in skill writing is a best practice for structuring SKILL.md content to reveal information iteratively. It is documented within the test-driven workflow to ensure the skill documentation remains structured and deploy-ready.