.claude/skills/retention-analysis/SKILL.md
Cohort analysis and retention optimization framework. Identifies retention drivers and churn factors.
npx skillsauth add pisithrps/yapzee retention-analysisInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
/retention-analysis
Then provide:
I'll analyze your retention curve shape, identify the biggest drop-off, compare retained vs churned user behavior, and recommend interventions.
Output: Saved to outputs/analyses/retention-analysis-[date].md
Time: ~15 min with data, ~25 min with cohort deep-dive
When to use: When diagnosing churn problems, measuring product-market fit, or optimizing for stickiness
Framework source: Aakash Gupta's retention frameworks and "Ultimate Guide to Activation"
Automatic Context Checks: When this skill is invoked, immediately check:
| Source | Files/Folders | Search Terms | What to Extract |
|--------|---------------|--------------|-----------------|
| Metrics/Analytics | context-library/metrics/*.md | D7, D30, retention, churn, cohort, "monthly active", DAU, WAU | Current retention curves, cohort performance, churn rates |
| User Research | context-library/research/*.md | churn, "stopped using", "didn't come back", "why I left", "why I switched" | Churn interview quotes, reasons users stop using product |
| Meeting Notes | context-library/meetings/*.md | churn, "cancelled", "downgrade", lost deal, customer feedback | CS feedback on churn, customer complaints, drop-off patterns |
| PRDs | context-library/prds/*.md | retention, sticky, habit, engagement, notification, reminder | Features built to improve retention |
| Business Info | context-library/business-info-template.md | target user, use case, frequency, engagement, core activity | How often users should use product, what drives stickiness |
Context Priority:
Cross-Skill Links:
activation-analysis (fix activation first)expansion-strategyprd-draftBefore diving into retention analysis, let me check what data already exists about your users...
Checking:
context-library/business-info-template.md for expected product usage patternscontext-library/metrics/ for existing retention metrics and cohort datacontext-library/research/ for churn interviews and user feedbackcontext-library/meetings/ for CS/support feedback on why users churncontext-library/prds/ for features built to improve retention[If analytics MCP connected]: "Let me also query [Amplitude/Mixpanel] for your current retention curves, churn rates by cohort, and behavioral differences between retained vs churned users."
Based on what I find, I'll show you:
From Business Info:
From Metrics/Analytics:
From Churn Research:
From Sales/CS Meetings:
From PRDs:
Based on internal context, we don't yet know:
Should I help analyze your retention data, or would you like to provide additional metrics first?
Instead of generic "track retention metrics," I'll ask:
"Between Day 1, Day 7, and Day 30, where do you lose the most users?"
This tells me whether the problem is immediate product issues (D1→D7) or habit formation (D7→D30).
"What specific actions do Day 30 retained users take in their first week that Day 7 churned users don't?"
This is the differentiating behavior, not your opinion of what matters.
"From churn interviews or feedback, what are the top 3 reasons users stop using?"
This tells me whether it's product quality, insufficient value, or competition.
"How often should active users return—daily, weekly, or monthly?"
This determines whether D7 or L7 retention is your right metric.
"Do different user segments (size, industry, use case) have different retention patterns?"
Enterprise vs SMB, solo vs team users often have very different retention curves.
Definition: % of users active on Day 7 after signup
Why it matters: Early signal of product stickiness
Benchmarks:
Formula:
D7 Retention = (Users active on Day 7) / (Users who signed up 7 days ago) × 100
Definition: % of users active 30 days after signup
Why it matters: Indicates habit formation
Benchmarks:
Formula:
D30 Retention = (Users active on Day 30) / (Users who signed up 30 days ago) × 100
Definition: % of users active in a 7-day or 28-day window
Why better than D7/D30:
L7 Formula:
L7 = (Users active at least once in Days 1-7) / (Total signups) × 100
L28 Formula:
L28 = (Users active at least once in Days 1-28) / (Total signups) × 100
Three types of retention curves:
1. Flattening Curve (Good) ✅
2. Declining Curve (Bad) ❌
3. Smiling Curve (Best) ✅✅
How to visualize:
Plot retention % (Y-axis) vs Days since signup (X-axis)
- Day 1, Day 7, Day 14, Day 30, Day 60, Day 90
What it is: Comparing retention across different user groups
Compare by signup month:
Jan 2024 cohort: 45% D30 retention
Feb 2024 cohort: 50% D30 retention
Mar 2024 cohort: 55% D30 retention
What this tells you: Product improvements are working (retention trending up)
Compare users who used Feature X vs didn't:
Used Feature X: 60% D30 retention
Didn't use Feature X: 30% D30 retention
What this tells you: Feature X drives retention (prioritize it)
Compare acquisition channels:
Organic search: 50% D30 retention
Paid ads: 25% D30 retention
Referrals: 70% D30 retention
What this tells you: Referrals bring highest quality users
Run retention analysis:
Use /retention-analysis and reference context-library/business-info-template.md
Help me analyze our retention:
- D1 retention: ___%
- D7 retention: ___%
- D14 retention: ___%
- D30 retention: ___%
Where's the biggest drop? What should we focus on?
Common patterns:
Find the differentiating behaviors:
Questions to ask:
Example analysis:
Retained users (D30):
- Completed setup in <5 minutes: 80%
- Created 3+ projects in first week: 75%
- Invited 2+ team members: 90%
- Used core feature 5+ times: 100%
Churned users (D30):
- Completed setup in <5 minutes: 30%
- Created 3+ projects in first week: 10%
- Invited 2+ team members: 5%
- Used core feature 5+ times: 20%
Insight: Focus on setup speed, project creation, team invites, and core feature usage
Hypothesis format:
If we [intervention], then [metric] will improve by [amount] because [reason]
Example hypotheses:
Key retention drivers:
Metric to optimize: Daily Active Users (DAU)
Key retention drivers:
Metric to optimize: Weekly Active Users (WAU)
Key retention drivers:
Metric to optimize: Monthly transactions per user
Key retention drivers:
Metric to optimize: Active paid seats
What it is: Analyzing users who churned then came back
Resurrection rate:
Resurrection = (Churned users who returned) / (Total churned users) × 100
Questions to answer:
Example insights:
Track these weekly:
| Metric | This Week | Last Week | 4 Weeks Ago | Target | |--------|-----------|-----------|-------------|--------| | D1 Retention | ___% | ___% | ___% | 80%+ | | D7 Retention | ___% | ___% | ___% | 40%+ | | D14 Retention | ___% | ___% | ___% | 35%+ | | D30 Retention | ___% | ___% | ___% | 25%+ | | L28 (28-day) | ___% | ___% | ___% | 30%+ | | Weekly Active | _____ | _____ | _____ | Growing | | Churn Rate | ___% | ___% | ___% | <10% |
Cohort comparison:
❌ Only tracking signup growth
❌ Using only D30 retention
❌ Not segmenting retention
❌ Ignoring resurrection
❌ Confusing D7 with L7
Discovery: Users who added 7 friends in first 10 days had 90% D30 retention
Action: Optimized onboarding for friend connections
Result: Explosive user growth with strong retention
Discovery: Teams sending 2,000+ messages had 93% retention
Action: Focused activation on reaching 2,000 messages
Result: Clear activation metric, high retention
Discovery: Users with 5+ connections had 70% higher D30 retention
Action: Aggressive prompts to make connections early
Result: Improved early engagement and long-term retention
Use this with your data:
Retained users typically:
Churned users typically:
Research & Findings:
outputs/analyses/retention-analysis-[date].mdcontext-library/research/retention-[product].mdRetention Metrics & Dashboards:
context-library/metrics/ with your retention dashboardRetention Features & Improvements:
context-library/prds/ for each retention initiativeFeeds into:
/activation-analysis - Activation rates predict retention (low activation = low retention)/expansion-strategy - Retention is prerequisite for expansion (retain before upselling)/prd-draft - Retention features become product roadmap items/experiment-decision - Test retention improvements (email cadence, notifications, features)/metrics-framework - Retention and churn as leading indicators of business health/define-north-star - Retention often ties to North Star metricPulls from:
/activation-analysis - Aha moment and habit formation data/user-research-synthesis - Churn interview synthesis and user feedback/competitor-analysis - Understand if churn is to competitors/expansion-strategy - Expansion cohort retention patternsAfter analyzing retention, ask:
For users who churned or went dormant:
| Dormancy Period | Channel | Message Type | Expected Win-Back Rate | |----------------|---------|-------------|----------------------| | 1-7 days | In-app nudge + email | "We noticed you haven't been back..." | 15-25% | | 7-30 days | Personal email from PM/CS | Value reminder with specific use case | 8-15% | | 30-90 days | Win-back campaign | New feature highlights since they left | 3-8% | | 90+ days | Re-engagement email | New value prop or offer | 1-3% |
After running win-back campaigns, track whether resurrected users retain at the same rate as organic active users.
Resurrection Cohort Tracking:
| Cohort | N | D7 Post-Return | D30 Post-Return | D90 Post-Return | Comparison to Organic | |--------|---|---------------|----------------|----------------|----------------------| | Win-back (1-7 day dormancy) | [N] | [%] | [%] | [%] | [% vs organic D7/D30/D90] | | Win-back (7-30 day dormancy) | [N] | [%] | [%] | [%] | [% vs organic D7/D30/D90] | | Win-back (30-90 day dormancy) | [N] | [%] | [%] | [%] | [% vs organic D7/D30/D90] | | Win-back (90+ day dormancy) | [N] | [%] | [%] | [%] | [% vs organic D7/D30/D90] | | Organic active (baseline) | [N] | [%] | [%] | [%] | -- |
Key questions this answers:
Decision framework:
Monitor these leading indicators to catch at-risk users before they churn:
| Signal | Threshold | Risk Level | Intervention | |--------|-----------|------------|-------------| | Login frequency drop | >50% decrease week-over-week | High | Automated email + CS outreach | | Feature usage narrowing | Using only 1 feature (was using 3+) | Medium | In-app prompt for underused features | | Support ticket spike | 3+ tickets in a week | Medium | Proactive CS call | | Team member departures | Admin removes users | High | Executive-level check-in | | Core action stopped | 14+ days without core activity | High | "What's blocking you?" email | | Session duration declining | >40% shorter sessions over 2 weeks | Medium | Check for UX issues, survey | | Export activity spike | Bulk data export | High | Immediate CS outreach (likely switching) |
Combine signals into a composite score:
Churn Risk Score = (Login frequency weight x login signal)
+ (Feature breadth weight x narrowing signal)
+ (Support weight x ticket signal)
+ (Team size weight x departure signal)
+ (Core action weight x inactivity signal)
Score 0-30: Low risk (monitor)
Score 31-60: Medium risk (automated intervention)
Score 61-100: High risk (human intervention)
Calibrate weights using historical data: which signals best predicted actual churn in the past 6 months?
Before delivering the retention analysis, verify:
activation-analysis - Improve activation to boost retention (activation -> retention pipeline)metrics-framework - Leading indicators of retention (D7, L28, feature adoption)experiment-decision - Test retention improvements (engagement features, notifications)define-north-star - Align retention metrics to North Star metricuser-research-synthesis - Understand why users churn (synthesis of churn interviews)expansion-strategy - Retention enables expansion (can't expand churned users)competitor-analysis - Understand competitive churn factorsFramework credit: Adapted from Aakash Gupta's retention frameworks. Read: https://www.news.aakashg.com/p/ultimate-guide-activation (habit formation section)
development
Product strategy docs using 7-component framework
tools
Review week's progress, meetings, learnings
tools
Set next week's priorities
development
Turn user interviews into actionable insights. Advanced synthesis techniques and frameworks.