Progressive Disclosure

Revealing AI capability gradually to match user mental models.

207 stars 37 forksAI, LLMs & Agents Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add Owl-Listener/ai-design-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add Owl-Listener/ai-design-skills --skill progressive-disclosure
Manual install
git clone --depth 1 https://github.com/Owl-Listener/ai-design-skills.git /tmp/ai-design-skills
mkdir -p ~/.claude/skills
cp -r /tmp/ai-design-skills/claude-plugin/model-interaction-design/skills/progressive-disclosure ~/.claude/skills/progressive-disclosure

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Progressive Disclosure
Users don't understand what AI can do. Progressive disclosure is how you reveal capabilities at the right pace — preventing both overwhelm and underuse.
## The Mental Model Gap
Users arrive with mental models shaped by previous technology. They may:
- Treat the AI like a search engine (keyword queries)
- Treat it like a form (expecting rigid structure)
- Underestimate what it can do (asking for less than it offers)
- Overestimate what it can do (expecting perfection)
Progressive disclosure bridges the gap between what users think the AI does and what it actually does.
## Disclosure Strategies
- **On-demand hints**: Show capability suggestions contextually ("Did you know you can also ask me to...")
- **Escalating examples**: Start with simple use cases, reveal complex ones as the user gains confidence
- **Feature graduation**: Unlock advanced features after the user demonstrates comfort with basics
- **Contextual teaching**: When the user attempts something inefficiently, show a better approach
- **Capability boundaries**: Clearly communicate what the AI cannot do, not just what it can
## Layered Capability Revelation
Structure capabilities in layers:
1. **Surface layer**: The most obvious, lowest-risk capabilities. Users discover these immediately.
2. **Intermediate layer**: More powerful features revealed through tooltips, suggestions, or first-use prompts.
3. **Power layer**: Advanced capabilities for experienced users — available but not promoted.
Read the full skill on GitHub

Details

Skill name
progressive-disclosure
Path
claude-plugin/model-interaction-design/skills/progressive-disclosure/SKILL.md
License
MIT
Repo updated
9 June 2026

FAQ

What does the Progressive Disclosure skill do?

Revealing AI capability gradually to match user mental models.

How do I install the Progressive Disclosure skill?

Claude Code plugin: /plugin marketplace add Owl-Listener/ai-design-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Progressive Disclosure popular?

It lives in Owl-Listener/ai-design-skills, which has 207 GitHub stars and 37 forks.

Related skills

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.