skill-creator

To create reusable AI skills, write a SKILL.md file with YAML front matter defining the skill's name and description. Outline the core sections in the body, and add optional scripts, references, and assets directories to enable progressive disclosure.

Progressive disclosure in skill design is a strategy that organizes resources into optional scripts, references, and assets directories. This structure allows the AI to access core instructions in the SKILL.md body first and retrieve deeper context only when needed.

The best way to structure an AI skill directory is to place a SKILL.md file with YAML front matter at the root. Then, bundle supplementary resources by creating separate scripts, references, and assets folders to maintain a clean, standardized anatomy.

Yes, you need YAML front matter to document a new skill because it must include the name and description fields. This standardized metadata ensures consistent discovery and proper functioning within the skill system.

You should use the references folder for supplementary documentation and context, while the assets folder handles other supporting files needed by the skill. Both support progressive disclosure, keeping the main SKILL.md body concise.