onboarding-flow-optimizer
Mission : Optimize the onboarding experience to reduce time-to-value, increase activation rates, and improve early retention (D1-D7). Design clear paths to the "aha moment" through checklists, product tours, educational content, and personalized onboarding flows.
STEP 0: Pre-Generation Verification
Before generating the HTML output, verify all required data is collected:
Header & Score Banner
Executive Summary
Funnel Analysis
Onboarding Checklist
Product Tour
Educational Content
Personalized Paths
Email Sequence
A/B Tests
Charts
Roadmap
STEP 1: Detect Previous Context
Ideal Context (All Present):
metrics-dashboard-designer → Activation metrics, D1/D7 retention, time-to-activate
customer-persona-builder → User segments, goals, pain points, skill levels
product-positioning-expert → Value proposition, key features, success indicators
retention-optimization-expert → Early churn data, D1-D7 retention by cohort
Partial Context (Some Present):
metrics-dashboard-designer → Activation metrics available
customer-persona-builder → User segmentation available
product-positioning-expert → Value proposition available
No Context:
None of the above skills were run
STEP 2: Context-Adaptive Introduction
If Ideal Context:
I found outputs from metrics-dashboard-designer , customer-persona-builder , product-positioning-expert , and retention-optimization-expert .
I can reuse:
Activation metrics (current activation rate: [X%], time-to-activate: [Y hours])
User segments (Segment A, Segment B with different onboarding needs)
Value proposition (core value: [X], key features: [Y, Z])
Early retention data (D1 retention: [X%], D7 retention: [Y%])
Proceed with this data? [Yes/Start Fresh]
If Partial Context:
I found outputs from some upstream skills: [list which ones].
I can reuse: [list specific data available]
Proceed with this data, or start fresh?
If No Context:
No previous context detected.
I'll guide you through optimizing your onboarding flow from the ground up.
STEP 3: Questions (One at a Time, Sequential)
Activation Definition & Current Performance
Question AD1: How do you define user activation?
Activation = "Aha Moment" (the moment a user experiences the core value of your product)
Examples :
Slack : "Send 2,000 team messages"
Dropbox : "Upload and share first file"
Facebook : "Add 7 friends in 10 days"
Canva : "Create and download first design"
Notion : "Create first page and add content"
Airbnb : "Complete first booking"
Your Activation Event : [e.g., "Create first project with 3+ tasks and invite 1 team member"]
Why this event? : [What value does the user experience at this moment?]
Alternative Metrics (if no single activation event):
☐ Feature Breadth : Used X out of Y core features
☐ Feature Depth : Used core feature X times
☐ Value Milestone : Achieved measurable result (e.g., "Sent first invoice", "Published first blog post")
Question AD2: What is your current activation performance?
Activation Metrics :
Activation Rate : [e.g., "42% of signups complete activation within 7 days"]
Time to Activate : [e.g., "Median time: 12 hours from signup"]
Activation by Cohort : [e.g., "January: 38%, February: 42%, March: 45%" — improving?]
Activation by Segment :
Activation Funnel (signup → onboarding steps → activation):
Step
Users
Conversion
Drop-off
1. Signup completed
1,000
100%
—
2. Email verified
850
85%
15%
3. Profile completed
680
68%
17%
4. First action taken
510
51%
17%
5. Activated (aha moment)
420
42%
9%
Where is the biggest drop-off? : [Which step?]
Industry Benchmarks (for context):
B2B SaaS : Activation rate 30-50%
Consumer Apps : Activation rate 20-40%
Productivity Tools : Activation rate 40-60%
Your Performance vs. Benchmark :
Current Activation Rate: [X%]
Benchmark: [Y%]
Gap: [Z percentage points]
Target Activation Rate : [e.g., "60% within 90 days"]
Onboarding Friction Analysis
Question FA1: Where do users get stuck during onboarding?
Drop-off Point Analysis (from funnel above):
Step
Drop-off
Why are users dropping off?
How to fix?
Signup → Email Verified
15%
[e.g., "Didn't receive email, went to spam"]
[e.g., "Improve email deliverability"]
Email → Profile Complete
17%
[e.g., "Too many fields, friction"]
[e.g., "Reduce required fields to 3"]
Profile → First Action
17%
[e.g., "Don't know what to do next"]
[e.g., "Add onboarding checklist"]
First Action → Activated
9%
[e.g., "Core feature too complicated"]
[e.g., "Add interactive product tour"]
Top 3 Friction Points :
[Friction Point 1] — [Impact: X% drop-off] — [Solution]
[Friction Point 2] — [Impact: X% drop-off] — [Solution]
[Friction Point 3] — [Impact: X% drop-off] — [Solution]
Question FA2: How long does it take users to activate?
Time-to-Activate Distribution :
<1 hour : [X%] (fast activators — ideal)
1-24 hours : [X%] (same-day activators)
1-7 days : [X%] (slow activators)
7+ days : [X%] (very slow, likely won't activate)
Median Time-to-Activate : [e.g., "12 hours"]
Target Time-to-Activate : [e.g., "<1 hour for 50% of users"]
What delays activation? :
☐ Waiting for team members to join
☐ Waiting for data import to complete
☐ Learning curve (too complicated, need tutorials)
☐ Missing information (need to gather data before using product)
☐ Technical issues (bugs, slow load times)
☐ Other: [specify]
How to reduce time-to-activate :
[Action 1] — e.g., "Allow users to skip team invites and activate solo first"
[Action 2] — e.g., "Provide sample data so users can explore without importing"
[Action 3] — e.g., "Add quick-start video (2 minutes) to speed learning"
Onboarding Checklist Design
Question OC1: What is your onboarding checklist?
Onboarding Checklist = A clear, step-by-step guide to activation
Best Practices :
3-5 steps (not 10+)
Specific, actionable ("Create your first project", not "Explore features")
Trackable progress (show "2 of 4 completed")
Celebration on completion (confetti, badge, email)
Your Onboarding Checklist :
✅ Step 1 : [e.g., "Complete your profile (name, company, role)"]
Why it matters: [e.g., "Personalizes your experience"]
Time to complete: [e.g., "30 seconds"]
✅ Step 2 : [e.g., "Create your first project"]
Why it matters: [e.g., "This is where you'll organize your work"]
Time to complete: [e.g., "1 minute"]
✅ Step 3 : [e.g., "Add 3 tasks to your project"]
Why it matters: [e.g., "Experience how easy task management is"]
Time to complete: [e.g., "2 minutes"]
✅ Step 4 : [e.g., "Invite 1 team member" or "Connect your calendar"]
Why it matters: [e.g., "Collaborate with your team" or "Sync your workflow"]
Time to complete: [e.g., "1 minute"]
✅ Step 5 : [e.g., "Mark your first task as complete"]
Why it matters: [e.g., "Feel the satisfaction of progress"]
Time to complete: [e.g., "10 seconds"]
Total Time to Complete Checklist : [e.g., "5 minutes"]
Completion = Activation? : [Yes/No — does completing checklist = activation event?]
Question OC2: How do you incentivize checklist completion?
Incentive Strategies :
Progress Bar (visual progress indicator)
"You're 60% done! Just 2 more steps"
Visual: ▓▓▓▓▓▓░░░░ (6/10 complete)
Gamification (points, badges, streaks)
"Complete onboarding to unlock power features"
"Earn your 'Getting Started' badge"
Social Proof (show what others did)
"95% of successful teams complete all 5 steps"
"Top users completed onboarding in under 5 minutes"
Reward on Completion (unlock feature, give credits, send swag)
"Complete onboarding to get 100 free credits"
"Finish setup and we'll mail you a T-shirt"
Email Nudges (reminder emails for incomplete steps)
Day 1: "You're 2 steps away from full setup"
Day 3: "Just 1 step left! Finish now"
Your Incentive Strategy (choose 2-3):
[Incentive 1] — e.g., "Progress bar with % complete"
[Incentive 2] — e.g., "Unlock power feature after completing checklist"
[Incentive 3] — e.g., "Email nudge on Day 1 and Day 3"
Product Tour Design
Question PT1: Do you need a product tour?
Product Tour = Interactive walkthrough that guides users through key features
When to use product tours :
☐ Your product is complex (many features, steep learning curve)
☐ First-time users don't know where to start
☐ Activation requires using specific features in sequence
☐ You have multiple user personas with different use cases
When NOT to use product tours :
☐ Your product is self-explanatory (e.g., Google search)
☐ Users are experienced (e.g., developers, power users)
☐ Tour would interrupt critical workflows
Do you need a product tour? : [Yes/No]
If Yes : [Type of tour — full tour, feature-specific tour, or persona-based tour]
Question PT2: What does your product tour cover?
Product Tour Structure (3-7 steps):
Step 1 : Welcome & Goal
Message: [e.g., "Welcome to [Product]! Let's get you set up in 2 minutes"]
Goal: [e.g., "By the end, you'll have created your first project"]
Step 2 : Core Feature 1
Highlight: [e.g., "Project Dashboard — this is your command center"]
Action: [e.g., "Click 'New Project' to get started"]
Tooltip: [e.g., "All your projects will appear here"]
Step 3 : Core Feature 2
Highlight: [e.g., "Task List — add tasks to your project"]
Action: [e.g., "Click 'Add Task' and type your first task"]
Tooltip: [e.g., "Tasks can be assigned, prioritized, and tracked"]
Step 4 : Core Feature 3
Highlight: [e.g., "Collaboration — invite your team"]
Action: [e.g., "Click 'Invite' and add your teammates"]
Tooltip: [e.g., "Everyone can see updates in real-time"]
Step 5 : Power Feature (optional)
Highlight: [e.g., "Automation — save time with smart rules"]
Action: [e.g., "Try creating your first automation"]
Tooltip: [e.g., "Auto-assign tasks, send reminders, and more"]
Step 6 : Completion & Next Steps
Message: [e.g., "You're all set! Now go create something amazing"]
CTA: [e.g., "Explore on your own" or "Start your first project"]
Tour Format :
☐ Tooltip Tour (tooltips appear over UI elements, user clicks through)
☐ Modal Tour (modal dialogs guide user step-by-step)
☐ Video Tour (2-minute video walkthrough)
☐ Interactive Demo (sandbox environment to practice without consequences)
Your Tour Format : [Choose 1-2]
Can users skip the tour? : [Yes/No — forced tour or optional?]
Best practice: Always allow skipping, but track skip rate (high skip rate = tour isn't valuable)
Educational Content & Help Resources
Question EC1: What educational content do you provide during onboarding?
Educational Content Types :
Tooltips (contextual help, appears on hover or click)
Example: "💡 Tip: Assign tasks to team members to track accountability"
When to show: First time user sees a feature
Empty States (helpful messages when there's no data yet)
Example: "No projects yet. Let's create your first one!"
CTA: [e.g., "Create Project" button]
Help Docs (knowledge base, FAQs, tutorials)
Organized by: Getting Started, Core Features, Advanced Features, Troubleshooting
Format: Text + screenshots, or video tutorials
Quick-Start Video (2-3 minute overview)
Shows: Core workflow from start to finish
Hosted: Embedded in app (YouTube, Vimeo, Loom)
Webinars / Live Onboarding Calls (for high-touch customers)
Frequency: [e.g., "Weekly live onboarding session, or 1-on-1 call for enterprise"]
Who leads: CSM, Product Specialist, or Founder
In-App Messages (contextual nudges at key moments)
Example: "Try adding a due date to your task to set a deadline"
Trigger: User creates task without due date
Your Educational Content (choose 3-5):
[Content Type 1] — e.g., "Tooltips for all core features"
[Content Type 2] — e.g., "Quick-start video (2 minutes)"
[Content Type 3] — e.g., "Help docs with screenshots"
[Content Type 4] — e.g., "Empty states with CTAs"
[Content Type 5] — e.g., "In-app messages for key moments"
Question EC2: How do you measure content effectiveness?
Content Performance Metrics :
Content Type
Metric
Current
Target
Product Tour
Completion rate (% who finish tour)
X%
>70%
Tooltips
Click-through rate (% who click "Learn more")
X%
>20%
Quick-Start Video
View rate (% of new users who watch)
X%
>40%
Quick-Start Video
Watch time (% of video watched)
X%
>60%
Help Docs
Search rate (% of users who search docs)
X%
>10%
Help Docs
Deflection rate (% who find answer)
X%
>70%
Webinar
Attendance rate (% who sign up and attend)
X%
>50%
Feedback Mechanisms :
☐ "Was this helpful?" (thumbs up/down) on help docs
☐ "Did this answer your question?" after tooltip
☐ CSAT survey after webinar
☐ NPS survey after completing onboarding
Personalized Onboarding Paths
Question PP1: Do different user segments need different onboarding experiences?
Personalization Triggers :
☐ By User Role : Marketer vs. Developer vs. Sales Rep
☐ By Company Size : Solo user vs. Small team vs. Enterprise
☐ By Use Case : Project Management vs. CRM vs. Content Planning
☐ By Experience Level : Beginner vs. Intermediate vs. Advanced
☐ By Acquisition Source : Organic vs. Paid vs. Referral
Do you need personalized onboarding? : [Yes/No]
If Yes : [How will you segment users? e.g., "Ask 'What's your role?' during signup"]
Question PP2: What are your personalized onboarding paths?
Onboarding Path 1 : [Segment Name — e.g., "Marketing Manager"]
Goal : [e.g., "Create first content calendar"]
Checklist :
[Step 1] — e.g., "Set up content pillars"
[Step 2] — e.g., "Add 5 content ideas"
[Step 3] — e.g., "Schedule first post"
Tour Focus : [e.g., "Content planning features, editorial calendar"]
Resources : [e.g., "Content Marketing 101 guide"]
Onboarding Path 2 : [Segment Name — e.g., "Software Developer"]
Goal : [e.g., "Integrate API and make first request"]
Checklist :
[Step 1] — e.g., "Generate API key"
[Step 2] — e.g., "Run sample code"
[Step 3] — e.g., "Make first API call"
Tour Focus : [e.g., "API docs, developer console"]
Resources : [e.g., "API reference docs, code samples"]
Onboarding Path 3 : [Segment Name — e.g., "Sales Rep"]
Goal : [e.g., "Add first contact and send outreach"]
Checklist :
[Step 1] — e.g., "Import contacts from CSV"
[Step 2] — e.g., "Create email template"
[Step 3] — e.g., "Send first outreach email"
Tour Focus : [e.g., "Contact management, email sequences"]
Resources : [e.g., "Sales email templates, best practices"]
How to personalize :
☐ Ask segmentation question during signup ("What's your role?")
☐ Auto-detect based on behavior (e.g., user clicks "Developer Docs" → developer path)
☐ Allow users to choose path ("I'm here to... [Manage Projects / Build Integrations / Track Sales]")
Email Onboarding Sequence
Question ES1: What is your email onboarding sequence?
Email Onboarding = Series of emails to guide users through activation
Email 1 (Day 0): Welcome + Quick Start
Subject : [e.g., "Welcome to [Product]! Let's get you started"]
Body :
Welcome message
Quick-start video (2 minutes)
Primary CTA: "Complete your setup" (link to onboarding checklist)
Support: "Reply to this email if you need help"
Email 2 (Day 1): Feature Highlight
Subject : [e.g., "How to [achieve goal] with [Product]"]
Body :
Highlight core feature (e.g., "Task management made easy")
Tutorial: Step-by-step guide with screenshots
Social proof: "10,000+ teams use this feature daily"
CTA: "Try it now"
Email 3 (Day 3): Success Story / Use Case
Subject : [e.g., "How [Customer Name] achieved [result] with [Product]"]
Body :
Customer success story (2-3 paragraphs)
Key takeaway: "You can achieve [result] too"
CTA: "Get started"
Email 4 (Day 5): Re-Engagement / Reminder
Subject : [e.g., "You're almost there! Just 2 steps left"]
Body :
Progress update: "You've completed 3 of 5 steps"
Reminder of incomplete steps
Incentive: "Finish setup to unlock [reward]"
CTA: "Complete setup"
Email 5 (Day 7): Support Offer
Subject : [e.g., "Need help getting started?"]
Body :
Offer help: "Our team is here to help you succeed"
Resources: Link to help docs, video tutorials, live chat
Optional: Book a 15-minute onboarding call
CTA: "Get help"
Email Cadence : [Day 0, Day 1, Day 3, Day 5, Day 7]
Trigger : [All users, or only users who haven't activated?]
A/B Testing Onboarding Variations
Question AB1: What will you A/B test in your onboarding?
A/B Test Ideas :
Checklist Length
Variant A : 3 steps (faster, but less guidance)
Variant B : 5 steps (more guidance, but longer)
Metric : Activation rate
Product Tour
Variant A : Forced tour (all users must complete)
Variant B : Optional tour (users can skip)
Metric : Activation rate, time-to-activate
Empty State CTAs
Variant A : "Create Project" button only
Variant B : "Create Project" + "Watch Tutorial" (two options)
Metric : CTA click-through rate, activation rate
Incentive
Variant A : No incentive
Variant B : "Complete setup to get 100 free credits"
Metric : Checklist completion rate, activation rate
Email Timing
Variant A : Email sequence (Day 0, 1, 3, 5, 7)
Variant B : Email sequence (Day 0, 2, 7)
Metric : Email open rate, activation rate
Your A/B Test Plan (choose 2-3 tests):
Test 1 : [What are you testing?] — Variant A vs. B — Metric: [X]
Test 2 : [What are you testing?] — Variant A vs. B — Metric: [X]
Test 3 : [What are you testing?] — Variant A vs. B — Metric: [X]
Testing Cadence : [How often will you run tests? e.g., "One test every 2 weeks"]
Implementation Roadmap
Question IR1: What is your 90-day onboarding optimization plan?
Phase 1: Foundation (Weeks 1-3)
Goal : Implement core onboarding elements
Deliverable : Onboarding checklist and email sequence live, activation tracking implemented
Phase 2: Educational Content (Weeks 4-6)
Goal : Add product tours, tooltips, and help resources
Deliverable : Product tour live, tooltips added, quick-start video published
Phase 3: Personalization & Optimization (Weeks 7-12)
Goal : Personalize onboarding paths and run A/B tests
Deliverable : Personalized onboarding live, 2 A/B tests completed, activation rate improved by [X%]
STEP 4: Generate Comprehensive Onboarding Optimization Strategy
You will now receive a comprehensive document covering :
Section 1: Executive Summary
Activation definition (aha moment: [X])
Current activation rate and target (X% → Y%)
Time-to-activate (current: [X], target: [Y])
Top 3 friction points and solutions
Section 2: Activation Funnel Analysis
Activation funnel (signup → email → profile → first action → activated)
Drop-off analysis (where users get stuck, why, how to fix)
Activation by segment (persona, acquisition source, cohort)
Industry benchmarks and performance gap
Section 3: Onboarding Checklist Design
3-5 step checklist with time estimates
Progress indicators and completion incentives
Gamification and social proof strategies
Email nudges for incomplete steps
Section 4: Product Tour Design
5-step product tour (welcome, core features, completion)
Tour format (tooltip, modal, video, interactive demo)
Skip option and tracking (completion rate, skip rate)
Section 5: Educational Content Strategy
Tooltips for core features
Empty states with CTAs
Quick-start video (2-3 minutes)
Help docs (Getting Started, FAQs, Troubleshooting)
In-app messages for key moments
Webinars / live onboarding (for high-touch customers)
Section 6: Personalized Onboarding Paths
Segmentation strategy (role, company size, use case, experience level)
2-3 persona-specific onboarding paths
Personalized checklists, tours, and resources
Section 7: Email Onboarding Sequence
5-email sequence (Day 0, 1, 3, 5, 7)
Email content (subject, body, CTA)
Triggers and segmentation (all users vs. non-activated users)
Section 8: A/B Testing Plan
3 A/B tests (checklist length, product tour, incentives)
Success metrics (activation rate, time-to-activate, completion rate)
Testing cadence (one test every 2 weeks)
Section 9: Implementation Roadmap
Phase 1 (Weeks 1-3) : Activation definition, onboarding checklist, email sequence
Phase 2 (Weeks 4-6) : Product tour, tooltips, help resources
Phase 3 (Weeks 7-12) : Personalization, A/B testing, continuous optimization
Section 10: Success Metrics
Activation Rate: [Baseline → Target — e.g., 42% → 60%]
Time-to-Activate: [Baseline → Target — e.g., 12 hours → <1 hour]
Checklist Completion Rate: [Target: >80%]
Product Tour Completion Rate: [Target: >70%]
D1 Retention: [Baseline → Target — e.g., 55% → 70%]
D7 Retention: [Baseline → Target — e.g., 40% → 55%]
Section 11: Next Steps
Launch onboarding checklist this week
Schedule weekly onboarding optimization meetings
Integrate with retention-optimization-expert (early retention data feeds churn analysis)
Integrate with customer-feedback-framework (gather onboarding feedback via surveys)
STEP 5: Quality Review & Iteration
After generating the strategy, I will ask:
Quality Check :
Is the activation definition clear and measurable?
Does the onboarding checklist reduce time-to-value?
Are drop-off points addressed with specific solutions?
Is the product tour helpful without being intrusive?
Are personalized onboarding paths feasible to build?
Are A/B tests designed to optimize activation rate?
Iterate? [Yes — refine X / No — finalize]
STEP 6: Save & Next Steps
Once finalized, I will:
Save the onboarding optimization strategy to your project folder
Suggest running customer-feedback-framework next (to gather feedback on onboarding)
Remind you to launch the onboarding checklist this week
8 Critical Guidelines for This Skill
Activation = Aha Moment : Define activation as the moment users experience core value, not arbitrary milestones (e.g., "Send 2,000 messages" > "Complete profile").
Reduce time-to-value : The faster users reach the aha moment, the better. Target <1 hour for 50% of users.
3-5 step checklist, not 10+ : Long checklists overwhelm users. Keep it short and actionable.
Product tours should be optional : Forced tours frustrate experienced users. Always allow skipping, but track skip rate.
Empty states are opportunities : Turn blank screens into onboarding moments (e.g., "No projects yet. Let's create your first one!").
Personalize for different segments : Marketers and developers need different onboarding experiences. Segment by role, use case, or experience level.
Measure everything : Track activation rate, time-to-activate, checklist completion rate, tour completion rate, drop-off points.
A/B test continuously : Run one test every 2 weeks to optimize activation rate. Small improvements compound.
Quality Checklist (Before Finalizing)
Activation definition is clear, measurable, and tied to core value
Current activation rate and target are defined (e.g., 42% → 60%)
Activation funnel shows drop-off points with solutions
Onboarding checklist is 3-5 steps with time estimates
Product tour is designed (5 steps, optional, tracked)
Educational content includes tooltips, empty states, quick-start video, help docs
Personalized onboarding paths are defined for 2-3 segments
Email onboarding sequence is 5 emails (Day 0, 1, 3, 5, 7)
A/B testing plan includes 3 tests with success metrics
Implementation roadmap is realistic (Weeks 1-3: Foundation, Weeks 4-6: Content, Weeks 7-12: Optimization)
Integration with Other Skills
Upstream Skills (reuse data from):
metrics-dashboard-designer → Activation metrics, D1/D7 retention, time-to-activate, activation funnel
customer-persona-builder → User segments, goals, pain points, skill levels (for personalized onboarding)
product-positioning-expert → Value proposition, key features, success indicators (for aha moment definition)
retention-optimization-expert → Early churn data, D1-D7 retention by cohort (to prioritize onboarding improvements)
Downstream Skills (use this data in):
retention-optimization-expert → Improved activation rates lead to better D1-D7 retention
customer-feedback-framework → Gather onboarding feedback via surveys (e.g., "How was your onboarding experience?")
metrics-dashboard-designer → Track activation metrics on product dashboard
email-marketing-architect → Email onboarding sequence integrates with lifecycle email campaigns
HTML Output Verification
After generating the HTML report, verify all elements render correctly:
Visual Verification Checklist
Data Quality Verification
Template Location
Skeleton template: html-templates/onboarding-flow-optimizer.html
Test output: skills/retention-metrics/onboarding-flow-optimizer/test-template-output.html
End of Skill
1 --- 2 name: onboarding-flow-optimizer 3 description: Optimize user onboarding to reduce time-to-value and increase activation rates. Design clear paths to the "aha moment" through checklists, product tours, educational content, and personalized flows. Generate actionable HTML reports with funnel analysis, email sequences, and A/B testing plans. 4 --- 5
6 # onboarding-flow-optimizer
7
8 **Mission**: Optimize the onboarding experience to reduce time-to-value, increase activation rates, and improve early retention (D1-D7). Design clear paths to the "aha moment" through checklists, product tours, educational content, and personalized onboarding flows.
9
10 ---
11
12 ## STEP 0: Pre-Generation Verification
13
14 Before generating the HTML output, verify all required data is collected:
15
16 ### Header & Score Banner
17 - [ ] `{{BUSINESS_NAME}}` - Company/product name
18 - [ ] `{{DATE}}` - Report generation date
19 - [ ] `{{ACTIVATION_RATE}}` - Current activation rate (e.g., "47%")
20 - [ ] `{{TARGET_RATE}}` - Target activation rate (e.g., "65%")
21 - [ ] `{{TIME_TO_ACTIVATE}}` - Median time to activate (e.g., "18h")
22 - [ ] `{{CHECKLIST_STEPS}}` - Number of onboarding steps (e.g., "5")
23 - [ ] `{{D7_RETENTION}}` - Day 7 retention rate (e.g., "52%")
24 - [ ] `{{AHA_MOMENT}}` - Short aha moment description (e.g., "First Task Completed")
25
26 ### Executive Summary
27 - [ ] `{{EXECUTIVE_SUMMARY}}` - 2-3 paragraph overview with key insights and interventions
28 - [ ] `{{ACTIVATION_EVENT}}` - Full activation event definition
29 - [ ] `{{ACTIVATION_DESCRIPTION}}` - Why this event represents the aha moment
30
31 ### Funnel Analysis
32 - [ ] `{{FUNNEL_STEPS}}` - 5+ funnel steps with users, conversion %, drop-off %
33 - Each step: step name, bar width, user count, drop-off percentage
34
35 ### Onboarding Checklist
36 - [ ] `{{CHECKLIST_STEPS}}` - 3-5 numbered steps
37 - Each step: title, reason (why it matters), time estimate
38
39 ### Product Tour
40 - [ ] `{{TOUR_STEPS}}` - 5-7 tour steps
41 - Each step: number, title, highlight message, user action
42
43 ### Educational Content
44 - [ ] `{{CONTENT_CARDS}}` - 5-6 content types
45 - Each card: icon, type label, description
46
47 ### Personalized Paths
48 - [ ] `{{PATH_CARDS}}` - 2-4 user segments
49 - Each path: segment name, goal, 3-4 checklist steps
50
51 ### Email Sequence
52 - [ ] `{{EMAIL_ITEMS}}` - 5 emails (Day 0, 1, 3, 5, 7)
53 - Each email: day label, subject line, body description
54
55 ### A/B Tests
56 - [ ] `{{AB_TEST_CARDS}}` - 3-4 A/B tests
57 - Each test: name, metric, variant A, variant B
58
59 ### Charts
60 - [ ] `{{FUNNEL_LABELS}}` - JSON array of funnel step names
61 - [ ] `{{FUNNEL_DATA}}` - JSON array of conversion percentages
62 - [ ] `{{TIME_LABELS}}` - JSON array of time buckets (e.g., "<1 hour", "1-24 hours")
63 - [ ] `{{TIME_DATA}}` - JSON array of user percentages per bucket
64 - [ ] `{{RETENTION_LABELS}}` - JSON array of retention days (D0, D1, D3, D7, etc.)
65 - [ ] `{{RETENTION_DATA}}` - JSON array of retention percentages
66 - [ ] `{{COHORT_LABELS}}` - JSON array of cohort names (months)
67 - [ ] `{{COHORT_DATA}}` - JSON array of activation rates per cohort
68
69 ### Roadmap
70 - [ ] `{{ROADMAP_PHASES}}` - 3 phases (Foundation, Education, Optimize)
71 - Each phase: name, timing, goal, 4-5 tasks
72
73 ---
74
75 ## STEP 1: Detect Previous Context
76
77 ### Ideal Context (All Present):
78 - **metrics-dashboard-designer** → Activation metrics, D1/D7 retention, time-to-activate
79 - **customer-persona-builder** → User segments, goals, pain points, skill levels
80 - **product-positioning-expert** → Value proposition, key features, success indicators
81 - **retention-optimization-expert** → Early churn data, D1-D7 retention by cohort
82
83 ### Partial Context (Some Present):
84 - **metrics-dashboard-designer** → Activation metrics available
85 - **customer-persona-builder** → User segmentation available
86 - **product-positioning-expert** → Value proposition available
87
88 ### No Context:
89 - None of the above skills were run
90
91 ---
92
93 ## STEP 2: Context-Adaptive Introduction
94
95 ### If Ideal Context:
96 > I found outputs from **metrics-dashboard-designer**, **customer-persona-builder**, **product-positioning-expert**, and **retention-optimization-expert**.
97 >
98 > I can reuse:
99 > - **Activation metrics** (current activation rate: [X%], time-to-activate: [Y hours])
100 > - **User segments** ([Segment A], [Segment B] with different onboarding needs)
101 > - **Value proposition** (core value: [X], key features: [Y, Z])
102 > - **Early retention data** (D1 retention: [X%], D7 retention: [Y%])
103 >
104 > **Proceed with this data?** [Yes/Start Fresh]
105
106 ### If Partial Context:
107 > I found outputs from some upstream skills: [list which ones].
108 >
109 > I can reuse: [list specific data available]
110 >
111 > **Proceed with this data, or start fresh?**
112
113 ### If No Context:
114 > No previous context detected.
115 >
116 > I'll guide you through optimizing your onboarding flow from the ground up.
117
118 ---
119
120 ## STEP 3: Questions (One at a Time, Sequential)
121
122 ### Activation Definition & Current Performance
123
124 **Question AD1: How do you define user activation?**
125
126 **Activation = "Aha Moment"** (the moment a user experiences the core value of your product)
127
128 **Examples**:
129 - **Slack**: "Send 2,000 team messages"
130 - **Dropbox**: "Upload and share first file"
131 - **Facebook**: "Add 7 friends in 10 days"
132 - **Canva**: "Create and download first design"
133 - **Notion**: "Create first page and add content"
134 - **Airbnb**: "Complete first booking"
135
136 **Your Activation Event**: [e.g., "Create first project with 3+ tasks and invite 1 team member"]
137
138 **Why this event?**: [What value does the user experience at this moment?]
139
140 **Alternative Metrics** (if no single activation event):
141 - ☐ **Feature Breadth**: Used X out of Y core features
142 - ☐ **Feature Depth**: Used core feature X times
143 - ☐ **Value Milestone**: Achieved measurable result (e.g., "Sent first invoice", "Published first blog post")
144
145 ---
146
147 **Question AD2: What is your current activation performance?**
148
149 **Activation Metrics**:
150 - **Activation Rate**: [e.g., "42% of signups complete activation within 7 days"]
151 - **Time to Activate**: [e.g., "Median time: 12 hours from signup"]
152 - **Activation by Cohort**: [e.g., "January: 38%, February: 42%, March: 45%" — improving?]
153 - **Activation by Segment**:
154 - [Segment A]: [X%]
155 - [Segment B]: [X%]
156 - [Segment C]: [X%]
157
158 **Activation Funnel** (signup → onboarding steps → activation):
159
160 | Step | Users | Conversion | Drop-off |
161 |-------------------------------|-------|------------|----------|
162 | 1. Signup completed | 1,000 | 100% | — |
163 | 2. Email verified | 850 | 85% | 15% |
164 | 3. Profile completed | 680 | 68% | 17% |
165 | 4. First action taken | 510 | 51% | 17% |
166 | 5. **Activated** (aha moment) | 420 | **42%** | 9% |
167
168 **Where is the biggest drop-off?**: [Which step?]
169
170 **Industry Benchmarks** (for context):
171 - **B2B SaaS**: Activation rate 30-50%
172 - **Consumer Apps**: Activation rate 20-40%
173 - **Productivity Tools**: Activation rate 40-60%
174
175 **Your Performance vs. Benchmark**:
176 - Current Activation Rate: [X%]
177 - Benchmark: [Y%]
178 - Gap: [Z percentage points]
179
180 **Target Activation Rate**: [e.g., "60% within 90 days"]
181
182 ---
183
184 ### Onboarding Friction Analysis
185
186 **Question FA1: Where do users get stuck during onboarding?**
187
188 **Drop-off Point Analysis** (from funnel above):
189
190 | Step | Drop-off | Why are users dropping off? | How to fix? |
191 |--------------------------|----------|------------------------------------------------------|----------------------------------------------|
192 | Signup → Email Verified | 15% | [e.g., "Didn't receive email, went to spam"] | [e.g., "Improve email deliverability"] |
193 | Email → Profile Complete | 17% | [e.g., "Too many fields, friction"] | [e.g., "Reduce required fields to 3"] |
194 | Profile → First Action | 17% | [e.g., "Don't know what to do next"] | [e.g., "Add onboarding checklist"] |
195 | First Action → Activated | 9% | [e.g., "Core feature too complicated"] | [e.g., "Add interactive product tour"] |
196
197 **Top 3 Friction Points**:
198 1. [Friction Point 1] — [Impact: X% drop-off] — [Solution]
199 2. [Friction Point 2] — [Impact: X% drop-off] — [Solution]
200 3. [Friction Point 3] — [Impact: X% drop-off] — [Solution]
201
202 ---
203
204 **Question FA2: How long does it take users to activate?**
205
206 **Time-to-Activate Distribution**:
207 - **<1 hour**: [X%] (fast activators — ideal)
208 - **1-24 hours**: [X%] (same-day activators)
209 - **1-7 days**: [X%] (slow activators)
210 - **7+ days**: [X%] (very slow, likely won't activate)
211
212 **Median Time-to-Activate**: [e.g., "12 hours"]
213 **Target Time-to-Activate**: [e.g., "<1 hour for 50% of users"]
214
215 **What delays activation?**:
216 - ☐ Waiting for team members to join
217 - ☐ Waiting for data import to complete
218 - ☐ Learning curve (too complicated, need tutorials)
219 - ☐ Missing information (need to gather data before using product)
220 - ☐ Technical issues (bugs, slow load times)
221 - ☐ Other: [specify]
222
223 **How to reduce time-to-activate**:
224 1. [Action 1] — e.g., "Allow users to skip team invites and activate solo first"
225 2. [Action 2] — e.g., "Provide sample data so users can explore without importing"
226 3. [Action 3] — e.g., "Add quick-start video (2 minutes) to speed learning"
227
228 ---
229
230 ### Onboarding Checklist Design
231
232 **Question OC1: What is your onboarding checklist?**
233
234 **Onboarding Checklist** = A clear, step-by-step guide to activation
235
236 **Best Practices**:
237 - **3-5 steps** (not 10+)
238 - **Specific, actionable** ("Create your first project", not "Explore features")
239 - **Trackable progress** (show "2 of 4 completed")
240 - **Celebration on completion** (confetti, badge, email)
241
242 **Your Onboarding Checklist**:
243
244 ✅ **Step 1**: [e.g., "Complete your profile (name, company, role)"]
245 - Why it matters: [e.g., "Personalizes your experience"]
246 - Time to complete: [e.g., "30 seconds"]
247
248 ✅ **Step 2**: [e.g., "Create your first project"]
249 - Why it matters: [e.g., "This is where you'll organize your work"]
250 - Time to complete: [e.g., "1 minute"]
251
252 ✅ **Step 3**: [e.g., "Add 3 tasks to your project"]
253 - Why it matters: [e.g., "Experience how easy task management is"]
254 - Time to complete: [e.g., "2 minutes"]
255
256 ✅ **Step 4**: [e.g., "Invite 1 team member" or "Connect your calendar"]
257 - Why it matters: [e.g., "Collaborate with your team" or "Sync your workflow"]
258 - Time to complete: [e.g., "1 minute"]
259
260 ✅ **Step 5**: [e.g., "Mark your first task as complete"]
261 - Why it matters: [e.g., "Feel the satisfaction of progress"]
262 - Time to complete: [e.g., "10 seconds"]
263
264 **Total Time to Complete Checklist**: [e.g., "5 minutes"]
265 **Completion = Activation?**: [Yes/No — does completing checklist = activation event?]
266
267 ---
268
269 **Question OC2: How do you incentivize checklist completion?**
270
271 **Incentive Strategies**:
272
273 1. **Progress Bar** (visual progress indicator)
274 - "You're 60% done! Just 2 more steps"
275 - Visual: ▓▓▓▓▓▓░░░░ (6/10 complete)
276
277 2. **Gamification** (points, badges, streaks)
278 - "Complete onboarding to unlock power features"
279 - "Earn your 'Getting Started' badge"
280
281 3. **Social Proof** (show what others did)
282 - "95% of successful teams complete all 5 steps"
283 - "Top users completed onboarding in under 5 minutes"
284
285 4. **Reward on Completion** (unlock feature, give credits, send swag)
286 - "Complete onboarding to get 100 free credits"
287 - "Finish setup and we'll mail you a T-shirt"
288
289 5. **Email Nudges** (reminder emails for incomplete steps)
290 - Day 1: "You're 2 steps away from full setup"
291 - Day 3: "Just 1 step left! Finish now"
292
293 **Your Incentive Strategy** (choose 2-3):
294 1. [Incentive 1] — e.g., "Progress bar with % complete"
295 2. [Incentive 2] — e.g., "Unlock power feature after completing checklist"
296 3. [Incentive 3] — e.g., "Email nudge on Day 1 and Day 3"
297
298 ---
299
300 ### Product Tour Design
301
302 **Question PT1: Do you need a product tour?**
303
304 **Product Tour** = Interactive walkthrough that guides users through key features
305
306 **When to use product tours**:
307 - ☐ Your product is complex (many features, steep learning curve)
308 - ☐ First-time users don't know where to start
309 - ☐ Activation requires using specific features in sequence
310 - ☐ You have multiple user personas with different use cases
311
312 **When NOT to use product tours**:
313 - ☐ Your product is self-explanatory (e.g., Google search)
314 - ☐ Users are experienced (e.g., developers, power users)
315 - ☐ Tour would interrupt critical workflows
316
317 **Do you need a product tour?**: [Yes/No]
318
319 **If Yes**: [Type of tour — full tour, feature-specific tour, or persona-based tour]
320
321 ---
322
323 **Question PT2: What does your product tour cover?**
324
325 **Product Tour Structure** (3-7 steps):
326
327 **Step 1**: **Welcome & Goal**
328 - Message: [e.g., "Welcome to [Product]! Let's get you set up in 2 minutes"]
329 - Goal: [e.g., "By the end, you'll have created your first project"]
330
331 **Step 2**: **Core Feature 1**
332 - Highlight: [e.g., "Project Dashboard — this is your command center"]
333 - Action: [e.g., "Click 'New Project' to get started"]
334 - Tooltip: [e.g., "All your projects will appear here"]
335
336 **Step 3**: **Core Feature 2**
337 - Highlight: [e.g., "Task List — add tasks to your project"]
338 - Action: [e.g., "Click 'Add Task' and type your first task"]
339 - Tooltip: [e.g., "Tasks can be assigned, prioritized, and tracked"]
340
341 **Step 4**: **Core Feature 3**
342 - Highlight: [e.g., "Collaboration — invite your team"]
343 - Action: [e.g., "Click 'Invite' and add your teammates"]
344 - Tooltip: [e.g., "Everyone can see updates in real-time"]
345
346 **Step 5**: **Power Feature** (optional)
347 - Highlight: [e.g., "Automation — save time with smart rules"]
348 - Action: [e.g., "Try creating your first automation"]
349 - Tooltip: [e.g., "Auto-assign tasks, send reminders, and more"]
350
351 **Step 6**: **Completion & Next Steps**
352 - Message: [e.g., "You're all set! Now go create something amazing"]
353 - CTA: [e.g., "Explore on your own" or "Start your first project"]
354
355 **Tour Format**:
356 - ☐ **Tooltip Tour** (tooltips appear over UI elements, user clicks through)
357 - ☐ **Modal Tour** (modal dialogs guide user step-by-step)
358 - ☐ **Video Tour** (2-minute video walkthrough)
359 - ☐ **Interactive Demo** (sandbox environment to practice without consequences)
360
361 **Your Tour Format**: [Choose 1-2]
362
363 **Can users skip the tour?**: [Yes/No — forced tour or optional?]
364 - Best practice: Always allow skipping, but track skip rate (high skip rate = tour isn't valuable)
365
366 ---
367
368 ### Educational Content & Help Resources
369
370 **Question EC1: What educational content do you provide during onboarding?**
371
372 **Educational Content Types**:
373
374 1. **Tooltips** (contextual help, appears on hover or click)
375 - Example: "💡 Tip: Assign tasks to team members to track accountability"
376 - When to show: First time user sees a feature
377
378 2. **Empty States** (helpful messages when there's no data yet)
379 - Example: "No projects yet. Let's create your first one!"
380 - CTA: [e.g., "Create Project" button]
381
382 3. **Help Docs** (knowledge base, FAQs, tutorials)
383 - Organized by: Getting Started, Core Features, Advanced Features, Troubleshooting
384 - Format: Text + screenshots, or video tutorials
385
386 4. **Quick-Start Video** (2-3 minute overview)
387 - Shows: Core workflow from start to finish
388 - Hosted: Embedded in app (YouTube, Vimeo, Loom)
389
390 5. **Webinars / Live Onboarding Calls** (for high-touch customers)
391 - Frequency: [e.g., "Weekly live onboarding session, or 1-on-1 call for enterprise"]
392 - Who leads: CSM, Product Specialist, or Founder
393
394 6. **In-App Messages** (contextual nudges at key moments)
395 - Example: "Try adding a due date to your task to set a deadline"
396 - Trigger: User creates task without due date
397
398 **Your Educational Content** (choose 3-5):
399 1. [Content Type 1] — e.g., "Tooltips for all core features"
400 2. [Content Type 2] — e.g., "Quick-start video (2 minutes)"
401 3. [Content Type 3] — e.g., "Help docs with screenshots"
402 4. [Content Type 4] — e.g., "Empty states with CTAs"
403 5. [Content Type 5] — e.g., "In-app messages for key moments"
404
405 ---
406
407 **Question EC2: How do you measure content effectiveness?**
408
409 **Content Performance Metrics**:
410
411 | Content Type | Metric | Current | Target |
412 |---------------------------|---------------------------------------------|---------|--------|
413 | Product Tour | Completion rate (% who finish tour) | X% | >70% |
414 | Tooltips | Click-through rate (% who click "Learn more")| X% | >20% |
415 | Quick-Start Video | View rate (% of new users who watch) | X% | >40% |
416 | Quick-Start Video | Watch time (% of video watched) | X% | >60% |
417 | Help Docs | Search rate (% of users who search docs) | X% | >10% |
418 | Help Docs | Deflection rate (% who find answer) | X% | >70% |
419 | Webinar | Attendance rate (% who sign up and attend) | X% | >50% |
420
421 **Feedback Mechanisms**:
422 - ☐ "Was this helpful?" (thumbs up/down) on help docs
423 - ☐ "Did this answer your question?" after tooltip
424 - ☐ CSAT survey after webinar
425 - ☐ NPS survey after completing onboarding
426
427 ---
428
429 ### Personalized Onboarding Paths
430
431 **Question PP1: Do different user segments need different onboarding experiences?**
432
433 **Personalization Triggers**:
434 - ☐ **By User Role**: Marketer vs. Developer vs. Sales Rep
435 - ☐ **By Company Size**: Solo user vs. Small team vs. Enterprise
436 - ☐ **By Use Case**: Project Management vs. CRM vs. Content Planning
437 - ☐ **By Experience Level**: Beginner vs. Intermediate vs. Advanced
438 - ☐ **By Acquisition Source**: Organic vs. Paid vs. Referral
439
440 **Do you need personalized onboarding?**: [Yes/No]
441
442 **If Yes**: [How will you segment users? e.g., "Ask 'What's your role?' during signup"]
443
444 ---
445
446 **Question PP2: What are your personalized onboarding paths?**
447
448 **Onboarding Path 1**: [Segment Name — e.g., "Marketing Manager"]
449 - **Goal**: [e.g., "Create first content calendar"]
450 - **Checklist**:
451 1. [Step 1] — e.g., "Set up content pillars"
452 2. [Step 2] — e.g., "Add 5 content ideas"
453 3. [Step 3] — e.g., "Schedule first post"
454 - **Tour Focus**: [e.g., "Content planning features, editorial calendar"]
455 - **Resources**: [e.g., "Content Marketing 101 guide"]
456
457 **Onboarding Path 2**: [Segment Name — e.g., "Software Developer"]
458 - **Goal**: [e.g., "Integrate API and make first request"]
459 - **Checklist**:
460 1. [Step 1] — e.g., "Generate API key"
461 2. [Step 2] — e.g., "Run sample code"
462 3. [Step 3] — e.g., "Make first API call"
463 - **Tour Focus**: [e.g., "API docs, developer console"]
464 - **Resources**: [e.g., "API reference docs, code samples"]
465
466 **Onboarding Path 3**: [Segment Name — e.g., "Sales Rep"]
467 - **Goal**: [e.g., "Add first contact and send outreach"]
468 - **Checklist**:
469 1. [Step 1] — e.g., "Import contacts from CSV"
470 2. [Step 2] — e.g., "Create email template"
471 3. [Step 3] — e.g., "Send first outreach email"
472 - **Tour Focus**: [e.g., "Contact management, email sequences"]
473 - **Resources**: [e.g., "Sales email templates, best practices"]
474
475 **How to personalize**:
476 - ☐ Ask segmentation question during signup ("What's your role?")
477 - ☐ Auto-detect based on behavior (e.g., user clicks "Developer Docs" → developer path)
478 - ☐ Allow users to choose path ("I'm here to... [Manage Projects / Build Integrations / Track Sales]")
479
480 ---
481
482 ### Email Onboarding Sequence
483
484 **Question ES1: What is your email onboarding sequence?**
485
486 **Email Onboarding** = Series of emails to guide users through activation
487
488 **Email 1 (Day 0): Welcome + Quick Start**
489 - **Subject**: [e.g., "Welcome to [Product]! Let's get you started"]
490 - **Body**:
491 - Welcome message
492 - Quick-start video (2 minutes)
493 - Primary CTA: "Complete your setup" (link to onboarding checklist)
494 - Support: "Reply to this email if you need help"
495
496 **Email 2 (Day 1): Feature Highlight**
497 - **Subject**: [e.g., "How to [achieve goal] with [Product]"]
498 - **Body**:
499 - Highlight core feature (e.g., "Task management made easy")
500 - Tutorial: Step-by-step guide with screenshots
501 - Social proof: "10,000+ teams use this feature daily"
502 - CTA: "Try it now"
503
504 **Email 3 (Day 3): Success Story / Use Case**
505 - **Subject**: [e.g., "How [Customer Name] achieved [result] with [Product]"]
506 - **Body**:
507 - Customer success story (2-3 paragraphs)
508 - Key takeaway: "You can achieve [result] too"
509 - CTA: "Get started"
510
511 **Email 4 (Day 5): Re-Engagement / Reminder**
512 - **Subject**: [e.g., "You're almost there! Just 2 steps left"]
513 - **Body**:
514 - Progress update: "You've completed 3 of 5 steps"
515 - Reminder of incomplete steps
516 - Incentive: "Finish setup to unlock [reward]"
517 - CTA: "Complete setup"
518
519 **Email 5 (Day 7): Support Offer**
520 - **Subject**: [e.g., "Need help getting started?"]
521 - **Body**:
522 - Offer help: "Our team is here to help you succeed"
523 - Resources: Link to help docs, video tutorials, live chat
524 - Optional: Book a 15-minute onboarding call
525 - CTA: "Get help"
526
527 **Email Cadence**: [Day 0, Day 1, Day 3, Day 5, Day 7]
528 **Trigger**: [All users, or only users who haven't activated?]
529
530 ---
531
532 ### A/B Testing Onboarding Variations
533
534 **Question AB1: What will you A/B test in your onboarding?**
535
536 **A/B Test Ideas**:
537
538 1. **Checklist Length**
539 - **Variant A**: 3 steps (faster, but less guidance)
540 - **Variant B**: 5 steps (more guidance, but longer)
541 - **Metric**: Activation rate
542
543 2. **Product Tour**
544 - **Variant A**: Forced tour (all users must complete)
545 - **Variant B**: Optional tour (users can skip)
546 - **Metric**: Activation rate, time-to-activate
547
548 3. **Empty State CTAs**
549 - **Variant A**: "Create Project" button only
550 - **Variant B**: "Create Project" + "Watch Tutorial" (two options)
551 - **Metric**: CTA click-through rate, activation rate
552
553 4. **Incentive**
554 - **Variant A**: No incentive
555 - **Variant B**: "Complete setup to get 100 free credits"
556 - **Metric**: Checklist completion rate, activation rate
557
558 5. **Email Timing**
559 - **Variant A**: Email sequence (Day 0, 1, 3, 5, 7)
560 - **Variant B**: Email sequence (Day 0, 2, 7)
561 - **Metric**: Email open rate, activation rate
562
563 **Your A/B Test Plan** (choose 2-3 tests):
564 1. **Test 1**: [What are you testing?] — Variant A vs. B — Metric: [X]
565 2. **Test 2**: [What are you testing?] — Variant A vs. B — Metric: [X]
566 3. **Test 3**: [What are you testing?] — Variant A vs. B — Metric: [X]
567
568 **Testing Cadence**: [How often will you run tests? e.g., "One test every 2 weeks"]
569
570 ---
571
572 ### Implementation Roadmap
573
574 **Question IR1: What is your 90-day onboarding optimization plan?**
575
576 ### Phase 1: Foundation (Weeks 1-3)
577 **Goal**: Implement core onboarding elements
578
579 - **Week 1: Activation Definition**
580 - Define activation event (aha moment)
581 - Set up activation tracking (Mixpanel, Amplitude, or custom event)
582 - Pull baseline activation metrics (current rate, time-to-activate, funnel)
583
584 - **Week 2: Onboarding Checklist**
585 - Design 3-5 step checklist
586 - Build checklist UI (progress bar, checkmarks)
587 - Deploy checklist to 100% of new users
588
589 - **Week 3: Email Onboarding**
590 - Write 5-email onboarding sequence
591 - Set up automated triggers (email service provider)
592 - Launch email sequence for new signups
593
594 **Deliverable**: Onboarding checklist and email sequence live, activation tracking implemented
595
596 ---
597
598 ### Phase 2: Educational Content (Weeks 4-6)
599 **Goal**: Add product tours, tooltips, and help resources
600
601 - **Week 4: Product Tour**
602 - Script 5-step product tour
603 - Build tour using tool (Appcues, Pendo, Intercom, or custom)
604 - Launch tour to 50% of new users (A/B test)
605
606 - **Week 5: Tooltips & Empty States**
607 - Identify top 10 features needing tooltips
608 - Write tooltip copy
609 - Design empty states with CTAs (e.g., "No projects yet. Let's create your first one!")
610
611 - **Week 6: Help Resources**
612 - Create quick-start video (2-3 minutes)
613 - Write 10-15 help docs (Getting Started section)
614 - Add in-app help widget (link to docs, video, live chat)
615
616 **Deliverable**: Product tour live, tooltips added, quick-start video published
617
618 ---
619
620 ### Phase 3: Personalization & Optimization (Weeks 7-12)
621 **Goal**: Personalize onboarding paths and run A/B tests
622
623 - **Week 7-8: Personalized Onboarding Paths**
624 - Add segmentation question during signup ("What's your role?")
625 - Build 2-3 persona-specific onboarding paths
626 - Deploy personalized checklists and tours
627
628 - **Week 9-10: A/B Testing**
629 - Run A/B test #1 (e.g., 3-step checklist vs. 5-step checklist)
630 - Analyze results after 2 weeks (1,000+ users per variant)
631 - Implement winning variant
632
633 - **Week 11-12: Continuous Optimization**
634 - Analyze friction points (where users drop off)
635 - Iterate on checklist, tour, emails based on data
636 - Run A/B test #2 (e.g., forced tour vs. optional tour)
637
638 **Deliverable**: Personalized onboarding live, 2 A/B tests completed, activation rate improved by [X%]
639
640 ---
641
642 ## STEP 4: Generate Comprehensive Onboarding Optimization Strategy
643
644 **You will now receive a comprehensive document covering**:
645
646 ### Section 1: Executive Summary
647 - Activation definition (aha moment: [X])
648 - Current activation rate and target (X% → Y%)
649 - Time-to-activate (current: [X], target: [Y])
650 - Top 3 friction points and solutions
651
652 ### Section 2: Activation Funnel Analysis
653 - Activation funnel (signup → email → profile → first action → activated)
654 - Drop-off analysis (where users get stuck, why, how to fix)
655 - Activation by segment (persona, acquisition source, cohort)
656 - Industry benchmarks and performance gap
657
658 ### Section 3: Onboarding Checklist Design
659 - 3-5 step checklist with time estimates
660 - Progress indicators and completion incentives
661 - Gamification and social proof strategies
662 - Email nudges for incomplete steps
663
664 ### Section 4: Product Tour Design
665 - 5-step product tour (welcome, core features, completion)
666 - Tour format (tooltip, modal, video, interactive demo)
667 - Skip option and tracking (completion rate, skip rate)
668
669 ### Section 5: Educational Content Strategy
670 - Tooltips for core features
671 - Empty states with CTAs
672 - Quick-start video (2-3 minutes)
673 - Help docs (Getting Started, FAQs, Troubleshooting)
674 - In-app messages for key moments
675 - Webinars / live onboarding (for high-touch customers)
676
677 ### Section 6: Personalized Onboarding Paths
678 - Segmentation strategy (role, company size, use case, experience level)
679 - 2-3 persona-specific onboarding paths
680 - Personalized checklists, tours, and resources
681
682 ### Section 7: Email Onboarding Sequence
683 - 5-email sequence (Day 0, 1, 3, 5, 7)
684 - Email content (subject, body, CTA)
685 - Triggers and segmentation (all users vs. non-activated users)
686
687 ### Section 8: A/B Testing Plan
688 - 3 A/B tests (checklist length, product tour, incentives)
689 - Success metrics (activation rate, time-to-activate, completion rate)
690 - Testing cadence (one test every 2 weeks)
691
692 ### Section 9: Implementation Roadmap
693 - **Phase 1 (Weeks 1-3)**: Activation definition, onboarding checklist, email sequence
694 - **Phase 2 (Weeks 4-6)**: Product tour, tooltips, help resources
695 - **Phase 3 (Weeks 7-12)**: Personalization, A/B testing, continuous optimization
696
697 ### Section 10: Success Metrics
698 - Activation Rate: [Baseline → Target — e.g., 42% → 60%]
699 - Time-to-Activate: [Baseline → Target — e.g., 12 hours → <1 hour]
700 - Checklist Completion Rate: [Target: >80%]
701 - Product Tour Completion Rate: [Target: >70%]
702 - D1 Retention: [Baseline → Target — e.g., 55% → 70%]
703 - D7 Retention: [Baseline → Target — e.g., 40% → 55%]
704
705 ### Section 11: Next Steps
706 - Launch onboarding checklist this week
707 - Schedule weekly onboarding optimization meetings
708 - Integrate with **retention-optimization-expert** (early retention data feeds churn analysis)
709 - Integrate with **customer-feedback-framework** (gather onboarding feedback via surveys)
710
711 ---
712
713 ## STEP 5: Quality Review & Iteration
714
715 After generating the strategy, I will ask:
716
717 **Quality Check**:
718 1. Is the activation definition clear and measurable?
719 2. Does the onboarding checklist reduce time-to-value?
720 3. Are drop-off points addressed with specific solutions?
721 4. Is the product tour helpful without being intrusive?
722 5. Are personalized onboarding paths feasible to build?
723 6. Are A/B tests designed to optimize activation rate?
724
725 **Iterate?** [Yes — refine X / No — finalize]
726
727 ---
728
729 ## STEP 6: Save & Next Steps
730
731 Once finalized, I will:
732 1. **Save** the onboarding optimization strategy to your project folder
733 2. **Suggest** running **customer-feedback-framework** next (to gather feedback on onboarding)
734 3. **Remind** you to launch the onboarding checklist this week
735
736 ---
737
738 ## 8 Critical Guidelines for This Skill
739
740 1. **Activation = Aha Moment**: Define activation as the moment users experience core value, not arbitrary milestones (e.g., "Send 2,000 messages" > "Complete profile").
741
742 2. **Reduce time-to-value**: The faster users reach the aha moment, the better. Target <1 hour for 50% of users.
743
744 3. **3-5 step checklist, not 10+**: Long checklists overwhelm users. Keep it short and actionable.
745
746 4. **Product tours should be optional**: Forced tours frustrate experienced users. Always allow skipping, but track skip rate.
747
748 5. **Empty states are opportunities**: Turn blank screens into onboarding moments (e.g., "No projects yet. Let's create your first one!").
749
750 6. **Personalize for different segments**: Marketers and developers need different onboarding experiences. Segment by role, use case, or experience level.
751
752 7. **Measure everything**: Track activation rate, time-to-activate, checklist completion rate, tour completion rate, drop-off points.
753
754 8. **A/B test continuously**: Run one test every 2 weeks to optimize activation rate. Small improvements compound.
755
756 ---
757
758 ## Quality Checklist (Before Finalizing)
759
760 - [ ] Activation definition is clear, measurable, and tied to core value
761 - [ ] Current activation rate and target are defined (e.g., 42% → 60%)
762 - [ ] Activation funnel shows drop-off points with solutions
763 - [ ] Onboarding checklist is 3-5 steps with time estimates
764 - [ ] Product tour is designed (5 steps, optional, tracked)
765 - [ ] Educational content includes tooltips, empty states, quick-start video, help docs
766 - [ ] Personalized onboarding paths are defined for 2-3 segments
767 - [ ] Email onboarding sequence is 5 emails (Day 0, 1, 3, 5, 7)
768 - [ ] A/B testing plan includes 3 tests with success metrics
769 - [ ] Implementation roadmap is realistic (Weeks 1-3: Foundation, Weeks 4-6: Content, Weeks 7-12: Optimization)
770
771 ---
772
773 ## Integration with Other Skills
774
775 **Upstream Skills** (reuse data from):
776 - **metrics-dashboard-designer** → Activation metrics, D1/D7 retention, time-to-activate, activation funnel
777 - **customer-persona-builder** → User segments, goals, pain points, skill levels (for personalized onboarding)
778 - **product-positioning-expert** → Value proposition, key features, success indicators (for aha moment definition)
779 - **retention-optimization-expert** → Early churn data, D1-D7 retention by cohort (to prioritize onboarding improvements)
780
781 **Downstream Skills** (use this data in):
782 - **retention-optimization-expert** → Improved activation rates lead to better D1-D7 retention
783 - **customer-feedback-framework** → Gather onboarding feedback via surveys (e.g., "How was your onboarding experience?")
784 - **metrics-dashboard-designer** → Track activation metrics on product dashboard
785 - **email-marketing-architect** → Email onboarding sequence integrates with lifecycle email campaigns
786
787 ---
788
789 ## HTML Output Verification
790
791 After generating the HTML report, verify all elements render correctly:
792
793 ### Visual Verification Checklist
794 - [ ] Header displays business name and date correctly
795 - [ ] Score banner shows activation rate, target, time-to-activate, checklist steps, D7 retention
796 - [ ] Aha moment verdict box displays correctly
797 - [ ] Activation event container has proper border and centered text
798 - [ ] Funnel steps show progress bars with correct widths and drop-off percentages
799 - [ ] Checklist steps are numbered with circular badges
800 - [ ] Product tour grid shows 5-7 step cards
801 - [ ] Educational content cards display icons and descriptions
802 - [ ] Personalized paths show segment names with numbered step lists
803 - [ ] Email timeline has connected dots and day labels
804 - [ ] A/B test cards show variant comparisons
805 - [ ] All 4 charts render with correct data:
806 - Funnel chart (horizontal bar)
807 - Time distribution chart (doughnut)
808 - Retention curve (line with fill)
809 - Cohort activation chart (vertical bar)
810 - [ ] Roadmap phases display 3 cards with tasks
811 - [ ] Footer shows StratArts branding
812
813 ### Data Quality Verification
814 - [ ] Activation rate is realistic (typically 30-60% for B2B SaaS)
815 - [ ] Funnel shows progressive drop-off (each step lower than previous)
816 - [ ] Time-to-activate aligns with product complexity
817 - [ ] Retention curve shows expected decay pattern
818 - [ ] Cohort data shows trend over 3-4 months
819 - [ ] Checklist steps are achievable in 5-10 minutes total
820 - [ ] Email sequence follows Day 0, 1, 3, 5, 7 pattern
821 - [ ] A/B tests have measurable success metrics
822
823 ### Template Location
824 - Skeleton template: `html-templates/onboarding-flow-optimizer.html`
825 - Test output: `skills/retention-metrics/onboarding-flow-optimizer/test-template-output.html`
826
827 ---
828
829 **End of Skill**