Progressive Disclosure in Skill Content

A skill is consumed by a model with finite attention. Put the highest-signal content first, let depth come later. Length without structure is noise.

When to Use

• Writing a new SKILL.md body
• Refactoring a skill that's grown bloated
• Splitting a monster skill into focused ones
• Reviewing skills for publication quality

The Shape of a Good Skill

Target ≈ 150-300 lines. Order sections from most-essential to least: