write-a-skill

To structure an agent skill, you need a canonical SKILL.md file with frontmatter containing the name and description, and you can bundle optional REFERENCE.md, EXAMPLES.md, scripts, and assets to satisfy project requirements.

The standard project structure for agent skills includes a SKILL.md file, optional REFERENCE.md and EXAMPLES.md files, and designated directories for scripts and assets to ensure consistent organization.

You scaffold a SKILL.md template by drafting a new skill named 'skill-name' and generating canonical frontmatter that includes the required name and description fields along with optional references.

You do not need to include scripts and references when creating agent skills; they are optional components added alongside the required SKILL.md file to satisfy deterministic and reference needs.

The best way to maintain consistent documentation across new agent skills is to apply a standard skeleton template that enforces uniform SKILL.md frontmatter and optional reference guidelines for rapid review.

You can use this skill writing template for team review before activation, as it encourages consistent skill structure and documentation across new skills to help teams rapidly scaffold and evaluate.