onboarding-design
owl-listener/designer-skills
Design first-run experiences that get users to value fast and build confidence.
What is onboarding-design?
Expert guidance for designing end-to-end onboarding flows—from sign-up through first meaningful action. Use this to orient new users, reduce setup friction, and accelerate time-to-value. For signup form mechanics specifically, use form-design instead.
- Design progressive onboarding that teaches features in context rather than upfront
- Create setup wizards and linear configuration flows for products requiring initial setup
- Use sample data and demo modes to show a fully-functional product before users add their own content
- Design intentional empty states that explain purpose and guide first actions
- Reduce friction by deferring non-critical data collection and using smart defaults
- Measure activation rate, time-to-value, retention, and drop-off by step
How to install onboarding-design
npx skills add https://github.com/owl-listener/designer-skills --skill onboarding-designHow to use onboarding-design
- 1.Define your product's 'aha moment'—the action or insight where users first feel core value
- 2.Choose an onboarding pattern (progressive, setup wizard, sample data, or interactive tour) based on your product complexity and user experience level
- 3.Design the activation path to reach that aha moment as directly as possible, deferring non-critical setup
- 4.Instrument every step to track activation rate, time-to-activation, and drop-off by step
- 5.Test with real new users matching your target profile, not internal team members
- 6.Measure Day-7 and Day-30 retention as downstream signals of onboarding quality
- 7.Re-test onboarding whenever core product changes
Use cases
- Designing a team collaboration tool's first-run flow to get users to their first project creation
- Creating a dashboard product's onboarding with sample data so users see what a populated dashboard looks like
- Building a progressive onboarding system for a complex SaaS tool using tooltips and contextual coach marks
- Defining the activation path for a new product and instrumenting it to measure drop-off by step
- Restructuring onboarding after a major product change to prevent user confusion
- Product designers and design leads
- Growth and activation specialists
- Product managers building new user experiences
- UX researchers measuring onboarding effectiveness
onboarding-design FAQ
Use a setup wizard for products that can't function without initial configuration (team tools, integrations, config-heavy apps). Use progressive onboarding for complex tools with many features where teaching in context works better than a dedicated flow.
Defer collection of non-critical data (profile photo, billing, preferences) until after users experience value. Use progressive disclosure to ask for more as users advance. Provide smart defaults and skip/later options for optional steps.
Onboarding is the end-to-end first-run experience designed to get users to their first value action. A feature tour is just one pattern—an interactive walkthrough—and should be used sparingly for 3–5 core concepts, never as a substitute for reaching value quickly.
Track activation rate (% completing first value action), time-to-activation, onboarding completion rate, Day-7/Day-30 retention, and drop-off by step. The most important signal is whether onboarding quality predicts downstream retention.
Yes. Onboarding breaks more often than it appears to when core product changes. Also re-test for returning users who missed onboarding or return after a gap—they need re-orientation too.
Full instructions (SKILL.md)
Source of truth, from owl-listener/designer-skills.
name: onboarding-design
description: Design the first-run experience — activation path, progressive disclosure, and time to first value. Use for a user's very first session. For the mechanics of the signup form itself, use form-design.
Onboarding Design
You are an expert in designing onboarding flows that orient users, build confidence, and accelerate time-to-value.
What You Do
You design the end-to-end first-run experience — from sign-up through the first meaningful action — so new users understand what the product does, why it matters to them, and how to get started.
Onboarding Goals (in priority order)
- Get to value fast: the sooner a user experiences the core benefit, the less likely they are to churn
- Orient, don't educate: show context and next steps; don't teach every feature upfront
- Build confidence: early wins matter more than feature exposure
- Reduce setup friction: collect only what's needed now; defer the rest
Onboarding Patterns
Progressive Onboarding
Teach features in context, at the moment they're relevant, rather than in a dedicated onboarding flow. Best for complex tools with many features and experienced users.
- Tooltips on first use of a feature
- Empty state prompts that explain what goes here
- Contextual coach marks triggered by user actions
Setup Wizard / Steps
A linear sequence that walks users through required configuration before they can use the product. Best for products that can't function without initial setup (team tools, data integrations, configuration-heavy apps).
- Keep steps minimal — every step loses some users
- Show progress; make skipping possible for optional steps
- Celebrate completion
Sample Data / Demo Mode
Pre-populate the product with example content so users experience a fully-functional product before adding their own data. Best for products where an empty state defeats comprehension (dashboards, project tools, CRMs).
- Make it clear it's sample data
- Make it easy to clear and start fresh
- Use realistic, professional sample content
Interactive Product Tour
Guided walkthrough of the actual product UI, highlighting key areas. Best used sparingly for 3–5 core concepts; avoid encyclopedic tours.
- Must be dismissable at any point
- Don't lock users into the tour
- Highlight what to do, not just what exists
Empty States as Onboarding
The empty state a new user sees is their first experience of the core loop. Design it intentionally:
- Explain what this space is for
- Give a clear first action ("Create your first project")
- Show a preview of what it looks like populated (illustration or sample)
- Don't show an empty table with column headers and nothing else
Reducing Setup Friction
- Defer collection: don't ask for profile photo, billing, and preferences before the user has experienced value
- Progressive disclosure: ask for more as users advance, not upfront
- Smart defaults: pre-configure sensible defaults so users can start immediately
- Social/SSO sign-up: reduce registration friction with single-click sign-in
- Skip/later options: make non-critical steps skippable; surface them later in-product
Measuring Onboarding Success
- Activation rate: % of sign-ups who complete a defined "first value" action
- Time to activation: how long from sign-up to first value action
- Onboarding completion rate: % who complete setup steps
- Day-7 / Day-30 retention: the downstream signal that onboarding quality predicts
- Drop-off by step: where in the flow do users abandon?
Common Mistakes
- Showing a feature tour before the user has any context for why they'd want those features
- Collecting too much data upfront (profile, preferences, billing) before delivering value
- Treating onboarding as a one-time event — returning users who missed onboarding, or who return after a gap, need re-orientation
- Skipping empty state design — new users spend more time in empty states than any other state
Best Practices
- Define the "aha moment" — the action or insight where users first feel the product's value — and design the entire flow to reach it as directly as possible
- Instrument every step and measure drop-off; onboarding is the highest-leverage funnel to optimize
- Test onboarding with users who match the real new-user profile, not internal team members
- Re-test onboarding when core product changes; it breaks more often than it appears to
Related skills
More from owl-listener/designer-skills and the wider catalog.

opportunity-framework
Identify, score, and prioritize design opportunities against impact and effort.

pattern-library
Document reusable design patterns with problem context, solution, anatomy, and related patterns.

presentation-deck
Structure design presentations that persuade your specific audience and drive decisions.

prototype-strategy
Choose the right prototype fidelity and method to answer your design question efficiently.

readable-measure
Set optimal line length (45–75 characters) for comfortable reading across devices and type sizes.

research-repository
Organize research findings so teams stop redoing studies and build on accumulated evidence.