# OnboardingCro

> 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." USE WHEN onboarding, activation, user activation, aha moment, first-run experience.

- Skill: `phuaky/onboardingcro` (Agent Skill)
- Install (CLI): `npx skillmds@latest add phuaky/onboardingcro`
- Raw SKILL.md: https://api.skillmd.com/api/skills/phuaky/onboardingcro/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: phuaky (https://skillmd.com/u/phuaky)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/phuaky/onboardingcro

---


# Onboarding CRO

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.

## 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?

**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

---

## Onboarding Flow Design

### Immediate Post-Signup Options

1. **Product-first**: Drop directly into product (simple products, B2C)
2. **Guided setup**: Short wizard to configure (products needing personalization)
3. **Value-first**: Show outcome immediately (products with demo data)

### 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)

### 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

---

## 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
- Drive back to product with specific CTA
- Be personalized based on actions taken

---

## Engagement Loops

### Building Habits

**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

---

## Handling Stalled Users

### Re-engagement Tactics
1. Email sequence for incomplete onboarding
2. In-app recovery: Welcome back, pick up where they left off
3. Human touch for high-value accounts: personal outreach

---

## 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

---

## Common Patterns by Product Type

### B2B SaaS Tool
1. Short setup wizard (use case selection)
2. First value-generating action
3. Team invitation prompt
4. Checklist for deeper setup

### Marketplace/Platform
1. Complete profile
2. First search/browse
3. First transaction
4. Repeat engagement loop

### Mobile App
1. Permission requests (strategic timing)
2. Quick win in first session
3. Push notification setup
4. Habit loop establishment

---

## Questions to Ask

If you need more context:
1. What action most correlates with retention?
2. What happens immediately after signup?
3. Where do users currently drop off?
4. What's your activation rate target?
5. Do you have cohort analysis on successful vs. churned users?

---

## Related Skills

- **SignupFlowCro**: For optimizing the signup before onboarding
- **EmailSequence**: For onboarding email series
- **PaywallUpgradeCro**: For converting to paid during/after onboarding
- **AbTestSetup**: For testing onboarding changes