Progressive Disclosure
Revealing AI capability gradually to match user mental models.
Install
/plugin marketplace add Owl-Listener/ai-design-skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add Owl-Listener/ai-design-skills --skill progressive-disclosuregit 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-disclosurePersonal 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.Details
- Skill name
progressive-disclosure- Repository
- Owl-Listener/ai-design-skills
- 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
Agent Role Design
207Owl-Listener/ai-design-skills
Defining what each agent does, knows, and owns in a multi-agent system.
Behavioral Consistency
207Owl-Listener/ai-design-skills
Ensuring the AI behaves predictably across sessions, edge cases, and modalities.
Bias Detection Design
207Owl-Listener/ai-design-skills
Designing review workflows to surface and mitigate bias in AI outputs.
Prompt Versioning
207Owl-Listener/ai-design-skills
Managing prompt iterations, testing changes, and tracking what works.
Model Domain
292danielvm-git/bigpowers
Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates specs/tech-architecture/tech-stack.md and specs/adr/ inline as decisions crystallise. Use when user wants to stress-test a plan against their project's domain language and documented decisions.
Reset Baseline
292danielvm-git/bigpowers
Restore the project to a known clean state between agent runs or experiments. Use between benchmark runs, after a failed spike, or when user wants a clean working tree.
Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.