# Progressive Disclosure

> This skill should be used when the user asks to "analyze documentation structure", "audit progressive disclosure", "restructure CLAUDE.md", "restructure AGENTS.md", "create a documentation index", "organize project docs", "find orphaned docs", "map documentation references", "improve context loading", or mentions progressive disclosure, documentation hierarchy, root configuration file organization, or context rot prevention. Analyzes or restructures how a repository discloses documentation through root configuration files.

- Skill: `florianbuetow/progressive-disclosure` (Agent Skill)
- Install (CLI): `npx skillmds@latest add florianbuetow/progressive-disclosure`
- Raw SKILL.md: https://api.skillmd.com/api/skills/florianbuetow/progressive-disclosure/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: florianbuetow (https://skillmd.com/u/florianbuetow)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/florianbuetow/progressive-disclosure

---


# Progressive Disclosure

Analyze and restructure how a repository progressively discloses its documentation through root configuration files (AGENTS.md, CLAUDE.md, GEMINI.md, USER.md, TOOLS.md, BOOTSTRAP.md, DESIGN.md, NOTICE.md). Maps reference graphs, detects orphaned documents, and generates thematic book-style indexes to prevent context rot.

## Routing

This skill auto-selects the correct workflow based on user intent.

### Step 1: Determine Mode

- **User asks to analyze, audit, map, or assess** — Route to `progressive-disclosure:analyze`
- **User asks to restructure, refactor, index, or organize** — Route to `progressive-disclosure:restructure`
- **No explicit mode specified** — Default to `progressive-disclosure:analyze`

### Step 2: Invoke

Invoke the appropriate subskill. Do not duplicate their logic here.