onboarding-ux
Skill4 starsChanged 3 months agoApache-2.0View on GitHub
Design first-time experiences that activate users. Covers progressive disclosure, activation milestones, persona-based onboarding, empty states, checklists, tooltips, and measuring onboarding success. Use when designing first-time user experiences, improving activation rates, or reducing early churn. Triggers on: "onboarding", "first time user experience", "FTUE", "user activation", "progressive disclosure", "empty state", "product tour", "user checklist".
We split this skill into the rules it gives an agent
6 rules. About 0 are common, 6 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈6
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 47
Ask one segmentation question, route to different experiences.
- Distinctive: line 53
Ask after signup, not before
- Distinctive: line 71
Always show how to dismiss
- Distinctive: line 72
Never show the same tooltip twice
- Distinctive: line 79
Rule: Don't show everything on Day 1.
- Distinctive: line 90
Rule: Every empty screen a new user might see needs a clear next action.
≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Onboarding UX
Onboarding is the bridge between signup and value. Poor onboarding is the single largest driver of early churn.
"The shorter the path from sign-up to 'I see why this matters,' the higher your activation rate." — Samuel Hulick
The Activation Framework
Define Your Activation Milestone
The single action or outcome that signals a user has found value. Examples:
- Slack: sent first message
- Dropbox: uploaded first file
- Canva: created first design
- Airbnb: completed first booking
Rule: Build backward from this milestone. Strip everything that doesn't advance the user toward it.
The 3-Phase Onboarding Model
| Phase | When | Goal | Patterns |
| Welcome & Segment | First 30 seconds | Set direction, personalize | Welcome message, persona survey, branched paths |
| Guided Activation | First session | Reach activation milestone | Checklists, tooltips, product tours, empty states |
| Progressive Discovery | Days 2-30 | Introduce advanced features | Contextual tips, feature announcements, re-engagement |
Onboarding Patterns
Pattern: Welcome Message
A simple greeting that sets direction. Not a feature tour.
Good: "Welcome to Acme. Let's connect your calendar so you can start saving time." Bad: "Welcome! Here are 12 features you can explore."
Pattern: Persona-Based Branching
Ask one segmentation question, route to different experiences.
Example: ConvertKit asks: "Are you migrating from another platform or starting fresh?" → different paths.
Rules:
- 2-5 options max
- Ask after signup, not before
- Make it feel like personalization, not a survey
Pattern: Checklist
A list of setup tasks with progress indicator.
Best practices:
- 3-5 items max (more = overwhelming)
- Mix easy and medium tasks (builds momentum)
- Show progress visually (Zeigarnik effect: incomplete tasks create pull)
- First item should be trivial to complete
Pattern: Contextual Tooltips
Highlight features when users first encounter them.
Rules:
- One tooltip per new screen
- Point to one element, not the whole UI
- Always show how to dismiss
- Never show the same tooltip twice
Pattern: Progressive Disclosure
Introduce features as they become relevant across multiple sessions.
Example: Grammarly starts with grammar checking, introduces tone detection after a few sessions, then style guides.
Rule: Don't show everything on Day 1. Stage across the first week.
Pattern: Empty States
Turn blank screens into starting lines.
| Type | Approach |
| First-use | Instruction + CTA: "Create your first project" |
| User-cleared | Confirmation + undo: "You deleted all items. Undo?" |
| No results | Suggestions + reset: "No results. Try: broader terms, fewer filters" |
Rule: Every empty screen a new user might see needs a clear next action.
Measurement
Key Metrics
| Metric | What It Measures | Target |
| Activation rate | % reaching activation milestone | >37.5% (2025 SaaS median) |
| Time to first value | Minutes from signup to activation | As low as possible |
| Tour completion rate | % finishing onboarding flow | Context-dependent |
| Session 2 return rate | % who come back | >40% |
| Day 7 retention | % active after 7 days | Benchmark against median |
Diagnostic Signals
| Signal | Problem | Fix |
| High tour completion, low activation | Tour disconnected from value | Connect tour steps to activation actions |
| Activation varies by segment | One-size-fits-all flow | Add persona-based branching |
| Session 2 return <40% | No re-engagement plan | Add behavioral triggers for days 2-3 |
| >5 tour steps, completion <50% | Flow too long | Cut to 5 steps max |
Common Mistakes
- Front-loading everything — showing all features on Day 1
- Mandatory tours — users want to explore, not be briefed
- Measuring completion, not activation — a completed tour is not success
- No skip option — some users don't need onboarding
- One flow for all users — different segments need different paths
Reference Map
references/activation-milestone.md— defining activation, metrics, diagnostic matrixreferences/pattern-selection.md— checklist vs tour vs empty-state decision tree
Related Skills
- For empty / error / recovery states → use
error-empty-states - For interaction pattern context → use
interaction-design-patterns - For progressive disclosure principles → use
information-architecture - For form-heavy activation → use
form-ux - For UX writing in onboarding → use
ux-writing-content-design
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- SkotAlexsander/skills★ 1same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository80 other files it gives its agents.
- a11y-accessibility-designSkill
- agentic-ui-patternsSkill
- ai-native-ui-designSkill
- ai-ui-anti-patternsSkill
- ai-ui-heuristicsSkill
- calm-technology-uiSkill
- conversion-growth-designSkill
- cross-platform-designSkill
- dark-mode-designSkill
- data-visualizationSkill
- design-systemsSkill
- design-thinking-processSkill
- error-empty-statesSkill
- ethical-design-patternsSkill
- form-uxSkill
- information-architectureSkill
- interaction-design-patternsSkill
- internationalization-uiSkill
- mobile-touch-designSkill
- modal-classes-lifecycleSkill
- modal-container-imagesSkill
- modal-dicts-queuesSkill
- modal-endpointsSkill
- modal-fundamentalsSkill
- modal-gpu-computeSkill
- modal-networkingSkill
- modal-observabilitySkill
- modal-parallel-executionSkill
- modal-sandboxesSkill
- modal-scaling-performanceSkill
- modal-schedulingSkill
- modal-secretsSkill
- modal-serversSkill
- modal-storageSkill
- modal-web-servingSkill
- modal-workspace-adminSkill
- motion-design-principlesSkill
- notifications-permissionsSkill
- rust-api-designSkill
- rust-async-programmingSkill
- rust-cargo-masterySkill
- rust-cli-applicationsSkill
- rust-clippy-lintsSkill
- rust-closures-iteratorsSkill
- rust-compiler-internalsSkill
- rust-concurrencySkill
- rust-design-patternsSkill
- rust-editionsSkill
- rust-embeddedSkill
- rust-error-handlingSkill
- rust-game-developmentSkill
- rust-lifetimes-borrowingSkill
- rust-macrosSkill
- rust-performanceSkill
- rust-rustdocSkill
- rust-rustup-toolchainSkill
- rust-smart-pointersSkill
- rust-testing-benchmarkingSkill
- rust-type-systemSkill
- rust-unsafe-ffiSkill
- The first 60 shown.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

