Skip to content
cccskills
FreePublished on GitHub

onboarding-design

Design a first-use experience that guides new users from signup to a meaningful action. Plan setup steps, contextual guidance, empty screens, and sample data, with measures for understanding where users get stuck or leave.

OriginalShow the original 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`.

Run score Not tested

See how to install

Good for

  • Planning the journey from signup to a first useful action
  • Reducing unnecessary initial setup steps
  • Designing guidance for empty screens
  • Reviewing where new users abandon the flow

Files included (1)

  • SKILL.md4.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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)

  1. Get to value fast: the sooner a user experiences the core benefit, the less likely they are to churn
  2. Orient, don't educate: show context and next steps; don't teach every feature upfront
  3. Build confidence: early wins matter more than feature exposure
  4. 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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

a-b-test-design

FreeSummary

Plan A/B experiments to measure the effect of a design change. Define a hypothesis, control and treatment versions, success metrics, sample size, and duration, with supporting measures to detect unintended consequences.

  • Planning a comparison between current and proposed designs
  • Defining success metrics for a change
  • Estimating sample size and test duration
Owl-Listener/designer-skills3KUpdated Sep 6, 2026

Assess an existing interface against WCAG 2.2 accessibility guidelines. Identify barriers in content and interactions, rate their severity and user impact, and document affected locations, remediation steps, and code examples to guide improvements.

  • Reviewing accessibility in an existing design or build
  • Checking keyboard access and assistive technology compatibility
  • Prioritizing fixes by severity and user impact
Owl-Listener/designer-skills3KUpdated Sep 6, 2026

Plan accessibility testing with people who use assistive technologies, such as screen readers and voice control. Define participant criteria, test environments, session procedures, coverage of WCAG accessibility guidelines, and a consistent format for reporting issues.

  • Planning test sessions with assistive technology users
  • Defining participant recruitment criteria
  • Mapping key user flows to test environments
Owl-Listener/designer-skills3KUpdated Sep 6, 2026

Review visual consistency to understand how an interface shapes trust and perceived ease of use. Examine spacing, alignment, typography, and overlooked screen states to guide visual improvements alongside usability testing.

  • Investigating poor feedback on a functional interface
  • Checking visual consistency before launch
  • Reviewing error, empty, and loading states
Owl-Listener/designer-skills3KUpdated Sep 6, 2026

affinity-diagram

FreeSummary

Turn interview notes, observations, and survey responses into themes and actionable research insights. Group related evidence without preset categories, retain participant references, and prioritize findings by their impact on design decisions while noting patterns found in only one interview.

  • Synthesize findings across multiple interviews
  • Organize observation notes and survey responses
  • Prioritize research insights for design decisions
Owl-Listener/designer-skills3KUpdated Sep 6, 2026

Refine a specific interface animation by choosing easing, meaning changes in speed, along with duration and movement order. Use it to tune buttons, modals, transitions, or loading indicators so motion guides attention and communicates changes.

  • Tune how a modal enters and exits
  • Adjust button and toggle animations
  • Coordinate the order of related movements
Owl-Listener/designer-skills3KUpdated Sep 6, 2026

See all skills by Owl-Listener

Report a problem with this skill