progressive-disclosure-docs
Installation
SKILL.md
Progressive Disclosure Docs
Use this skill to make documentation easy for both humans and agents to discover, load, and act on. Preserve the target document's language and style unless the user asks to change it.
Core Rule
Structure documentation like Agent Skills:
| Layer | Purpose | Document Equivalent |
|---|---|---|
| Discovery | Decide whether to read | Filename, title, summary, table of contents |
| Activation | Complete the common task | Scope, decision rules, shortest working path |
| Execution | Handle details only when needed | Commands, config blocks, examples, troubleshooting |
| References | Keep depth available without clutter | Links to topic docs, appendices, source docs |
Never expand an existing document just because it is nearby. Put content where a future reader would naturally look for it.