progressive-disclosure

Reduce context size by restructuring large documentation into a slim index with on-demand detail directories. This pattern splits monolithic docs so only the root entry is loaded initially, preventing context bloat and improving response times.

Progressive disclosure is a documentation structure pattern that provides a slim root index for quick navigation and loads topic-specific detail directories on-demand. It enables token-efficient access to product guides and references by separating the index from deeper information.

Structure product docs by creating a root SKILL.md entry with YAML frontmatter defining name and description. Use this slim index as the default navigation point, placing deeper information into topic-specific directories that are loaded only when requested.

No external dependencies are required to implement this on-demand documentation structure. The pattern relies solely on a root entry file with YAML frontmatter and optional support for scripts, references, and assets to power deterministic tasks when invoked.

Split monolithic docs into a slim index when sections are rarely needed together, causing context bloat and slow response times. This approach is applicable to knowledge bases, API references, and product guides where users navigate specific topics independently.

The best way to improve token efficiency is to restructure large guides into a slim index plus on-demand detail directories. By loading topic folders only when deeper information is required, you reduce token usage and speed up responses.