writing-skills

You validate SKILL.md frontmatter by enforcing YAML constraints, checking for required name and description fields, and running toxicity checks to ensure deployment readiness for agent platforms.

Test-driven development for skill writing is a structured RED-GREEN-REFACTOR cycle that defines and enforces a process for creating, editing, and validating skill documentation to ensure consistency and robustness across agent platforms.

You structure a SKILL.md file for agent platforms by defining YAML frontmatter with required name and description fields, formatting the documentation body, and optionally including resource directories to support the skill's capabilities.

Skill documentation requires YAML frontmatter for quality assurance, specifically mandating name and description fields, to meet deployment constraints and pass validation checks before integration across agent platforms.

The best way to create reusable skills with consistent formatting is to apply a test-driven process using repeatable RED-GREEN-REFACTOR patterns, which helps skill authors craft robust SKILL.md files that pass validation checks.

Skill deployment fails frontmatter validation checks when the SKILL.md file does not meet YAML constraints, such as missing required name and description fields, or when it has not passed mandatory toxicity checks.