Churn Analysis Skill

SkillAI & models

Produce a structured churn analysis that separates avoidable from unavoidable churn. Use when investigating why customers are leaving, identifying at-risk segments, calculating net revenue retention, or building a retention intervention plan. Produces a churn report with rate calculations, categorised reasons by avoidability, segment breakdown, timing analysis, early warning signals, and prioritised interventions ranked by estimated impact.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Churn Analysis Skill skill

What this skill tells your AI

The instructions your AI receives, as published by mohitagw15856/pm-claude-skills in skills/churn-analysis/SKILL.md and read by ahel’s review.

Produce a structured churn analysis that goes beyond the headline rate — identifying why customers leave, which segments are most at risk, and what interventions will have the highest impact on retention.

Reads from / Writes to the Brain

If a professional-brain (brain/) exists, ground in it instead of re-asking for what you already know:

  • Read first: context.md (metric definitions — what "churn" means here), knowledge/, and related segment entities/. Run python3 ../professional-brain/scripts/brain_query.py ./brain "churn" and carry each fact's provenance tag through.
  • 📥 Propose to the Brain: after producing, propose recording the headline retention finding to knowledge/ ([data]), any retention decision to decisions/, and at-risk drivers as hypotheses/. Show them, get a yes, then write with ../professional-brain/scripts/brain_write.py … --commit (append-only, dry-run by default).

Required Inputs

Ask for these if not already provided:

  • Time period being analysed (e.g. Q1, last 12 months)
  • Total customers at start of period and customers churned
  • ARR or revenue lost to churn
  • Churn reasons data — exit survey results, CSM notes, support data, or sales loss reasons
  • Customer segments — by tier, industry, cohort, or product line
  • Current retention rate if known
  • Any recent changes — pricing, product, support model — that may have affected churn

Churn Categories

Always classify churn before analysing it:

CategoryDefinition
Voluntary — avoidableCustomer left due to a problem we could have addressed (product gaps, poor onboarding, relationship failures)
Voluntary — unavoidableCustomer left for reasons outside our control (budget cuts, acquisition, company shutdown)
InvoluntaryPayment failure, contract non-renewal by mistake, admin error

The interventions for each category are different. Conflating them leads to wrong conclusions.

Output Format


Churn Analysis: [Product / Segment / Company]

Period: [Start date] — [End date] Prepared by: [Name] | Date: [Date]


Headline Numbers

MetricValue
Customers at start of period[N]
Customers churned[N]
Customer churn rate[X]%
ARR at start of period£/$/€[X]
ARR lost to churn£/$/€[X]
Revenue churn rate (gross)[X]%
ARR from expansions (same period)£/$/€[X]
Net revenue retention (NRR)[X]%

Benchmark context:

  • Customer churn rate: [X]% vs. industry benchmark [Y]% — [above / below / in line]
  • NRR: [X]% — [What this means: above 100% = expansion offsets churn; below 100% = shrinking base]

Churn Breakdown by Category

CategoryCustomers% of churnARR lost
Voluntary — avoidable[N][X]%£/$/€[X]
Voluntary — unavoidable[N][X]%£/$/€[X]
Involuntary[N][X]%£/$/€[X]
Total[N]100%£/$/€[X]

Avoidable churn as % of total churn: [X]% — this is the number we can actually influence.


Churn Reasons — Avoidable Churn Only

Rank by frequency. Include ARR weight where data allows.

ReasonCount% of avoidable churnARR lostRepresentative quote
[Reason 1 — e.g. "Product missing key feature"][N][X]%£/$/€[X]"[Quote]"
[Reason 2][N][X]%£/$/€[X]"[Quote]"
[Reason 3][N][X]%£/$/€[X]"[Quote]"
[Reason 4][N][X]%£/$/€[X]"[Quote]"
Other[N][X]%£/$/€[X]

Theme synthesis: [2–3 sentences grouping the top reasons into 2–3 themes. E.g. "The top three reasons cluster around two themes: product gaps in [area] (affecting X% of avoidable churn) and onboarding failures where customers never achieved value (Y%)."]


Churn by Segment

Identify which segments over- or under-index for churn.

By Tier

TierChurn ratevs. OverallNotes
Enterprise[X]%+/-[X]pp
Mid-Market[X]%+/-[X]pp
SMB[X]%+/-[X]pp

By Cohort (Acquisition Year)

CohortChurn rateNotes
[Year 1][X]%
[Year 2][X]%
[Year 3][X]%

By Industry / Use Case (if data available)

SegmentChurn rateNotes
[Segment 1][X]%
[Segment 2][X]%

Key pattern: [Which segment has the highest churn rate and what likely explains it]


Timing Analysis

  • Average contract length before churn: [X months]
  • Highest-risk moment: [e.g. "Month 3 — when trial value has worn off but full adoption hasn't happened"]
  • Churn timing distribution:
When churn occurred% of churned accounts
0–3 months[X]%
3–6 months[X]%
6–12 months[X]%
12+ months[X]%

Early Warning Signals

Based on the churned accounts, identify the signals that preceded churn (and could have triggered earlier intervention):

SignalLead time before churnHow to detect
[Signal 1 — e.g. "DAU/MAU dropped below 15%"][~X weeks][Usage dashboard / alert]
[Signal 2 — e.g. "No QBR in 90+ days"][~X weeks][CRM flag]
[Signal 3 — e.g. "Champion left the account"][~X weeks][LinkedIn alert / CSM tracking]
[Signal 4][~X weeks][Detection method]

Intervention Recommendations

Ranked by estimated impact × feasibility.

InterventionAddressesEst. churn reductionEffortOwner
[Intervention 1 — e.g. "Improve onboarding for [segment] with dedicated 30-day check-in"][Reason 1][X accounts / £X ARR]Low / Med / High[Team]
[Intervention 2][Reason 2][X accounts / £X ARR]Low / Med / High[Team]
[Intervention 3][Reason 3][X accounts / £X ARR]Low / Med / High[Team]

Priority call: [Which one intervention, if implemented this quarter, would have the biggest impact and why]


What We Don't Know (Data Gaps)

  • [Data gap 1 — e.g. "Exit survey response rate is only 30% — the reasons data may not be representative"]
  • [Data gap 2 — e.g. "No product usage data for SMB tier — can't confirm usage signal correlation"]
  • [Data gap 3]

Anti-Patterns

  • Do not mix avoidable and unavoidable churn in intervention plans — recommending product fixes for customers who churned due to company shutdown wastes resources
  • Do not calculate churn rate using end-of-period customer count as the denominator — this understates churn; always divide churned customers by the starting cohort
  • Do not rely solely on exit survey data for churn reasons — response rates are typically low and self-selection biases the sample toward customers who are engaged enough to complete a survey
  • Do not recommend interventions without linking them to a specific churn reason — interventions disconnected from root causes will not move retention
  • Do not report only gross revenue churn — without net revenue retention (NRR), a healthy-looking retention number can hide a shrinking revenue base

Deeper Materials

This skill ships with support files — use them when they are available:

  • references/avoidability-calls.md — Avoidable or Not? The Judgment Calls in Churn Classification. Apply it while producing the output; it carries the calibration and judgment calls the method summary above compresses.
  • templates/churn-report.md — a fill-in version of the deliverable with the quality gates inline. Offer it when the user wants to work the document themselves rather than have it generated.

Scoring Rubric (0–40)

Score any output of this skill before handing it over; 32+ is ship-quality.

Dimension0510
Rate math integrityChurn computed on end-of-period count; no NRRCorrect denominator but gross churn onlyCorrect denominator, gross and net side by side, benchmark context that interprets rather than decorates
Avoidability separationAll churn treated as one poolCategories tabulated but interventions still address the full poolAvoidable/unavoidable/involuntary split carried through every downstream section; interventions touch only the avoidable share
Segment & timing insightAverages onlySegment table present but no over-index readingNames the specific over-indexing cell (tier × cohort) and the highest-risk moment, with the "why"
Intervention linkageRecommendations float free of causesEach intervention names a reason but impact is unsizedEvery intervention maps to a ranked reason with estimated accounts/ARR recovered, and the priority call justifies its sequencing

Quality Checks

  • Churn rate is correctly calculated (churned ÷ starting cohort, not end-of-period total)
  • Avoidable and unavoidable churn are separated — interventions target avoidable churn only
  • Churn reasons are customer-reported, not internally assumed
  • Segment analysis identifies which segments over-index — not just averages
  • Early warning signals are specific and detectable, not generic ("low engagement")
  • Interventions link directly to the top churn reasons — no recommendations without a root cause match

Signals

GitHub stars
1k
Forks
241
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
churn-analysis
Source
github.com/mohitagw15856/pm-claude-skills