Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
jmsktm avatar

Churn Predictor

  • 202 installs
  • 8 repo stars
  • Updated January 22, 2026
  • jmsktm/claude-settings

Estimate customer churn risk from usage, billing, and engagement signals—surface at-risk accounts and retention actions for subscription SaaS during growth analytics reviews.

About

churn predictor in jmsktm/claude-settings guides Claude Code through churn-risk analysis for subscription businesses—interpreting engagement, billing, and usage patterns to flag at-risk customers. It targets grow-stage analytics and retention planning without requiring a standalone ML platform build-out.

  • Churn risk scoring for SaaS accounts
  • Usage and billing signal analysis
  • Retention-focused analytics output
  • jmsktm/claude-settings package
  • Supports data-driven lifecycle decisions

Churn Predictor by the numbers

  • 202 all-time installs (skills.sh)
  • Ranked #651 of 2,064 Data Science & ML skills by installs in the Skillselion catalog
  • Data as of Jul 29, 2026 (Skillselion catalog sync)
npx skills add https://github.com/jmsktm/claude-settings --skill churn-predictor

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs202
repo stars8
Last updatedJanuary 22, 2026
Repositoryjmsktm/claude-settings

What it does

Estimate customer churn risk from usage, billing, and engagement signals—surface at-risk accounts and retention actions for subscription SaaS during growth analytics reviews.

Files

SKILL.mdMarkdownGitHub ↗

Churn Predictor

Expert churn prediction system that identifies at-risk customers before they leave using behavioral signals, engagement patterns, and predictive analytics. This skill provides structured workflows for building churn models, monitoring risk signals, and executing retention interventions.

Churn is the silent killer of growth. By the time a customer announces they're leaving, it's often too late. This skill helps you identify churn risk early when intervention can still make a difference, prioritize retention efforts, and systematically reduce churn.

Built on data science best practices and customer success methodologies, this skill combines leading indicator analysis, risk scoring, and intervention playbooks to predict and prevent churn before it happens.

Core Workflows

Workflow 1: Churn Signal Identification

Map the behaviors that predict churn

1. Behavioral Signals

Signal TypeExamplesRisk Level
Usage Decline30%+ drop in logins, sessions, actionsHigh
Feature AbandonmentStopped using key featuresMedium-High
Engagement DropNo response to emails, missed meetingsMedium
Support PatternsSpike in tickets, negative sentimentHigh
Billing IssuesFailed payments, downgrade requestsHigh

2. Account Signals

  • Champion departure (key user leaves)
  • Company layoffs or restructuring
  • Merger/acquisition announcements
  • Budget cuts affecting your category
  • Competitor evaluation signals
  • Contract not renewed on auto-renew

3. Relationship Signals

  • NPS score decline (9-10 → 7 or below)
  • Missed QBRs or check-ins
  • Unresponsive to outreach
  • Escalated support issues
  • Negative sentiment in communications

4. Time-Based Signals

  • Approaching renewal (90/60/30 days)
  • End of trial or pilot
  • Anniversary of bad experience
  • Post-implementation plateau
  • Seasonal usage patterns

Workflow 2: Risk Scoring Model

Build a composite churn risk score

1. Score Components

   Churn Risk Score =
     (Usage Score × 0.30) +
     (Engagement Score × 0.25) +
     (Support Score × 0.20) +
     (Relationship Score × 0.15) +
     (Account Score × 0.10)

   Scale: 0-100 (higher = more at risk)

2. Usage Score Factors

  • Login frequency vs. baseline
  • Feature adoption breadth
  • Active users vs. licensed seats
  • Time in product
  • Core action completion

3. Engagement Score Factors

  • Email open/click rates
  • Meeting attendance
  • Resource downloads
  • Training completion
  • Community participation

4. Risk Categories

ScoreRisk LevelAction
0-20LowStandard monitoring
21-40ModerateProactive outreach
41-60ElevatedIntervention needed
61-80HighUrgent save attempt
81-100CriticalExecutive escalation

Workflow 3: Cohort & Trend Analysis

Understand churn patterns across customer segments

1. Cohort Analysis

  • Analyze by signup month/quarter
  • Track retention curves over time
  • Identify cohorts with worse retention
  • Correlate with product/market changes
  • Find patterns in successful cohorts

2. Segment Analysis

  • By customer size (SMB/Mid/Enterprise)
  • By industry vertical
  • By use case/persona
  • By acquisition source
  • By pricing tier

3. Churn Timing Patterns

  • When in customer lifecycle does churn occur?
  • Renewal vs. mid-contract churn
  • Time from warning signs to churn
  • Seasonal patterns
  • Correlation with contract length

4. Leading Indicator Validation

  • Track signals → churn correlation
  • Calculate signal lead time
  • Measure false positive rate
  • Refine scoring weights
  • A/B test interventions

Workflow 4: Alert & Escalation System

Surface risk at the right time to the right people

1. Alert Triggers

  • Score crosses threshold (e.g., into "elevated")
  • Rapid score increase (10+ points in 7 days)
  • Critical signal detected (payment failed, champion left)
  • Renewal approaching with elevated risk
  • Multiple signals converging

2. Escalation Matrix

Risk LevelOwnerEscalationResponse SLA
ModerateCSMNone5 days
ElevatedCSMManager copy48 hours
HighCSM + ManagerVP briefed24 hours
CriticalManagerVP/Exec sponsorSame day

3. Alert Content

  • Customer name and risk score
  • Specific signals triggering alert
  • Score trend (improving/declining)
  • Renewal date and ARR at risk
  • Recommended actions

4. Alert Channels

  • Slack/Teams notifications
  • Email digests
  • CRM dashboards
  • Weekly risk reports
  • Executive summaries

Workflow 5: Intervention Playbooks

Systematic approaches to save at-risk customers

1. Intervention Matching

Root CauseIntervention
Low adoptionTraining, onboarding redo
Technical issuesEngineering escalation, workarounds
Value unclearROI analysis, executive alignment
Champion leftRelationship rebuild with new stakeholders
Pricing concernsDiscount, plan adjustment, payment terms
CompetitiveFeature comparison, roadmap preview

2. Save Play Execution

  • Diagnose root cause (don't assume)
  • Match intervention to cause
  • Assign owner and resources
  • Set clear timeline and milestones
  • Track outcome (saved, lost, reason)

3. Intervention Tactics

  • Urgent Call: Same-day executive outreach
  • Health Check: Comprehensive account review
  • Training Blitz: Intensive enablement sessions
  • Success Sprint: Focused value delivery
  • Executive Alignment: VP/C-level engagement
  • Commercial Discussion: Pricing/terms adjustment

4. Outcome Tracking

  • Save rate by risk level
  • Save rate by intervention type
  • Time from intervention to resolution
  • Reasons for unsuccessful saves
  • Long-term retention of saved accounts

Quick Reference

ActionCommand/Trigger
Check risk score"Show churn risk for [Customer]"
List at-risk accounts"Show accounts above [X] risk score"
Analyze churn patterns"Analyze churn patterns by [segment]"
Review alerts"Show churn alerts this week"
Create save plan"Create intervention plan for [Customer]"
Score validation"Validate churn model accuracy"
Cohort analysis"Analyze retention by cohort"
Signal analysis"Find leading churn indicators"
Trend report"Show risk score trends"
Intervention report"Report on save play outcomes"

Best Practices

Signal Selection

  • Focus on behaviors you can observe
  • Validate correlation with actual churn
  • Use leading indicators (not lagging)
  • Combine multiple signal types
  • Weight by predictive power

Scoring Model

  • Start simple, add complexity gradually
  • Calibrate weights with historical data
  • Validate with blind holdout testing
  • Recalibrate quarterly
  • Document methodology

Alert Design

  • Don't alert on every score change
  • Focus on actionable thresholds
  • Include context in alerts
  • Route to right person
  • Avoid alert fatigue

Intervention

  • Diagnose before prescribing
  • Match intervention to root cause
  • Set clear success criteria
  • Track outcomes rigorously
  • Learn from failures

Model Maintenance

  • Review accuracy monthly
  • Retrain with new churn data
  • Adjust for product changes
  • Update as customer base evolves
  • Document false positives/negatives

Churn Signals Library

Usage Signals

SignalCalculationWarning Threshold
Login decline% change week-over-week-30% for 2+ weeks
DAU/MAU ratioDaily active / Monthly activeBelow 0.2
Feature breadth# features used / availableBelow 30%
Seat utilizationActive users / licensed seatsBelow 50%
Session depthActions per sessionBelow baseline by 40%

Engagement Signals

SignalCalculationWarning Threshold
Email engagementOpen rate × Click rateBelow 5%
Meeting attendanceAttended / ScheduledBelow 60%
Response timeAvg days to respondAbove 5 days
QBR participationAttended / ScheduledMiss 2+ in row
Training completionCompleted / AvailableBelow 25%

Support Signals

SignalCalculationWarning Threshold
Ticket volumeTickets / month3× baseline
Sentiment scoreNegative / TotalAbove 30%
Escalation rateEscalated / TotalAbove 20%
Resolution satisfactionCSAT on resolvedBelow 3/5
Open ticket ageAvg days openAbove 7 days

Relationship Signals

SignalCalculationWarning Threshold
NPS changeCurrent - PreviousDrop of 3+ points
Health scoreComposite scoreBelow 60
Champion riskChampion activity declineBelow 50% of baseline
Executive accessExec meetings / quarter0 in 2+ quarters
Renewal confidenceCSM assessmentBelow 70%

Risk Report Template

Weekly At-Risk Summary

# Churn Risk Report: Week of [Date]

## Summary
- Accounts at elevated risk or above: [X]
- Total ARR at risk: $[Amount]
- New alerts this week: [X]
- Risk trending up: [X accounts]
- Risk trending down: [X accounts]

## Critical Risk (81-100)
| Account | ARR | Score | Key Signals | Owner | Action |
|---------|-----|-------|-------------|-------|--------|
| [Name] | $X | 87 | [Signals] | [CSM] | [Status] |

## High Risk (61-80)
[Same format]

## Elevated Risk (41-60)
[Same format]

## Interventions in Progress
| Account | Started | Intervention | Progress |
|---------|---------|--------------|----------|
| [Name] | [Date] | [Type] | [Status] |

## Outcomes This Week
- Saved: [X accounts, $ARR]
- Lost: [X accounts, $ARR, reasons]
- De-escalated: [X accounts]

Red Flags

  • Model overfit: Perfect on training data, poor on new data
  • Signal lag: Indicators trigger too late for intervention
  • False positive fatigue: Too many alerts that aren't real risk
  • Missing signals: Key churn predictors not tracked
  • Score opacity: Team doesn't understand why scores change
  • Intervention mismatch: Same playbook for different problems
  • No feedback loop: Not learning from save attempts
  • Data quality: Missing or stale underlying data

Model Validation Metrics

MetricWhat It MeasuresTarget
AccuracyOverall correct predictions80%+
PrecisionTrue positives / All predicted positives70%+
RecallTrue positives / All actual churns85%+
Lead TimeDays from high risk to actual churn60+ days
False Positive RateFalse alarms / All high-risk alerts< 30%
Save RateSaved / Attempted saves40%+
AUC-ROCModel discrimination ability0.75+

Related skills

Data Science & MLanalyticspipelines

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.