create-skill

To author a SKILL.md file, define a unique lowercase slug for the name and draft a descriptive description in the YAML frontmatter, then populate the Markdown body with clear instructions and place it in a new skill-name directory.

When creating an Agent Skill, structure folders by placing the SKILL.md file in a new skill-name directory, alongside optional subdirectories for references, scripts, and assets to maintain organization through progressive disclosure.

An Agent Skill does not require dependencies or external scripts to function, as the core structure relies solely on the SKILL.md file with required frontmatter, making scripts and assets completely optional additions.

The best way to write a SKILL.md template for team onboarding is to apply progressive disclosure, keeping long guidance concise by separating the core Markdown body from optional references and scripts folders for quick consistency.

You should use progressive disclosure in SKILL.md authoring when you have long guidance or complex instructions, allowing you to keep the main body concise while moving detailed context into optional reference files.