onboarding-cro

Production-grade user onboarding optimization framework covering activation definition, time-to-value engineering, flow architecture, empty state design, multi-channel coordination, stalled user recovery, and experiment design. Focused on the critical window between signup and habitual product usage.

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "onboarding-cro" with this command: npx skills add borghei/claude-skills/borghei-claude-skills-onboarding-cro

Onboarding CRO

Production-grade user onboarding optimization framework covering activation definition, time-to-value engineering, flow architecture, empty state design, multi-channel coordination, stalled user recovery, and experiment design. Focused on the critical window between signup and habitual product usage.

Table of Contents

  • Initial Assessment

  • Activation Definition Framework

  • Onboarding Flow Architecture

  • Time-to-Value Engineering

  • Empty State Design

  • Onboarding Patterns by Product Type

  • Multi-Channel Coordination

  • Stalled User Recovery

  • Onboarding Checklist Design

  • Tooltip and Tour Design

  • Metrics and Measurement

  • Experiment Framework

  • Output Artifacts

  • Related Skills

Initial Assessment

Required Context

Question Why It Matters

What is the product type? (B2B SaaS, B2C app, marketplace, content platform) Determines the onboarding pattern

What is the core value proposition? Defines what the aha moment should demonstrate

What happens immediately after signup? Identifies the current first-run experience

What action correlates most with 30-day retention? Defines the activation event

Where do users drop off? (funnel data if available) Pinpoints the biggest bottleneck

What is the current activation rate? Baseline for improvement

What is Day-1 / Day-7 / Day-30 retention? Context for urgency

Activation Definition Framework

Finding the Aha Moment

The aha moment is the specific action that, once completed, makes a user significantly more likely to retain. It is NOT a feature -- it is the moment the user experiences the core value.

Method to identify it:

  • Cohort comparison: Compare 90-day retained users vs churned users. What actions did retained users do in the first 7 days that churned users did not?

  • Correlation analysis: For each candidate action, calculate the correlation between completing that action in week 1 and being retained at day 30.

  • Timing analysis: When do retained users complete this action? (Day 1? Day 3? Day 7?)

Activation Event Examples

Product Type Activation Event Why This Works

Project management Create project + invite 1 team member Collaboration creates switching costs

Analytics tool Install tracking + view first report Seeing their own data is the value

Design tool Create first design + export or share Output = value realized

CRM Import contacts + log first activity Data investment creates lock-in

Marketplace Complete first transaction Transaction = value delivered

Content platform Follow 3+ sources + consume 5+ items Personalization drives habit

Communication tool Send first message + get a reply Two-sided value activation

Activation Metric Structure

Activation Rate = Users who reach activation event / Total signups (within first N days)

Target: 40-60% activation within 7 days for B2C 25-40% activation within 14 days for B2B

Onboarding Flow Architecture

Flow Type Selection

Approach Best For Risk Mitigation

Product-first (drop into product) Simple products, B2C, mobile apps Blank slate overwhelm Pre-populated sample data

Guided setup (wizard) Products needing configuration Adds friction before value Keep to 3-5 steps max

Value-first (show results immediately) Products with demo data May not feel personalized Use their data if possible

Template-first Creative/productivity tools Choice paralysis Curate 3-5 starter templates

Video walkthrough Complex B2B products Users skip videos Keep under 90 seconds

The First 30-Second Rule

Whatever flow type you choose, within 30 seconds of landing in the product, the user must:

  • See a clear single next action (not 5 options)

  • Understand what the product will do for them

  • Have a visible path forward (no dead ends)

Flow Design Principles

Principle Implementation

One goal per session First session focuses ONLY on reaching the aha moment

Do, don't show User performs the action, not watches a tutorial about it

Progress creates motivation Show advancement (checklist, progress bar, celebration)

Defer complexity Advanced settings and features surface AFTER activation

Always escapable Users can skip or dismiss any onboarding element

Remember state If user leaves and returns, resume where they left off

Time-to-Value Engineering

Time-to-Value (TTV) Reduction Framework

TTV is the elapsed time between signup and the user experiencing core value. Shorter = better.

Bottleneck Detection Fix Expected TTV Reduction

Setup required before use Users drop off during setup Reduce required setup steps, use defaults 30-50%

Waiting for data No value until data arrives Provide sample/demo data immediately 40-60%

Waiting for team members Value requires collaboration Enable solo value first, then team 20-40%

Integration required Cannot function without connecting tools Offer manual input as alternative 30-50%

Learning curve Product too complex for quick win Guided first action with templates 20-30%

Approval/verification required Email verification, admin approval Defer verification to after first value 40-60%

Quick Win Architecture

Design the onboarding to deliver a "quick win" within the first 3 minutes:

  • Identify the simplest valuable output the product can deliver

  • Pre-populate inputs where possible

  • Minimize decisions (use smart defaults)

  • Celebrate the output ("You just created your first [X]!")

  • Immediately show the next step

Empty State Design

Empty states are onboarding moments, not dead ends. Every blank screen is an opportunity to guide the user toward activation.

Empty State Anatomy

┌─────────────────────────────────────┐ │ │ │ [Illustration or Preview] │ Show what this will look like with data │ │ │ What this section does │ 1 sentence, benefit-focused │ │ │ [Primary CTA: Create First X] │ Single clear action │ │ │ Or try with sample data → │ Low-friction alternative │ │ └─────────────────────────────────────┘

Empty State Rules

Rule Good Bad

Show the end state Preview with sample data Completely blank screen

Single CTA "Create your first project" "Learn more" + "Watch video" + "Read docs"

Explain the value "Track your team's progress in one view" "No projects found"

Offer sample data "Try with example data" link Force creation from scratch

Onboarding Patterns by Product Type

B2B SaaS

Signup → Setup Wizard (3-5 steps) → First Value Action → Team Invite → Deep Setup ├── Company info ├── Template selection ├── Email invites ├── Role/goal selection ├── Quick configuration └── Permissions └── Integration connect └── First output created

Key metric: Time from signup to first team collaboration

Marketplace / Two-Sided

Signup → Complete Profile → Browse/Discover → First Transaction → Repeat Loop ├── Photo/avatar ├── Curated feed ├── Guided first action ├── Preferences ├── Search + filters └── Transaction completion └── Verification └── Saved/bookmarked

Key metric: Time from signup to first completed transaction

Mobile App (B2C)

Install → Permission Requests → Quick Win → Push Notification Setup → Habit Loop ├── Location (if needed) ├── Core action ├── Value-based ask ├── Notifications ├── Immediate result └── Frequency choice └── Camera/contacts └── Celebration

Key metric: Day-1 retention rate

Content / Media Platform

Signup → Interest Selection → Personalized Feed → First Engagement → Social Connection ├── Topic picks ├── Curated content ├── Read/watch/listen ├── Creator follows ├── Algorithmic mix └── Like/save/share └── Format preferences └── Notification prefs

Key metric: Sessions per week in first 14 days

Multi-Channel Coordination

Email + In-App Matrix

Trigger In-App Action Email Action Timing

Signup complete Welcome screen with first step Welcome email with single CTA Immediate

Step 1 complete Show step 2 -- (don't email for every step) Immediate

24 hours, incomplete onboarding Persistent banner/checklist "Complete your setup" email 24h after signup

72 hours, not activated Welcome back modal "Here's what you can do" email 72h after signup

Activation achieved Celebration modal + next feature Celebration email + next step Immediate

Day 7, feature discovery Contextual tooltip "Did you know?" feature email Day 7

Day 14, engagement dip

Re-engagement with use case examples Day 14

Email Design Rules

  • Each email has ONE CTA that drives back into the product

  • Personalize based on actions already taken (do not ask them to do what they already did)

  • Keep emails short (< 150 words body)

  • Subject line references the specific next step, not generic "Welcome to [Product]"

Stalled User Recovery

Stalled User Definition

Stalled State Criteria Recovery Priority

Never started Signed up, never logged in again Medium (may be wrong ICP)

Partially onboarded Completed 1-2 setup steps, stopped High (invested effort, hit a wall)

Active but not activated Logged in 3+ times, never reached aha moment Highest (engaged but stuck)

Activated but churning Reached aha moment, usage declining High (retention problem, not onboarding)

Recovery Tactics

Stalled State Tactic 1 Tactic 2 Tactic 3

Never started "We set up [X] for you" email Pre-populated account

Partially onboarded "Pick up where you left off" email Simplify remaining steps Offer live help

Active but not activated In-app guided walkthrough "Users like you do [X]" suggestion Human outreach for high-value

Activated but churning Feature discovery emails Usage tips based on their workflow CSM outreach for enterprise

Human Touch Triggers

For high-value accounts (enterprise, high ACV), trigger human outreach when:

  • User is > 48 hours stalled in onboarding

  • User visits help docs more than 3 times in a session

  • User starts and abandons the same action 2+ times

  • User's engagement score drops below threshold after initial activation

Onboarding Checklist Design

When to Use a Checklist

  • Multiple setup steps required before full value

  • Product has several features to discover

  • Self-serve B2B products where users self-onboard

  • Products with a clear "fully set up" state

Checklist Best Practices

Rule Implementation

3-7 items Fewer than 3 = not worth a checklist. More than 7 = overwhelming.

Order by value Most impactful action first

Start with quick wins First item should be completable in < 60 seconds

Show progress Progress bar or "3 of 5 complete" counter

Pre-check completed items If they already did something, mark it done

Celebrate completion Animation, confetti, "You're all set!" message

Dismissable "I'll do this later" option. Never trap users.

Persistent but not blocking Sidebar widget or dashboard card, not a blocking modal

Checklist Item Design

Each item should include:

  • Clear action label ("Import your contacts")

  • Why it matters ("So you can track interactions")

  • Estimated time ("Takes about 2 minutes")

  • CTA button ("Import Now")

Tooltip and Tour Design

When to Use Tooltips/Tours

  • Complex UI where features are not self-evident

  • Power features users might miss

  • UI changes after a major update

  • Features that require specific discovery order

Tour Best Practices

Rule Implementation

Max 3-5 steps per tour More than 5 and users will dismiss

Dismissable at any time "Skip tour" on every step

Don't repeat for returning users Track tour completion, never show again

Highlight the actual UI element Spotlight effect on the element being explained

Action-oriented "Click here to create a project" not "This is where projects live"

Progressive Show basic tour on day 1, advanced features tour on day 7

Metrics and Measurement

Key Metrics

Metric Formula Target

Activation rate Users reaching activation / Total signups B2C: 40-60%, B2B: 25-40%

Time to activation Median time from signup to activation event B2C: < 1 day, B2B: < 7 days

Onboarding completion rate Users completing all steps / Total signups

60%

Day-1 retention Users returning day after signup / Total signups

40%

Day-7 retention Users active 7 days after signup / Total signups

25%

Day-30 retention Users active 30 days after signup / Total signups

15%

Checklist completion rate Users finishing all items / Users who saw checklist

50%

Funnel Analysis Template

Signup 100% ├── First login 85% (-15% never return) ├── Setup step 1 70% (-15% drop during setup) ├── Setup step 2 55% (-15% setup friction) ├── First value action 40% (-15% blank slate / confusion) ├── Activation event 30% (-10% incomplete value delivery) └── Day-7 return 20% (-10% no habit formed)

Focus optimization on the step with the largest absolute drop.

Experiment Framework

High-Impact Experiments

Experiment Hypothesis Metric

Reduce setup steps Fewer steps = higher completion Activation rate

Pre-populate with sample data Reduces blank slate anxiety Time to first value action

Add onboarding checklist Progress visibility increases completion Onboarding completion rate

Defer email verification Removes friction before value Time to activation

Personalize by role/goal Relevant path increases activation Activation rate by segment

Medium-Impact Experiments

Experiment Hypothesis Metric

Welcome video vs text Video may improve or hurt depending on product Activation rate + time on first screen

Checklist order change Value-first ordering improves completion Checklist completion rate

Guided tour vs self-discover Tours help complex products Feature adoption rate

In-app chat during onboarding Real-time help reduces stalls Stall rate, activation rate

Output Artifacts

Artifact Format Description

Activation Definition Doc Structured definition Aha moment, activation event, success metric, measurement plan

Onboarding Flow Diagram Step-by-step flow Post-signup flow with drop-off points and decision branches

Checklist Specification Item-by-item design 3-7 items with action, rationale, time estimate, and CTA

Email Trigger Map Trigger/timing/goal table Conditions and content for each onboarding email

Empty State Copy Per-screen design Illustration description, headline, body, CTA for each empty state

Experiment Backlog Prioritized table Test ideas ranked by expected impact and effort

Stalled User Playbook Decision tree Detection criteria, recovery tactics, escalation rules

Related Skills

  • signup-flow-cro -- Use for optimizing the registration flow before users enter the product. Onboarding-cro starts after signup is complete.

  • paywall-upgrade-cro -- Use when onboarding leads into upgrade moments. Do not show paywalls before the aha moment is reached.

  • churn-prevention -- Use when users activate but then churn. If they never activate, the problem is onboarding, not churn.

  • page-cro -- Use when the marketing page before signup is the bottleneck, not the post-signup experience.

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

General

product-designer

No summary provided by upstream source.

Repository SourceNeeds Review
2.2K-borghei
General

business-intelligence

No summary provided by upstream source.

Repository SourceNeeds Review
General

brand-strategist

No summary provided by upstream source.

Repository SourceNeeds Review
General

senior-mobile

No summary provided by upstream source.

Repository SourceNeeds Review