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
tsx
// Dismissible tooltip <Tooltip content="Click to save" side="top"> <Button>Save</Button> </Tooltip>
❌ Wrong
tsx
// Blocked access
{!hasSeenTour && <TourBlockingOverlay />}