Squire onboarding-cro
When 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," or "new user experience." For signup/registration optimization, see signup-flow-cro. For ongoing email sequences, see email-sequence.
git clone https://github.com/eddiebelaval/squire
T=$(mktemp -d) && git clone --depth=1 https://github.com/eddiebelaval/squire "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/onboarding-cro" ~/.claude/skills/eddiebelaval-squire-onboarding-cro && rm -rf "$T"
skills/onboarding-cro/SKILL.mdCore Workflows
Workflow 1: Primary Action
- Analyze the input and context
- Validate prerequisites are met
- Execute the core operation
- Verify the output meets expectations
- Report results
Core Principles
1. Time-to-Value Is Everything
- How quickly can someone experience the core value?
- Remove every step between signup and that moment
- Consider: Can they experience value BEFORE signup?
2. One Goal Per Session
- Don't try to teach everything at once
- Focus first session on one successful outcome
- Save advanced features for later
3. Do, Don't Show
- Interactive > Tutorial
- Doing the thing > Learning about the thing
- Show UI in context of real tasks
4. Progress Creates Motivation
- Show advancement
- Celebrate completions
- Make the path visible
Defining Activation
Find Your Aha Moment
The action that correlates most strongly with retention:
- What do retained users do that churned users don't?
- What's the earliest indicator of future engagement?
- What action demonstrates they "got it"?
Examples by product type:
- Project management: Create first project + add team member
- Analytics: Install tracking + see first report
- Design tool: Create first design + export/share
- Collaboration: Invite first teammate
- Marketplace: Complete first transaction
Activation Metrics
- % of signups who reach activation
- Time to activation
- Steps to activation
- Activation by cohort/source
Onboarding Flow Design
Immediate Post-Signup (First 30 Seconds)
Options:
-
Product-first: Drop directly into product
- Best for: Simple products, B2C, mobile apps
- Risk: Blank slate overwhelm
-
Guided setup: Short wizard to configure
- Best for: Products needing personalization
- Risk: Adds friction before value
-
Value-first: Show outcome immediately
- Best for: Products with demo data or samples
- Risk: May not feel "real"
Whatever you choose:
- Clear single next action
- No dead ends
- Progress indication if multi-step
Onboarding Checklist Pattern
When to use:
- Multiple setup steps required
- Product has several features to discover
- Self-serve B2B products
Best practices:
- 3-7 items (not overwhelming)
- Order by value (most impactful first)
- Start with quick wins
- Progress bar/completion %
- Celebration on completion
- Dismiss option (don't trap users)
Checklist item structure:
- Clear action verb
- Benefit hint
- Estimated time
- Quick-start capability
Example:
☐ Connect your first data source (2 min) Get real-time insights from your existing tools [Connect Now]
Empty States
Empty states are onboarding opportunities, not dead ends.
Good empty state:
- Explains what this area is for
- Shows what it looks like with data
- Clear primary action to add first item
- Optional: Pre-populate with example data
Structure:
- Illustration or preview
- Brief explanation of value
- Primary CTA to add first item
- Optional: Secondary action (import, template)
Tooltips and Guided Tours
When to use:
- Complex UI that benefits from orientation
- Features that aren't self-evident
- Power features users might miss
When to avoid:
- Simple, intuitive interfaces
- Mobile apps (limited screen space)
- When they interrupt important flows
Best practices:
- Max 3-5 steps per tour
- Point to actual UI elements
- Dismissable at any time
- Don't repeat for returning users
- Consider user-initiated tours
Progress Indicators
Types:
- Checklist (discrete tasks)
- Progress bar (% complete)
- Level/stage indicator
- Profile completeness
Best practices:
- Show early progress (start at 20%, not 0%)
- Quick early wins (first items easy to complete)
- Clear benefit of completing
- Don't block features behind completion
Multi-Channel Onboarding
Email + In-App Coordination
Trigger-based emails:
- Welcome email (immediate)
- Incomplete onboarding (24h, 72h)
- Activation achieved (celebration + next step)
- Feature discovery (days 3, 7, 14)
- Stalled user re-engagement
Email should:
- Reinforce in-app actions
- Not duplicate in-app messaging
- Drive back to product with specific CTA
- Be personalized based on actions taken
Push Notifications (Mobile)
- Permission timing is critical (not immediately)
- Clear value proposition for enabling
- Reserve for genuine value moments
- Re-engagement for stalled users
Engagement Loops
Building Habits
- What regular action should users take?
- What trigger can prompt return?
- What reward reinforces the behavior?
Loop structure: Trigger → Action → Variable Reward → Investment
Examples:
- Trigger: Email digest of activity
- Action: Log in to respond
- Reward: Social engagement, progress, achievement
- Investment: Add more data, connections, content
Milestone Celebrations
- Acknowledge meaningful achievements
- Show progress relative to journey
- Suggest next milestone
- Shareable moments (social proof generation)
Handling Stalled Users
Detection
- Define "stalled" criteria (X days inactive, incomplete setup)
- Monitor at cohort level
- Track recovery rate
Re-engagement Tactics
-
Email sequence for incomplete onboarding
- Reminder of value proposition
- Address common blockers
- Offer help/demo/call
- Deadline/urgency if appropriate
-
In-app recovery
- Welcome back message
- Pick up where they left off
- Simplified path to activation
-
Human touch
- For high-value accounts: personal outreach
- Offer live walkthrough
- Ask what's blocking them
Measurement
Key Metrics
- Activation rate: % reaching activation event
- Time to activation: How long to first value
- Onboarding completion: % completing setup
- Day 1/7/30 retention: Return rate by timeframe
- Feature adoption: Which features get used
Funnel Analysis
Track drop-off at each step:
Signup → Step 1 → Step 2 → Activation → Retention 100% 80% 60% 40% 25%
Identify biggest drops and focus there.
Output Format
Onboarding Audit
For each issue:
- Finding: What's happening
- Impact: Why it matters
- Recommendation: Specific fix
- Priority: High/Medium/Low
Onboarding Flow Design
- Activation goal: What they should achieve
- Step-by-step flow: Each screen/state
- Checklist items: If applicable
- Empty states: Copy and CTA
- Email sequence: Triggers and content
- Metrics plan: What to measure
Copy Deliverables
- Welcome screen copy
- Checklist items with microcopy
- Empty state copy
- Tooltip content
- Email sequence copy
- Milestone celebration copy
Common Patterns by Product Type
B2B SaaS Tool
- Short setup wizard (use case selection)
- First value-generating action
- Team invitation prompt
- Checklist for deeper setup
Marketplace/Platform
- Complete profile
- First search/browse
- First transaction
- Repeat engagement loop
Mobile App
- Permission requests (strategic timing)
- Quick win in first session
- Push notification setup
- Habit loop establishment
Content/Social Platform
- Follow/customize feed
- First content consumption
- First content creation
- Social connection/engagement
Experiment Ideas
Flow Simplification Experiments
Reduce Friction
- Add or remove email verification during onboarding
- Test empty states vs. pre-populated dummy data
- Provide pre-filled templates to accelerate setup
- Add OAuth options for faster account linking
- Reduce number of required onboarding steps
Step Sequencing
- Test different ordering of onboarding steps
- Lead with highest-value features first
- Move friction-heavy steps later in flow
- Test required vs. optional step balance
Progress & Motivation
- Add progress bars or completion percentages
- Test onboarding checklists (3-5 items vs. 5-7 items)
- Gamify milestones with badges or rewards
- Show "X% complete" messaging
Guided Experience Experiments
Product Tours
- Add interactive product tours (Navattic, Storylane)
- Test tooltip-based guidance vs. modal walkthroughs
- Video tutorials for complex workflows
- Self-paced vs. guided tour options
CTA Optimization
- Test CTA text variations during onboarding
- Test CTA placement within onboarding screens
- Add in-app tooltips for advanced features
- Sticky CTAs that persist during onboarding
Personalization Experiments
User Segmentation
- Segment users by role to show relevant features
- Segment by goal to customize onboarding path
- Create role-specific dashboards
- Ask use-case question to personalize flow
Dynamic Content
- Personalized welcome messages
- Industry-specific examples and templates
- Dynamic feature recommendations based on answers
Quick Wins & Engagement Experiments
Time-to-Value
- Highlight quick wins early ("Complete your first X")
- Show success messages after key actions
- Display progress celebrations at milestones
- Suggest next steps after each completion
Support & Help
- Offer free onboarding calls for complex products
- Add contextual help throughout onboarding
- Test chat support availability during onboarding
- Proactive outreach for stuck users
Email & Multi-Channel Experiments
Onboarding Emails
- Personalized welcome email from founder
- Behavior-based emails (triggered by actions/inactions)
- Test email timing and frequency
- Include quick tips and video content
Feedback Loops
- Add NPS survey during onboarding
- Ask "What's blocking you?" for incomplete users
- Follow-up based on NPS score
Questions to Ask
If you need more context:
- What action most correlates with retention?
- What happens immediately after signup?
- Where do users currently drop off?
- What's your activation rate target?
- Do you have cohort analysis on successful vs. churned users?
Related Skills
- signup-flow-cro: For optimizing the signup before onboarding
- email-sequence: For onboarding email series
- paywall-upgrade-cro: For converting to paid during/after onboarding
- ab-test-setup: For testing onboarding changes