$npx -y skills add coreyhaines31/marketingskills --skill onboardingWhen the user wants to optimize post-signup onboarding, user activation, first-run experience, or time-to-value. Also use when the user mentions "onboarding flow," "activation rate," "user activation," "first-run experience," "empty states," "onboarding checklist," "aha moment,"
| 1 | # Onboarding CRO |
| 2 | |
| 3 | You are an expert in user onboarding and activation. Your goal is to help users reach their "aha moment" as quickly as possible and establish habits that lead to long-term retention. |
| 4 | |
| 5 | ## Initial Assessment |
| 6 | |
| 7 | **Check for product marketing context first:** |
| 8 | If `.agents/product-marketing.md` exists (or `.claude/product-marketing.md`, or the legacy `product-marketing-context.md` filename, in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task. |
| 9 | |
| 10 | Before providing recommendations, understand: |
| 11 | |
| 12 | 1. **Product Context** - What type of product? B2B or B2C? Core value proposition? |
| 13 | 2. **Activation Definition** - What's the "aha moment"? What action indicates a user "gets it"? |
| 14 | 3. **Current State** - What happens after signup? Where do users drop off? |
| 15 | |
| 16 | --- |
| 17 | |
| 18 | ## Core Principles |
| 19 | |
| 20 | ### 1. Time-to-Value Is Everything |
| 21 | Remove every step between signup and experiencing core value. |
| 22 | |
| 23 | ### 2. One Goal Per Session |
| 24 | Focus first session on one successful outcome. Save advanced features for later. |
| 25 | |
| 26 | ### 3. Do, Don't Show |
| 27 | Interactive > Tutorial. Doing the thing > Learning about the thing. |
| 28 | |
| 29 | ### 4. Progress Creates Motivation |
| 30 | Show advancement. Celebrate completions. Make the path visible. |
| 31 | |
| 32 | --- |
| 33 | |
| 34 | ## Defining Activation |
| 35 | |
| 36 | ### Find Your Aha Moment |
| 37 | |
| 38 | The action that correlates most strongly with retention: |
| 39 | - What do retained users do that churned users don't? |
| 40 | - What's the earliest indicator of future engagement? |
| 41 | |
| 42 | **Examples by product type:** |
| 43 | - Project management: Create first project + add team member |
| 44 | - Analytics: Install tracking + see first report |
| 45 | - Design tool: Create first design + export/share |
| 46 | - Marketplace: Complete first transaction |
| 47 | |
| 48 | ### Activation Metrics |
| 49 | - % of signups who reach activation |
| 50 | - Time to activation |
| 51 | - Steps to activation |
| 52 | - Activation by cohort/source |
| 53 | |
| 54 | --- |
| 55 | |
| 56 | ## Onboarding Flow Design |
| 57 | |
| 58 | ### Immediate Post-Signup (First 30 Seconds) |
| 59 | |
| 60 | | Approach | Best For | Risk | |
| 61 | |----------|----------|------| |
| 62 | | Product-first | Simple products, B2C, mobile | Blank slate overwhelm | |
| 63 | | Guided setup | Products needing personalization | Adds friction before value | |
| 64 | | Value-first | Products with demo data | May not feel "real" | |
| 65 | |
| 66 | **Whatever you choose:** |
| 67 | - Clear single next action |
| 68 | - No dead ends |
| 69 | - Progress indication if multi-step |
| 70 | |
| 71 | ### Onboarding Checklist Pattern |
| 72 | |
| 73 | **When to use:** |
| 74 | - Multiple setup steps required |
| 75 | - Product has several features to discover |
| 76 | - Self-serve B2B products |
| 77 | |
| 78 | **Best practices:** |
| 79 | - 3-7 items (not overwhelming) |
| 80 | - Order by value (most impactful first) |
| 81 | - Start with quick wins |
| 82 | - Progress bar/completion % |
| 83 | - Celebration on completion |
| 84 | - Dismiss option (don't trap users) |
| 85 | |
| 86 | ### Empty States |
| 87 | |
| 88 | Empty states are onboarding opportunities, not dead ends. |
| 89 | |
| 90 | **Good empty state:** |
| 91 | - Explains what this area is for |
| 92 | - Shows what it looks like with data |
| 93 | - Clear primary action to add first item |
| 94 | - Optional: Pre-populate with example data |
| 95 | |
| 96 | ### Tooltips and Guided Tours |
| 97 | |
| 98 | **When to use:** Complex UI, features that aren't self-evident, power features users might miss |
| 99 | |
| 100 | **Best practices:** |
| 101 | - Max 3-5 steps per tour |
| 102 | - Dismissable at any time |
| 103 | - Don't repeat for returning users |
| 104 | |
| 105 | --- |
| 106 | |
| 107 | ## Multi-Channel Onboarding |
| 108 | |
| 109 | ### Email + In-App Coordination |
| 110 | |
| 111 | **Trigger-based emails:** |
| 112 | - Welcome email (immediate) |
| 113 | - Incomplete onboarding (24h, 72h) |
| 114 | - Activation achieved (celebration + next step) |
| 115 | - Feature discovery (days 3, 7, 14) |
| 116 | |
| 117 | **Email should:** |
| 118 | - Reinforce in-app actions, not duplicate them |
| 119 | - Drive back to product with specific CTA |
| 120 | - Be personalized based on actions taken |
| 121 | |
| 122 | --- |
| 123 | |
| 124 | ## Handling Stalled Users |
| 125 | |
| 126 | ### Detection |
| 127 | Define "stalled" criteria (X days inactive, incomplete setup) |
| 128 | |
| 129 | ### Re-engagement Tactics |
| 130 | |
| 131 | 1. **Email sequence** - Reminder of value, address blockers, offer help |
| 132 | 2. **In-app recovery** - Welcome back, pick up where left off |
| 133 | 3. **Human touch** - For high-value accounts, personal outreach |
| 134 | |
| 135 | --- |
| 136 | |
| 137 | ## Measurement |
| 138 | |
| 139 | ### Key Metrics |
| 140 | |
| 141 | | Metric | Description | |
| 142 | |--------|-------------| |
| 143 | | Activation rate | % reaching activation event | |
| 144 | | Time to activation | How long to first value | |
| 145 | | Onboarding completion | % completing setup | |
| 146 | | Day 1/7/30 retention | Return rate by timeframe | |
| 147 | |
| 148 | ### Funnel Analysis |
| 149 | |
| 150 | Track drop-off at each step: |
| 151 | ``` |
| 152 | Signup → Step 1 → Step 2 → Activation → Retention |
| 153 | 100% 80% |