write-skill

To validate YAML frontmatter in SKILL.md documentation, ensure required name and description fields are present, then run a validation checklist to verify mandatory discovery metadata and optional resource associations like scripts and assets.

The RED-GREEN-REFACTOR cycle for skill writing is a standardized testing workflow that drafts, tests, and validates new or updated skills iteratively to ensure consistent documentation and structural integrity before deployment.

Skill metadata validation requires no external dependencies to check optional components, as the validation process inherently detects and verifies associated resource directories like scripts, references, and assets directly.

The best way to standardize skill structure for repository discovery is enforcing a YAML frontmatter entry point in SKILL.md, ensuring mandatory metadata fields and correctly associating optional resources for tooling indexing.

Skill validation fails when optional components are incorrectly associated because the standardized workflow requires directories like scripts, references, and assets to be properly linked and discoverable within the SKILL.md documentation structure.