Back to Skills

progressive-disclosure

verified

Use when designing interfaces with complex functionality, settings panels, or expert features. Covers layering information so beginners aren't overwhelmed and experts aren't held back.

View on GitHub

Marketplace

agi-marketplace

bfmcneill/agi-marketplace

Plugin

ux

Repository

bfmcneill/agi-marketplace

ux/skills/progressive-disclosure/SKILL.md

Last Verified

January 21, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/bfmcneill/agi-marketplace/blob/main/ux/skills/progressive-disclosure/SKILL.md -a claude-code --skill progressive-disclosure

Installation paths:

Claude
.claude/skills/progressive-disclosure/
Powered by add-skill CLI

Instructions

# Progressive Disclosure

Show users what they need when they need it. Hide complexity until it's relevant. Let depth feel like discovery, not burden.

## Evidence Tiers

```
[Research]   — Peer-reviewed studies, controlled experiments
[Expert]     — Nielsen Norman Group, recognized UX authorities
[Case Study] — Documented examples from major products
[Convention] — Industry practice, limited formal validation

Multiple tags = stronger evidence: [Research][Expert]
Mixed findings noted as: [Research — Mixed]
```

---

## Research Foundation

**[Research — Limited]** Carroll and Rosson (1987) developed the "training wheels" approach, hiding advanced functionality to help novices succeed. However, they noted that **empirical evidence for progressive disclosure effectiveness is limited**.

From Carroll & Rosson (1997): "No empirical evidence exists regarding the effectiveness of progressive disclosure."

**What we do know:**
- **[Research]** Miller's Law (1956): Working memory holds ~7±2 items (some modern research suggests ~4 chunks)
- **[Research]** Cognitive Load Theory (Sweller, 1988): Reducing extraneous load improves learning
- **[Expert]** Nielsen Norman Group recommends progressive disclosure for improving learnability, efficiency, and reducing errors

**Honest assessment:** Progressive disclosure is widely accepted as good practice, but rigorous controlled studies are sparse. Most evidence comes from case studies and practitioner experience.

**Source:** [Nielsen Norman - Progressive Disclosure](https://www.nngroup.com/articles/progressive-disclosure/)

---

## The Depth Hierarchy

**[Expert]** Structure complexity in layers:

```
┌─────────────────────────────────────┐
│  Layer 1: Essential (always shown)  │  ← What 80% of users need
├─────────────────────────────────────┤
│  Layer 2: Common (one click away)   │  ← Frequently used options
├─────────────────────────────────────┤
│  Layer 3: Advanced (discoverable)   │  ← Power user features
├───────────────────

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
8095 chars