Skill Development

Organize your skill with frontmatter in SKILL.md containing name and description, then move detailed content to optional references/ and examples/ directories. Progressive disclosure loads content on demand, keeping the core documentation lean and discoverable while detailed patterns and working examples remain accessible separately.

Create a skill directory with SKILL.md (frontmatter + body), optional references/ for API patterns and detailed guidance, optional examples/ for working demonstrations, and optional scripts/ for utilities. This standardized layout accelerates creation, ensures consistent discovery, and enables reliable reuse across plugin environments.

Use imperative or infinitive form in descriptions, write in third person for frontmatter, enforce lean SKILL.md bodies, and apply progressive disclosure to load references and examples only when needed. These conventions ensure clarity, reduce cognitive load, and make skills reliably discoverable and usable by teams.

Apply progressive disclosure whenever detailed patterns, API references, or extended examples would bloat your core SKILL.md. Moving this content to references/ and examples/ directories keeps initial documentation focused, improves scannability, and lets users access depth only when they need it.

Yes. The standardized layout with frontmatter conventions, references/, examples/, and scripts/ directories is designed as a reusable pattern. This consistency accelerates skill creation, enables teams to iterate faster, and ensures reliable discovery and use across your plugin skill library.