Churn Analysis Skill

Produce a structured churn analysis that separates avoidable from unavoidable churn.

Churn Analysis Skill — The Skill Playground: pick the Executive Update skill, fill in a few notes, hit run, and watch a structured executive… (from the mohitagw15856/pm-claude-skills README)

From the mohitagw15856/pm-claude-skills README — shows the whole collection, not only this skill. · view on GitHub

How to use it

Claude Code
  1. Run the line below. It pulls the whole folder into ~/.claude/skills/churn-analysis, including the files SKILL.md points to.
  2. Describe your job in plain words. Claude Code follows the skill from there.
Claude Code — installs the whole folder, not just SKILL.md
npx degit mohitagw15856/pm-claude-skills/skills/churn-analysis#main ~/.claude/skills/churn-analysis

For one project only, change the path to .claude/skills/churn-analysis. This skill also uses context.md — copying SKILL.md alone won't be enough. See the folder on GitHub.

Claude (web or desktop app)
  1. On this page open ⋯ → Download .md.
  2. Save it as SKILL.md in a folder, zip the folder, then Customize → Skills → + → Create skill → Upload a skill.
  3. Pick the file and Save. Claude shows the name and description and runs a security scan.
  4. Check the skill is switched on.
  5. Start a new chat and describe your job in plain words. The AI follows the skill from there.
ChatGPT or another app
  1. ChatGPT: make a Project and paste it into Instructions.
  2. Neither? Paste it at the top of a new chat — it works for that chat.
Not working?
  • Check which app you pasted it into — the steps above name the right one.
  • Some skills need the paid tier of Claude or ChatGPT.
Step-by-step guide with screenshots · Ask in the forum

Paste into Claude, ChatGPT or Cursor.

Source of Churn Analysis Skill

Show the full text213 lines
namedescription
churn-analysisProduce 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.

Churn Analysis Skill

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:

Category Definition
Voluntary — avoidable Customer left due to a problem we could have addressed (product gaps, poor onboarding, relationship failures)
Voluntary — unavoidable Customer left for reasons outside our control (budget cuts, acquisition, company shutdown)
Involuntary Payment 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

Metric Value
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

Category Customers % of churn ARR 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.

Reason Count % of avoidable churn ARR lost Representative 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
Tier Churn rate vs. Overall Notes
Enterprise [X]% +/-[X]pp
Mid-Market [X]% +/-[X]pp
SMB [X]% +/-[X]pp
By Cohort (Acquisition Year)
Cohort Churn rate Notes
[Year 1] [X]%
[Year 2] [X]%
[Year 3] [X]%
By Industry / Use Case (if data available)
Segment Churn rate Notes
[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):

Signal Lead time before churn How 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.

Intervention Addresses Est. churn reduction Effort Owner
[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.

Dimension 0 5 10
Rate math integrity Churn computed on end-of-period count; no NRR Correct denominator but gross churn only Correct denominator, gross and net side by side, benchmark context that interprets rather than decorates
Avoidability separation All churn treated as one pool Categories tabulated but interventions still address the full pool Avoidable/unavoidable/involuntary split carried through every downstream section; interventions touch only the avoidable share
Segment & timing insight Averages only Segment table present but no over-index reading Names the specific over-indexing cell (tier × cohort) and the highest-risk moment, with the "why"
Intervention linkage Recommendations float free of causes Each intervention names a reason but impact is unsized Every 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
1---
2name: churn-analysis
3description: "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."
4---
5 
6# Churn Analysis Skill
7 
8Produce 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.
9 
10## Reads from / Writes to the Brain
11 
12If a [`professional-brain`](../professional-brain/SKILL.md) (`brain/`) exists, ground in it instead of re-asking for what you already know:
13 
14- **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.
15- **📥 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).
16 
17## Required Inputs
18 
19Ask for these if not already provided:
20- **Time period** being analysed (e.g. Q1, last 12 months)
21- **Total customers at start of period** and **customers churned**
22- **ARR or revenue lost** to churn
23- **Churn reasons data** — exit survey results, CSM notes, support data, or sales loss reasons
24- **Customer segments** — by tier, industry, cohort, or product line
25- **Current retention rate** if known
26- **Any recent changes** — pricing, product, support model — that may have affected churn
27 
28## Churn Categories
29 
30Always classify churn before analysing it:
31 
32| Category | Definition |
33|---|---|
34| **Voluntary — avoidable** | Customer left due to a problem we could have addressed (product gaps, poor onboarding, relationship failures) |
35| **Voluntary — unavoidable** | Customer left for reasons outside our control (budget cuts, acquisition, company shutdown) |
36| **Involuntary** | Payment failure, contract non-renewal by mistake, admin error |
37 
38The interventions for each category are different. Conflating them leads to wrong conclusions.
39 
40## Output Format
41 
42---
43 
44# Churn Analysis: [Product / Segment / Company]
45**Period:** [Start date] — [End date]
46**Prepared by:** [Name] | **Date:** [Date]
47 
48---
49 
50## Headline Numbers
51 
52| Metric | Value |
53|---|---|
54| Customers at start of period | [N] |
55| Customers churned | [N] |
56| **Customer churn rate** | **[X]%** |
57| ARR at start of period | £/$/€[X] |
58| ARR lost to churn | £/$/€[X] |
59| **Revenue churn rate (gross)** | **[X]%** |
60| ARR from expansions (same period) | £/$/€[X] |
61| **Net revenue retention (NRR)** | **[X]%** |
62 
63**Benchmark context:**
64- Customer churn rate: [X]% vs. industry benchmark [Y]% — [above / below / in line]
65- NRR: [X]% — [What this means: above 100% = expansion offsets churn; below 100% = shrinking base]
66 
67---
68 
69## Churn Breakdown by Category
70 
71| Category | Customers | % of churn | ARR lost |
72|---|---|---|---|
73| Voluntary — avoidable | [N] | [X]% | £/$/€[X] |
74| Voluntary — unavoidable | [N] | [X]% | £/$/€[X] |
75| Involuntary | [N] | [X]% | £/$/€[X] |
76| **Total** | **[N]** | **100%** | **£/$/€[X]** |
77 
78**Avoidable churn as % of total churn:** [X]% — this is the number we can actually influence.
79 
80---
81 
82## Churn Reasons — Avoidable Churn Only
83 
84Rank by frequency. Include ARR weight where data allows.
85 
86| Reason | Count | % of avoidable churn | ARR lost | Representative quote |
87|---|---|---|---|---|
88| [Reason 1 — e.g. "Product missing key feature"] | [N] | [X]% | £/$/€[X] | "[Quote]" |
89| [Reason 2] | [N] | [X]% | £/$/€[X] | "[Quote]" |
90| [Reason 3] | [N] | [X]% | £/$/€[X] | "[Quote]" |
91| [Reason 4] | [N] | [X]% | £/$/€[X] | "[Quote]" |
92| Other | [N] | [X]% | £/$/€[X] | — |
93 
94**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%)."]
95 
96---
97 
98## Churn by Segment
99 
100Identify which segments over- or under-index for churn.
101 
102### By Tier
103 
104| Tier | Churn rate | vs. Overall | Notes |
105|---|---|---|---|
106| Enterprise | [X]% | +/-[X]pp | |
107| Mid-Market | [X]% | +/-[X]pp | |
108| SMB | [X]% | +/-[X]pp | |
109 
110### By Cohort (Acquisition Year)
111 
112| Cohort | Churn rate | Notes |
113|---|---|---|
114| [Year 1] | [X]% | |
115| [Year 2] | [X]% | |
116| [Year 3] | [X]% | |
117 
118### By Industry / Use Case (if data available)
119 
120| Segment | Churn rate | Notes |
121|---|---|---|
122| [Segment 1] | [X]% | |
123| [Segment 2] | [X]% | |
124 
125**Key pattern:** [Which segment has the highest churn rate and what likely explains it]
126 
127---
128 
129## Timing Analysis
130 
131- **Average contract length before churn:** [X months]
132- **Highest-risk moment:** [e.g. "Month 3 — when trial value has worn off but full adoption hasn't happened"]
133- **Churn timing distribution:**
134 
135| When churn occurred | % of churned accounts |
136|---|---|
137| 0–3 months | [X]% |
138| 3–6 months | [X]% |
139| 6–12 months | [X]% |
140| 12+ months | [X]% |
141 
142---
143 
144## Early Warning Signals
145 
146Based on the churned accounts, identify the signals that preceded churn (and could have triggered earlier intervention):
147 
148| Signal | Lead time before churn | How to detect |
149|---|---|---|
150| [Signal 1 — e.g. "DAU/MAU dropped below 15%"] | [~X weeks] | [Usage dashboard / alert] |
151| [Signal 2 — e.g. "No QBR in 90+ days"] | [~X weeks] | [CRM flag] |
152| [Signal 3 — e.g. "Champion left the account"] | [~X weeks] | [LinkedIn alert / CSM tracking] |
153| [Signal 4] | [~X weeks] | [Detection method] |
154 
155---
156 
157## Intervention Recommendations
158 
159Ranked by estimated impact × feasibility.
160 
161| Intervention | Addresses | Est. churn reduction | Effort | Owner |
162|---|---|---|---|---|
163| [Intervention 1 — e.g. "Improve onboarding for [segment] with dedicated 30-day check-in"] | [Reason 1] | [X accounts / £X ARR] | Low / Med / High | [Team] |
164| [Intervention 2] | [Reason 2] | [X accounts / £X ARR] | Low / Med / High | [Team] |
165| [Intervention 3] | [Reason 3] | [X accounts / £X ARR] | Low / Med / High | [Team] |
166 
167**Priority call:** [Which one intervention, if implemented this quarter, would have the biggest impact and why]
168 
169---
170 
171## What We Don't Know (Data Gaps)
172 
173- [Data gap 1 — e.g. "Exit survey response rate is only 30% — the reasons data may not be representative"]
174- [Data gap 2 — e.g. "No product usage data for SMB tier — can't confirm usage signal correlation"]
175- [Data gap 3]
176 
177---
178 
179## Anti-Patterns
180 
181- [ ] Do not mix avoidable and unavoidable churn in intervention plans — recommending product fixes for customers who churned due to company shutdown wastes resources
182- [ ] 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
183- [ ] 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
184- [ ] Do not recommend interventions without linking them to a specific churn reason — interventions disconnected from root causes will not move retention
185- [ ] Do not report only gross revenue churn — without net revenue retention (NRR), a healthy-looking retention number can hide a shrinking revenue base
186 
187## Deeper Materials
188 
189This skill ships with support files — use them when they are available:
190 
191- **`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.
192- **`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.
193 
194## Scoring Rubric (0–40)
195 
196Score any output of this skill before handing it over; 32+ is ship-quality.
197 
198| Dimension | 0 | 5 | 10 |
199|---|---|---|---|
200| Rate math integrity | Churn computed on end-of-period count; no NRR | Correct denominator but gross churn only | Correct denominator, gross and net side by side, benchmark context that interprets rather than decorates |
201| Avoidability separation | All churn treated as one pool | Categories tabulated but interventions still address the full pool | Avoidable/unavoidable/involuntary split carried through every downstream section; interventions touch only the avoidable share |
202| Segment & timing insight | Averages only | Segment table present but no over-index reading | Names the specific over-indexing cell (tier × cohort) and the highest-risk moment, with the "why" |
203| Intervention linkage | Recommendations float free of causes | Each intervention names a reason but impact is unsized | Every intervention maps to a ranked reason with estimated accounts/ARR recovered, and the priority call justifies its sequencing |
204 
205## Quality Checks
206 
207- [ ] Churn rate is correctly calculated (churned ÷ starting cohort, not end-of-period total)
208- [ ] Avoidable and unavoidable churn are separated — interventions target avoidable churn only
209- [ ] Churn reasons are customer-reported, not internally assumed
210- [ ] Segment analysis identifies which segments over-index — not just averages
211- [ ] Early warning signals are specific and detectable, not generic ("low engagement")
212- [ ] Interventions link directly to the top churn reasons — no recommendations without a root cause match
213 

Discussion

Alternatives

Also in Churn & renewalsSee all 24 in Customer support →
Win back customers before they cancelTell us about your subscription business and why people quit. Get back a ready-to-use plan to keep more customers and recover failed payments.Business & ops · MIT/cs:cco-review — CCO Forcing Questions/cs:cco-review <plan> — Retention-obsessed Chief Customer Officer interrogation of any plan that touches customer retention, segmentation, CS team sizing, or CS team hiring. Use when gross retention is slipping, before approving CSM headcount, or when deciding which customer segments to keep or fire.Business & ops · MITChurn preventionReduce voluntary and involuntary churn through cancel flow design, save offers, exit surveys, and dunning sequences. Use when designing or optimizing a cancel flow, building save offers, setting up dunning emails, or reducing failed-payment churn. Trigger keywords: cancel flow, churn reduction, save offers, dunning, exit survey, payment recovery, win-back, involuntary churn, failed payments, cancel page. NOT for customer health scoring or expansion revenue — use customer-success-manager for that.Business & ops · MITCustomer success managerMonitors customer health, predicts churn risk, and identifies expansion opportunities using weighted scoring models for SaaS customer success. Use when analyzing customer accounts, reviewing retention metrics, scoring at-risk customers, or when the user mentions churn, customer health scores, upsell opportunities, expansion revenue, retention analysis, or customer analytics. Runs three Python CLI tools to produce deterministic health scores, churn risk tiers, and prioritized expansion recommendations across Enterprise, Mid-Market, and SMB segments.Business & ops · MIT