writing-skills

Use this guide to draft a new Skill by creating a SKILL.md file with mandatory YAML frontmatter specifying name and description. This standardized entry point enables agents to reliably discover and load your Skill.

Frontmatter-driven skill documentation uses a SKILL.md entry point with mandatory YAML metadata for name and description. You need it when adding or modifying Skills to ensure agents can reliably discover and load them across a searchable namespace.

Structure your Skill directory by creating a SKILL.md entry point with YAML frontmatter, then add optional scripts/, references/, and assets/ subdirectories. These support on-demand loading of supplementary resources during skill execution.

Yes, you can use optional scripts/, references/, and assets/ directories for on-demand loading within your Skill. These directories sit alongside the mandatory SKILL.md file and provide supplementary resources when the Skill is invoked.

The best way to validate Skill documentation before deployment is to verify that your SKILL.md file contains mandatory YAML frontmatter with name and description fields. This guide walks you through the authoring process from initial drafting to testing and deployment.

Your Skill fails agent discovery without proper YAML frontmatter because the searchable namespace requires a standardized SKILL.md entry point containing mandatory name and description metadata. Without these fields, agents cannot reliably identify or load your Skill.