writing-skills

Automate skill authoring by applying a test-driven development workflow that enforces RED-GREEN-REFACTOR cycles to verify behavior. Draft SKILL.md with frontmatter, then run iterative testing loops to validate metadata and structure before deployment.

Validating YAML frontmatter for reusable skills requires quality gates that check metadata fields like name and description. This ensures reliable discovery and enforces the structural definition needed for safe, reusable deployment across teams.

A test-driven documentation workflow improves skill quality by enforcing structured content creation and iterative testing. It minimizes regressions by validating frontmatter, references, and behavior through continuous quality gates before deployment.

Writing tests before deploying documentation skills is required. The workflow mandates risk-free testing steps and structural validation to ensure metadata and content meet the Skill Unit definition, preventing errors before release.

The Skill Unit definition includes YAML frontmatter with name and description fields, concise content structure, and thorough testing steps. Meeting this definition ensures metadata discipline and structural quality for reliable skill discovery.

Skill validation fails during refactoring when metadata structure or content does not meet defined quality gates. Enforcing frontmatter discipline and running iterative test cycles identifies these regressions before deployment.