SKILL.md Anatomy

my-skill-name/
├── SKILL.md ← you are here
├── scripts/
├── references/
└── assets/
YAML Frontmatter ~100 tok
H1 Title ~5 tok
## Overview / Purpose ~80 tok
## When to Activate ~120 tok
### Workflow Steps (0–N) ~1200 tok
## Output Files Summary ~150 tok
## Example Session ~300 tok
## Common Pitfalls ~200 tok
## Quality Scoring Rubric ~400 tok
Click any block to explore  |  9 sections — 5 required, 4 optional
◈

Select a section to see
details, token cost, and examples

Progressive Disclosure — 3-Tier Token Model

Tier 1 — Always Loaded
Metadata
YAML frontmatter + title. Loaded every session for skill registry.
~100 tokens
→
Tier 2 — On Invocation
Instructions
Full SKILL.md body. Loaded into context only when skill is called.
< 5,000 tokens
→
Tier 3 — On Demand
Resources
Files in references/ and assets/. Fetched only when a step needs them.
As needed