MANDATORY PREPARATION

Users start this workflow with /onboard. Once this skill is active, load $frontend-design — it contains design principles, anti-patterns, and the Context Gathering Protocol. Follow that protocol before proceeding — if no design context exists yet, you MUST load $setup first. Additionally gather: the "aha moment" you want users to reach, and users' experience level.

Consult the onboarding UX when deciding first-run sequencing, activation milestones, setup-wizard scope, tours vs checklists vs contextual onboarding, progressive permission requests, or how returning users should re-enter an unfinished flow. Consult the empty-state patterns when zero-data surfaces are part of the onboarding journey. Consult the cognitive load when deciding what to hide, sequence, or progressively disclose for first-time users. Consult the behavioral design when onboarding depends on priming, framing, honest progress cues, or completion momentum. Consult the permissions and roles UX when onboarding depends on request-access flows, role selection, admin-vs-member setup differences, or capability boundaries that users need explained early. Consult the ux-writing reference when onboarding clarity depends on labels, hints, reassurance copy, or CTA wording. Consult the status communication when onboarding needs notification preferences, summary modes, quiet hours, reminder settings, or interruption-level decisions. Consult the loading feedback and perceived performance when setup, imports, or first-run data preparation create waits that need honest progress and trust-preserving feedback. Consult marketing copywriting when onboarding needs stronger setup promises, first-win framing, permission prompts, or upgrade / invite messaging. Consult copy editing sweeps when revising existing onboarding copy in focused passes.

Create or improve onboarding experiences that help users understand, adopt, and succeed with the product quickly.