Imported from appeeky/aso-skills (skills/onboarding-optimization/SKILL.md) via skills.sh. Install upstream with npx skills add appeeky/aso-skills --skill onboarding-optimization. Copyright stays with the author.

Onboarding Optimization

You optimize the first-run experience to maximize activation — the moment a new user completes the core action that predicts long-term retention.

The Activation Principle

Activation ≠ sign-up. Activation is the first time the user gets real value from your app. Identify it before anything else.

Rule: Everything in onboarding should funnel toward that one activation event as fast as possible.

Initial Assessment

1. Check for app-marketing-context.md
2. Ask: What is your activation event?
3. Ask: What % of new users reach it within 24 hours? (baseline)
4. Ask: Where do users drop off? (which step, if known)
5. Ask: How long does your current onboarding take? (steps, screens)
6. Ask: Do you have Firebase/Mixpanel funnels set up?

Onboarding Audit Framework

Step 1 — Map the Current Flow

List every screen from app open to activation:

App open → [Screen 1] → [Screen 2] → ... → Activation event

Flag each screen: Required | Value-adding | Friction only

Remove or defer everything that is friction-only.

Step 2 — Score Each Screen

Step 3 — Permission Prompt Timing

Permissions are the #1 drop-off point. Rules:

The pre-permission screen: Always show a native-looking explanation screen before the system prompt. Users who understand the "why" grant at 2–3× the rate.

Step 4 — Sign-Up Friction

Guest mode / try before sign-up: Allow users to experience the core value before requiring an account. Conversion from guest → registered is typically 40–60% vs. a hard gate at 15–30%.

Onboarding Patterns by App Type

Value-First (recommended for most apps)

Open → Core feature demo / interactive preview
     → Activation moment
     → "Save your progress" → Sign-up
     → Permission asks
     → Personalization

Personalization-First (works for health, fitness, AI apps)

Open → 3–5 personalization questions (show progress bar)
     → "Your plan is ready" reveal moment
     → Sign-up gate (invested now)
     → Activation

Social-First (social apps)

Open → Sign in with Apple/Google (single tap)
     → Find friends / follow suggestions
     → First feed with content
     → Activation (post, comment, react)

Funnel Benchmarks

Personalization Questions

If you include personalization, follow these rules:

• Maximum 3–5 questions in onboarding
• Each question must visibly affect the experience
• Show a progress indicator (step 1 of 3)
• Use visual selections, not text inputs
• Never ask for data you won't use immediately

Paywall Placement in Onboarding

Rule: Show value before the paywall.

See monetization-strategy for paywall design details.

Output Format

Onboarding Audit

Current flow:
  [Screen 1] — Required / friction
  [Screen 2] — Value-adding
  [Screen 3] — Required / friction
  ...
  [Activation event] — Step N

Drop-off analysis:
  Biggest drop: [screen] ([X]% exit rate if known)
  Estimated cause: [hypothesis]

Recommended changes:
1. [Remove / defer X] — Expected impact: [lift in activation]
2. [Reorder Y before Z] — Expected impact: [rationale]
3. [Add pre-permission screen for Z] — Expected impact: [grant rate improvement]

Revised flow:
  Open → [Screen] → [Screen] → Activation → Sign-up → Permissions
  Estimated steps removed: [N]
  Estimated time to activation: [Xs → Xs]

Permission Screen Copy Template

[Icon representing the permission]

[Benefit headline — what the user gets]
e.g., "Get notified when your goal is complete"

[One-line explanation]
e.g., "We'll only send you reminders you set — no spam."

[Allow button]     [Not now]

Related Skills

• retention-optimization — Day 7/30 retention strategy
• monetization-strategy — Paywall placement and trial design
• ab-test-store-listing — Test onboarding variants
• app-analytics — Set up activation funnel tracking
• rating-prompt-strategy — When to ask for a rating post-activation