Guides building and reviewing onboarding flows, empty states, progress checklists, signup forms, and product tours using progressive disclosure to optimize time-to-value.
How this skill is triggered — by the user, by Claude, or both
Slash command
/saas-design-principles:progressive-disclosureThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Nielsen defined progressive disclosure in 2006: defer advanced or rarely used features to a secondary screen, making applications easier to learn and less error-prone. This improves learnability, efficiency of use, and error rate.
Nielsen defined progressive disclosure in 2006: defer advanced or rarely used features to a secondary screen, making applications easier to learn and less error-prone. This improves learnability, efficiency of use, and error rate.
Never go beyond two levels of disclosure. Usability drops rapidly at three or more levels because users get lost navigating between them. If a settings panel requires three levels of nesting, the design needs simplification, not more progressive disclosure.
Linear's philosophy: "Simple first, then powerful." Intercom's principle: "Simple and opinionated by default, progressively reveal power and flexibility."
Onboarding is progressive disclosure applied to time. The data is stark: 40–60% of signup users never return after their first experience. Every extra minute in time-to-value lowers conversion by approximately 3%.
Checklists work because of the Zeigarnik effect — the psychological need to complete unfinished tasks.
Rules:
Empty states are the most underrated onboarding surface. Notion fills its empty first-use state with educational content that doubles as a checklist.
Every empty state needs three things:
Never show a blank screen with "No data yet." An empty state should never feel empty or negative, even when things aren't working as expected (SAP Fiori).
When reviewing or building progressive disclosure:
npx claudepluginhub oborchers/fractional-cto --plugin saas-design-principlesDesigns first-run product onboarding wizards that get users to the ah-ha moment without overwhelming them. Covers step architecture, progressive disclosure, escape hatches, completion incentives, and drop-off measurement.
Applies progressive disclosure to forms, settings, and panels — shows primary options first and reveals secondary/advanced options on demand to reduce cognitive load.
Writes onboarding copy for welcome screens, setup wizards, and first-run experiences. Focuses on value-first messaging, single-action screens, and progress indicators to reduce user anxiety.