skill-authoring

Agent skill authoring organizes documentation by requiring a SKILL.md file with YAML frontmatter for name and description, a structured Markdown body for instructions, and optional resource directories for scripts and assets.

Mandatory skill frontmatter requires a YAML header in SKILL.md defining the name and description fields to enable quick discovery and reliable agent activation across a development repository.

Structuring agent skill documentation requires explicit body sections for What problem does it solve, Core Features and Use Cases, and Quick Start to provide clear activation context and usage instructions.

You can optionally add scripts, references, and assets directories alongside SKILL.md to support on-demand content delivery and validation for user-facing agent skills.

Skill authoring requires no external dependencies or components, relying solely on standard YAML frontmatter and Markdown body structure in a SKILL.md file to define and maintain agent skills.