write-a-skill

To create a skill file, write a SKILL.md with mandatory YAML frontmatter fields like name and description, then use the validation checklist to ensure your skill file meets authoring guidelines for discoverability.

The standard format for skill documentation requires a SKILL.md file utilizing YAML frontmatter to define the skill name and description, alongside clearly documented usage and modular artifacts to support onboarding.

Structure skill metadata by applying documented conventions for skill naming, categorization, and required fields within the YAML frontmatter, ensuring easier discovery and maintenance across the skill tree.

Yes, you can include optional artifacts like scripts, references, and assets directories when authoring a skill file to support modular skill design and extend internal tooling with a clean separation of concerns.

Onboard new contributors by providing the standard SKILL.md format, guidance for required fields, and validation checklists, enabling them to easily discover, maintain, and contribute to agent-friendly skills.

You need YAML frontmatter in a skill file to enforce consistent skill-file authoring, define mandatory metadata for agent discovery, and maintain a clean separation of concerns when extending internal tooling.