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 />}

References

• Onboarding UX