writing-skills

To standardize YAML frontmatter in SKILL.md, include the required fields name, category, and description at the root. This consistent structure enables agents to parse and auto-discover skills without manual intervention.

A valid SKILL.md file requires YAML frontmatter containing name, category, and description at the root, followed by a well-structured body with required sections to ensure reliable parsing.

You validate SKILL.md frontmatter and body layout by checking for required YAML fields name, category, and description, and ensuring the body sections adhere to the standardized template.

The best way to create markdown documentation for skills is following a standardized SKILL.md template, enforcing consistent YAML frontmatter and a uniform body layout for quality checks.

You do not need any dependencies to validate SKILL.md structure. The validation process relies on enforcing a consistent YAML frontmatter and body layout without external components.