name	gamified-onboarding
description	Design high-conversion onboarding flows with gamification and dopamine engineering. Use when creating app onboarding, designing quiz flows, building paywalls, or needing psychological engagement patterns.

Gamified Onboarding

What's universal vs category-specific

This skill documents patterns at two levels:

Universal patterns (use for ANY app)

These psychological principles work across all categories:

Investment before ask - Users spend time before seeing price
Fear/hope contrast - Pain of inaction before pleasure of solution
Commitment ladder - Micro-yeses prime for macro-yes
Value stacking - Benefits > features, specific > vague
Price anchoring - Show expensive option first
Loading theater - Visible work = perceived value
Social proof - Numbers and testimonials everywhere

Gamification layer (optional, category-dependent)

RPG/gaming aesthetics work best for:

Fitness & self-improvement (strong fit)
Learning & skill-building (good fit)
Habit tracking (good fit)
Finance/savings goals (moderate fit)

Less appropriate for:

Productivity/business tools (too playful)
Health/medical apps (credibility concerns)
Professional services (tone mismatch)
Utility apps (over-engineered)

Quick start by app category

Fitness / Self-improvement

Full gamification works. Use all references including identity-patterns.md and stats-visualization.md.

Hook → Quiz → Value preview → Fear carousel → Stats comparison →
Commitment questions → Ritual → Paywall

Productivity / Business

Skip gamification. Focus on time/money saved, professional credibility.

Hook (pain point) → Quiz (workflow questions) → Value preview (time saved) →
Testimonials (professionals) → Commitment (ROI questions) → Paywall

Finance / Budgeting

Moderate gamification (progress bars yes, "ranks" no). Focus on concrete numbers.

Hook (financial goal) → Quiz (income/expenses) → Gap analysis →
Projection (with vs without) → Commitment → Paywall

Learning / Education

Light gamification (streaks, levels). Focus on skill gap and career outcomes.

Hook (skill aspiration) → Quiz (current level) → Gap analysis →
Learning path preview → Commitment → Paywall

Health / Wellness (non-fitness)

No gamification. Focus on science, calm, trust.

Hook (wellness goal) → Quiz (symptoms/history) → Personalized insights →
Gentle fear (consequences) → Expert credibility → Paywall

Dating / Social

No RPG gamification. Focus on belonging, success stories, FOMO.

Hook (connection desire) → Quiz (preferences) → Match preview →
Success stories → Scarcity (limited matches) → Paywall

Quick start workflow

Identify your category from the list above
Map your flow phases using references/flow-phases.md - adapt intensity to category
Design personalization using references/quiz-patterns.md - questions should feel valuable
Add emotional contrast using references/fear-hope-sandwich.md - adjust tone for category
Build commitment using references/commitment-ladder.md - questions vary by category
Design paywall using references/paywall-patterns.md - universal patterns apply

Core principles

Investment before ask - Users spend 10-15 minutes in quiz before seeing price.
Identity over features - "You're a Player now" beats "Track your workouts".
Specific over vague - "April 17, 2026" beats "in 90 days".
Loss over gain - Fear of what they'll lose converts better than promise of gain.
Ritual over click - Physical gestures (hold, swipe) create psychological commitment.
Social proof everywhere - Numbers, testimonials, ratings at every decision point.

Workflow for designing onboarding

Define the transformation promise (before state → after state).
List 8-15 personalization questions that feel valuable to answer.
Design the "gap" - show users where they are vs where they could be.
Create 3-5 fear screens showing consequences of inaction.
Transition to hope with a single "time for change" moment.
Add 3-4 commitment questions user can only say "yes" to.
Include a ritual moment (fingerprint, hold, swipe-to-commit).
Stack value with specific date, benefits list, social proof.
Present price with anchoring (monthly vs yearly, savings shown).

Key metrics to design for

Quiz completion rate - Should be >80% if questions feel personalized.
Fear carousel completion - Users should see all fear screens.
Commitment question "yes" rate - Should be >95% per question.
Paywall conversion - Industry benchmark 2-5%, gamified flows hit 8-15%.

Component references

Use references/ for specific patterns:

Reference	Use when
`flow-phases.md`	Structuring the overall onboarding sequence
`quiz-patterns.md`	Designing personalization questions
`fear-hope-sandwich.md`	Creating emotional contrast
`commitment-ladder.md`	Building micro-commitments before paywall
`paywall-patterns.md`	Designing the conversion screen
`identity-patterns.md`	Adding gamified language and status
`stats-visualization.md`	Showing progress with RPG-style UI
`loading-theater.md`	Creating perceived value through wait
`screen-templates.md`	ASCII templates for common screen types

Anti-patterns to avoid

Showing price before value demonstration.
Skipping the fear/pain section (hope alone doesn't convert).
Using generic fitness/productivity imagery (differentiated aesthetic IS the product).
Asking for payment without commitment ladder.
Long text explanations instead of visual contrast.
Forgetting the ritual moment before conversion.

name	gamified-onboarding
description	Design high-conversion onboarding flows with gamification and dopamine engineering. Use when creating app onboarding, designing quiz flows, building paywalls, or needing psychological engagement patterns.