writing-skills

Validating Skill frontmatter requires checking that the SKILL.md file contains at least the name and description fields, adhering to specified length and format guidelines before deployment.

The RED-GREEN-REFACTOR discipline for skill writing is a test-driven workflow where you run baseline tests to observe failures, write a minimal viable Skill to pass them, and then refine the structure and documentation.

To structure documentation for a new Skill workflow, organize content by principles, patterns, and examples, ensuring it outlines specific application scenarios to help teams effectively reuse and deploy the Skill.

You need test-driven development to write a Skill because the workflow recommends applying RED-GREEN-REFACTOR discipline, ensuring you run baseline tests first to identify failures before submitting a minimal usable Skill.

The best way to standardize Skill content creation is to enforce unified prerequisites and structure, ensuring frontmatter validation and organized guidelines for principles and examples are consistently met before deployment.

Skill validation fails during editing when the SKILL.md frontmatter is missing required fields like name or description, or when the content lacks the structured guidelines and test-driven checks needed for deployment readiness.