mcpField
P
progressive-disclosure

progressive-disclosure

github.com/flpbaladaDesign & UI28156 installsUpdated 13w ago
Repository

About progressive-disclosure

A design skill for structuring interfaces so people see essential information first and discover complexity as needed. It provides guidance for onboarding, forms, settings, and feature-rich products.

Key features

  1. 01Prioritize visible interface elements
  2. 02Plan disclosure levels
  3. 03Choose reveal patterns
  4. 04Audit interface content
  5. 05Test discoverability

Use cases

  1. 01Design onboarding for complex products
  2. 02Simplify feature-rich interfaces
  3. 03Organize multi-step forms
  4. 04Make advanced settings easier to find

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/flpbalada/my-opencode-config --skill progressive-disclosure

After installing, type/progressive-disclosurein Claude Code to confirm it loaded.

Details

From the project README

Progressive Disclosure - Show the Right Thing at the Right Time

Progressive Disclosure is an interaction design technique that sequences information and actions across time, showing users only what they need when they need it. It reduces cognitive load by deferring complexity until the user is ready for it.

When to Use This Skill

  • Designing onboarding for complex products
  • Simplifying feature-rich interfaces
  • Creating multi-step forms and wizards
  • Building admin panels and settings pages
  • Introducing new features to existing users
  • Reducing support requests and confusion

Core Concepts

The Hierarchy of Disclosure
Level 0: Essential (always visible)
    |
    v
Level 1: Important (one click away)
    |
    v
Level 2: Useful (accessible but hidden)
    |
    v
Level 3: Advanced (buried intentionally)
80/20 Rule Applied

80% of users need 20% of features. Show that 20% prominently, progressively reveal the rest.

+------------------------------------------+
|  Primary Actions (20%)                   |
|  [Action 1] [Action 2]                   |
+------------------------------------------+
|  v Advanced Options                      |
|    +------------------------------------+|
|    | Secondary (30%)                    ||
|    | [Option 3] [Option 4]              ||
|    +------------------------------------+|
|    |  v More Options                    ||
|    |    +------------------------------+||
|    |    | Tertiary (50%)              |||
|    |    | [Rare settings...]          |||
|    |    +------------------------------+||
|    +------------------------------------+|
+------------------------------------------+
Types of Progressive Disclosure
TypeMechanismExample
Click to revealExpand/collapse"Show more" sections
Hover to revealTooltip/popoverHelp text on hover
Scroll to revealBelow the foldLong-form content
Time-basedDelayed introductionFeature announcements
Skill-basedUnlock with usageAdvanced features
Role-basedPermission levelsAdmin controls

Analysis Framework

Step 1: Audit Current Interface

List all elements users see:

ElementUser NeedFrequencyCurrent Visibility
[Element 1][Need][Daily/Weekly/Rare][Always/Sometimes/Hidden]
[Element 2][Need][Daily/Weekly/Rare][Always/Sometimes/Hidden]
Step 2: Categorize by Priority
                    HIGH
                     |
    +----------------+----------------+
    |                |                |
    |  ESSENTIAL     |  CONTEXTUAL    |
    |  Always show   |  Show when     |
    |                |  relevant      |
FREQUENCY           |                NEED
    |                |                |
    |  ACCESSIBLE    |  HIDE          |
    |  One click     |  Deep menus    |
    |  away          |                |
    +----------------+----------------+
                     |
                    LOW
Step 3: Design Disclosure Pattern
StageWhat to ShowHow to Reveal Next
Initial view[Core elements][Trigger to Level 1]
Level 1[Secondary elements][Trigger to Level 2]
Level 2[Advanced elements][Trigger to Level 3]
Step 4: Test Understanding
  • Can users complete primary tasks without expanding?
  • Can users find advanced features when needed?
  • Is the "expand" affordance clear?

Output Template

## Progressive Disclosure Design

**Interface:** [Name] **Date:** [Date]

### Element Inventory

| Element | Priority  | Disclosure Level | Reveal Trigger |
| ------- | --------- | ---------------- | -------------- |
| [E1]    | Essential | Always visible   | -              |
| [E2]    | Important | Level 1          | [Trigger]      |
| [E3]    | Advanced  | Level 2          | [Trigger]      |

### Disclosure Hierarchy

**Level 0 (Always visible):**

- [Element list]

**Level 1 (One interaction):**

- Trigger: [How user reveals]
- Contents: [Element list]

**Level 2 (Two interactions):**

- Trigger: [How user reveals]
- Contents: [Element list]

### User Flow

1. User sees: [Initial state]
2. To access [feature], user: [Action]
3. System reveals: [New state]

### Success Metrics

| Metric               | Before  | After Target |
| -------------------- | ------- | ------------ |
| Task completion rate | [X%]    | [Y%]         |
| Time to complete     | [X sec] | [Y sec]      |
| Support tickets      | [X/mo]  | [Y/mo]       |

Real-World Examples

Example 1: Gmail Compose

Level 0: To, Subject, Body, Send Level 1: CC, BCC (click "Cc" to reveal) Level 2: Formatting toolbar (click "A" to reveal) Level 3: Confidential mode, schedule send (menu)

Most users never need CC/BCC, so it's hidden by default.

Example 2: Notion Properties

Level 0: Page title and content Level 1: Basic properties (click to expand) Level 2: Add property, configure property Level 3: Database views, relations, rollups

New users see a simple page; power users unlock complexity.

Example 3: iPhone Camera

Level 0: Shutter button, switch camera Level 1: Swipe for modes (Video, Portrait, etc.) Level 2: Tap for exposure/focus controls Level 3: Settings app for advanced options

Best Practices

Do
  • Make primary actions immediately visible
  • Use clear affordances for expanding ("Show more", arrows)
  • Remember user preferences for disclosure state
  • Provide search/filter for deeply hidden features
  • Test with both new and experienced users
Avoid
  • Hiding essential functionality
  • Requiring many clicks for common tasks
  • Inconsistent disclosure patterns across the product
  • Mystery meat navigation (unclear expand triggers)
  • Over-hiding to the point of unfindability
Disclosure Affordances
PatternWhen to Use
"Show more" linkText content, lists
Chevron/arrowExpandable sections
"..." menuActions, options
TabsParallel content categories
Hover revealTooltips, secondary actions
Modal/drawerComplex sub-flows

Integration with Other Methods

MethodCombined Use
Hick's LawReduce visible choices at each level
Cognitive LoadManage working memory limits
Halo EffectPolish the essential elements first
Jobs-to-be-DoneOrganize by user jobs

Resources

Comments

Markdown supported