Onboarding & UX
This skill covers onboarding patterns — first-time user experience, tooltips, guided tours, and feature discovery.
Use-When
This skill activates when:
- Agent builds onboarding flows
- Agent creates tooltips or feature highlights
- Agent designs first-time user experiences
- Agent implements feature discovery
Core Rules
- ALWAYS make onboarding optional and dismissible
- ALWAYS let users skip or complete quickly
- NEVER block access to core features with tours
- PREFER in-context hints over isolated tours
- ALWAYS remember completed onboarding (don't repeat)
Common Agent Mistakes
- Blocking users until tour completes
- No way to dismiss or skip
- Repeating onboarding on every visit
- Too much information at once
- Annoying users with constant tooltips
Examples
✅ Correct
// Dismissible tooltip
<Tooltip content="Click to save" side="top">
<Button>Save</Button>
</Tooltip>
❌ Wrong
// Blocked access
{!hasSeenTour && <TourBlockingOverlay />}