skill-development

To create a Claude Code plugin skill, add a SKILL.md file with mandatory name and description frontmatter fields in your plugin's skills directory, then populate optional bundles like scripts and references as needed.

Progressive disclosure in skill development places core guidance directly in SKILL.md while moving deeper details into references and full examples into examples directories to enable predictable resource organization.

Structure a Claude Code skill for auto-discovery by using a consistent frontmatter-driven format in SKILL.md and organizing reusable utilities into optional bundles like scripts, references, and assets.

Packaging a self-contained skill unit requires a SKILL.md file with proper frontmatter, and optionally includes a references directory for documentation, scripts for utilities, and assets for output files.

Yes, Claude Code can auto-discover, validate, and load plugin skills through a predictable folder structure and resource organization specified by the frontmatter-driven SKILL.md format.

You should separate skill guidance from detailed references when core instructions fit in SKILL.md but deeper documentation and full examples need their own directories to maintain progressive disclosure and reduce clutter.