
onboarding-design
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.
- Installs
- 1.8K
- Last 24h
- +24
- Trending rank
- #5085
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/owl-listener/designer-skills --skill onboarding-design- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads onboarding-design automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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
FAQ
What does the onboarding-design skill do?
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.
How do I install onboarding-design?
Run npx skills add https://github.com/owl-listener/designer-skills --skill onboarding-design in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/onboarding-design/ (personal) or .claude/skills/onboarding-design/ (project).
Which AI agents can use onboarding-design?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is onboarding-design safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains onboarding-design?
It is published by owl-listener in owl-listener/designer-skills. It has 1,780 recorded installs.
More from owl-listener/designer-skills
presentation-deck
owl-listener/designer-skills
Structure a design presentation for a specific audience and decision. Use when presenting internally. For a portfolio narrative use case-study; for the written argument use design-rationale.
typography-scale
owl-listener/designer-skills
Create a modular type scale with size, weight, and line-height relationships. Use when establishing typographic structure. For line length only use readable-measure; for judging type on an existing screen use critique-typography (visual-critique).
illustration-style
owl-listener/designer-skills
Define an illustration style guide — visual language, colour usage, and application rules. Use when commissioning or standardising illustration. For icons, use icon-system (design-systems).
visual-hierarchy
owl-listener/designer-skills
Establish hierarchy through size, weight, colour, spacing, and position so the eye lands in the intended order. Use when composing new work. For judging an existing screen, use critique-visual-hierarchy (visual-critique).
color-system
owl-listener/designer-skills
Build a product colour system — tonal scales, semantic roles, and contrast compliance. Use when defining or rebuilding colour from scratch. For dark-mode adaptation use dark-mode-design; for chart palettes use data-visualization; for multi-brand token architecture use theming-system (design-systems).
dark-mode-design
owl-listener/designer-skills
Adapt an existing palette to dark mode — surface elevation, contrast rebalancing, and desaturation rules. Use when you already have a light palette to translate. For building the base palette first, use color-system.
Popular frontend & design skills
setup-matt-pocock-skills
mattpocock/skills
Configure this repo for the engineering skills: set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.
frontend-design
anthropics/skills
Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.
hyperframes-animation
heygen-com/hyperframes
All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.
prototype
mattpocock/skills
Build a throwaway prototype to answer a design question. Use when the user wants to sanity-check whether a state model or logic feels right, or explore what a UI should look like.
hyperframes-core
heygen-com/hyperframes
The HyperFrames composition contract — build one renderable project. Use for composition structure, the data- timing attributes, class="clip", tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.
vercel-react-best-practices
vercel-labs/agent-skills
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.