Build Skills Using Progressive Disclosure
Guide for creating skills with 3-level loading, token budgets, and reference structure.
Steps
- Review the 3-level loading pattern: metadata → body (<2k tokens) → reference/ files
- Scaffold skill directory with SKILL.md and reference/ folder (no stray .md in root)
- Write SKILL.md body with links to reference/ files, keeping body under 2k tokens
- Validate structure with validate-skill.js and check token budgets
- Test by triggering with matching keywords from skill description
For detailed instructions, see instructions.md.