writing-skills

To create and validate skill documentation, use a test-driven approach that enforces a consistent SKILL.md structure with required YAML frontmatter fields like name and description before deployment.

The required markdown structure for AI agent skills includes YAML frontmatter with name and description fields, followed by standardized sections covering the problem, core patterns, and a concise Quick Start.

To write a quick start guide for a new skill, fill the dedicated section in your SKILL.md with a concise, one-sentence summary of the immediate action required to apply the skill.

Yes, you need YAML frontmatter for skill validation in agent workflows, as it requires specific name and description fields to accurately parse and apply the skill across projects.

The best way to structure markdown documentation for AI workflows is using a test-driven approach that enforces standardized sections for the problem statement, core patterns, and quick start guidance.

Skill validation fails when editing existing skills if the markdown structure is inconsistent, such as missing required YAML frontmatter fields or omitting the problem, core patterns, and quick start sections.