writing-skills

To enforce required frontmatter and sections for skill documentation, you codify mandatory metadata fields and structural sections within a SKILL.md file located at the skill root, verifying alignment with the master _rules reference.

The standard structure for creating a new Skill Unit requires a kebab-case directory containing a SKILL.md file with validated frontmatter and mandated sections like Overview, Iron Law, and When to Use to prevent quality drift.

You validate skill metadata against governance and QA standards by applying frontmatter validation rules that check for required sections and verify consistency with the master _rules reference before integration.

A SKILL.md file must contain mandated sections including Overview, Iron Law, and When to Use, alongside validated frontmatter, to pass quality gates and ensure verifiable skill definitions.

You need frontmatter validation for skill writing whenever creating new skill definitions across the library, ensuring consistency, reducing ambiguity, and enforcing quality assurance standards during integration.

Your new skill definition fails quality assurance checks when it lacks required frontmatter, omits mandated sections like Iron Law or When to Use, or diverges from the master _rules reference structure.