Agent skill

Churn Analysis

by shawnpang in shawnpang/startup-founder-skills

When the user needs to identify at-risk accounts, understand why customers are leaving, reduce churn rate, build health scores, design save plays, or create win-back campaigns.

MITAuto-check passedSales & Support

Install Churn Analysis

skills CLI
$ npx skills add shawnpang/startup-founder-skills --skill churn-analysis -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install shawnpang/startup-founder-skills churn-analysis --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/shawnpang/startup-founder-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/churn-analysis .claude/skills/churn-analysis && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
churn-analysis
GitHub stars
343
Token cost
~2.3k tokens
SKILL.md length
1,194 words
Files
1
Skills in repo
50
Repo updated
First seen
Licence
MIT

At a glance

When the user needs to identify at-risk accounts, understand why customers are leaving, reduce churn rate, build health scores, design save plays, or create win-back campaigns.

  • Works in 6 steps: Intake and baseline — Gather all… → Extract signals — Analyze four signal… → Score risk — Build a composite risk… → …
  • Needs to identify at-risk accounts
  • SKILL.md covers When to Use, Context Required, Workflow and Output Format, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Churn Analysis is an agent skill from shawnpang/startup-founder-skills. When the user needs to identify at-risk accounts, understand why customers are leaving, reduce churn rate, build health scores, design save plays, or create win-back campaigns.

Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Sales & Support, covering Referral and retention marketing and Customer success. It works with Slack. The repository describes itself as: AI agent skills for tech startup founders — fundraising, sales, product, recruiting, engineering, legal, ops, and growth. Works with Claude Code, Cursor, Codex, and any Agent… The licence is MIT.

When your agent uses it

  • Needs to identify at-risk accounts
  • Understand why customers are leaving
  • Reduce churn rate
  • Build health scores

Example prompts

  • “/churn-analysis”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Intake and baseline — Gather all available customer data: customer lists, support tickets, Slack/communication history, NPS scores, usage…
  2. Extract signals — Analyze four signal categories across every account: support signals, communication signals, usage signals, and…
  3. Score risk — Build a composite risk score (0-100) for each account using weighted signal categories. Higher score means higher risk.
  4. Generate save plays — For high-risk accounts, produce specific interventions: root cause hypothesis, recommended actions, talk tracks for…
  5. Build the weekly scorecard — Compile into a weekly risk report with account-by-account analysis, MRR at risk, trend data, signal…
  6. Design interventions — For each churn driver identified, design the appropriate intervention: product fix, CS outreach, cancel flow save…

What it can do on your machine

Read from SKILL.md and the folder at commit 4ad31b4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Churn Analysis loads about 2.3k tokens when it runs. Until then it costs about 48 tokens; SKILL.md has 1,194 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~48
When it runs · the whole SKILL.md, loaded when a task matches
~2.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from shawnpang/startup-founder-skills at commit 4ad31b4, republished under its MIT licence (© shawnpang). 1,194 words, ~2,318 tokens.

Download SKILL.mdSave it as .claude/skills/churn-analysis/SKILL.md (or your agent's skills folder).
name
churn-analysis
description
When the user needs to identify at-risk accounts, understand why customers are leaving, reduce churn rate, build health scores, design save plays, or create win-back campaigns.
related
feedback-synthesis, onboarding-flow, email-marketing
reads
startup-context

Churn Analysis

When to Use

Activate when a founder needs to identify at-risk accounts before they churn, diagnose churn drivers, build a customer health scoring system, design cancellation or save flows, recover failed payments, or re-engage lost customers. This includes prompts like "our churn is too high," "which customers are about to leave," "why are customers canceling," "build a customer health score," "set up dunning emails," or "create a win-back campaign." Especially relevant for seed/Series A teams managing customers manually without dedicated CS platforms like Gainsight or ChurnZero.

Context Required

  • From startup-context: business model (B2B/B2C, subscription/usage-based), current churn rate (logo and revenue), customer segments, pricing tiers, contract terms, product usage data availability, and current retention tooling.
  • From the user: available data sources (support tickets, Slack channels, NPS scores, usage logs, email logs, billing data), what "healthy" customer behavior looks like, any historical churn patterns, whether churn is primarily voluntary or involuntary, and the specific churn problem to solve.

Work with whatever data is available. Early-stage companies often lack formal CS systems — the skill works with support inboxes, Slack history, and spreadsheets.

Workflow

  1. Intake and baseline — Gather all available customer data: customer lists, support tickets, Slack/communication history, NPS scores, usage data, email logs, and billing records. Establish what "healthy" looks like and identify any known churn patterns.
  2. Extract signals — Analyze four signal categories across every account: support signals, communication signals, usage signals, and commercial signals (see framework below).
  3. Score risk — Build a composite risk score (0-100) for each account using weighted signal categories. Higher score means higher risk.
  4. Generate save plays — For high-risk accounts, produce specific interventions: root cause hypothesis, recommended actions, talk tracks for the CS conversation, and escalation triggers.
  5. Build the weekly scorecard — Compile into a weekly risk report with account-by-account analysis, MRR at risk, trend data, signal distribution, and recommended focus areas.
  6. Design interventions — For each churn driver identified, design the appropriate intervention: product fix, CS outreach, cancel flow save offer, dunning sequence, or win-back campaign.

Output Format

A churn risk report tailored to the specific request. This may include:

  1. Weekly risk scorecard — Every account scored and tiered with signal breakdown
  2. MRR at risk summary — Total revenue exposure by risk tier
  3. Save play briefs — For each red/orange account: root cause, recommended action, talk track, escalation trigger
  4. Intervention designs — Cancel flows, dunning sequences, or win-back campaigns as needed
  5. Trend analysis — Signal distribution changes over time

Frameworks & Best Practices

Signal Extraction Categories

Analyze every account across these four signal types:

Support signals: Ticket volume spikes, unresolved tickets, escalation language ("frustrated," "unacceptable," "cancel"), response time degradation, repeat issues on the same topic.

Communication signals: Silent accounts (no contact in 30+ days), frequency decline, sentiment shifts in Slack/email, champion disengagement (the main contact goes quiet), new stakeholder asking basic questions (signals champion departure).

Usage signals: Login frequency drops, feature abandonment (stopped using features they previously used regularly), shallow usage (logging in but not completing core workflows), no growth in usage over time, export/data download spikes (preparing to migrate).

Commercial signals: Discount requests, downgrade inquiries, payment failures, renewal proximity with no expansion discussion, competitor mentions in any channel.

Risk Scoring Model

Build a composite score (0-100) by weighting individual signals:

Signal SeverityPointsExamples
Critical25Explicit cancel request, competitor migration started, champion left
High15Usage dropped 50%+, 3+ unresolved escalations, payment failed twice
Medium8Login frequency declining, support sentiment negative, downgrade inquiry
Low3Slight usage dip, delayed renewal conversation, single missed payment

Multiple signals compound. An account with two high signals (30 points) and three medium signals (24 points) scores 54 — solidly in the Orange tier.

Risk Tiers and Response Timelines
TierScoreTimelineAction
Red70-100Action this weekExecutive outreach, save offer prepared, root cause identified
Orange40-69Action within 2 weeksCS outreach, intervention plan, monitor daily
Yellow20-39Monitor within 30 daysCheck-in scheduled, watch for signal escalation
Green0-19Routine check-inQuarterly review, expansion opportunity assessment
The Churn Driver Taxonomy

Categorize every churn event into one of these buckets:

  1. Value gap — Product does not solve the problem well enough
  2. Onboarding failure — Customer never reached the aha moment (churn in first 30-60 days)
  3. Support failure — Bad experience getting help
  4. Price sensitivity — Too expensive relative to perceived value
  5. Champion departure — Internal champion left the customer's company
  6. Business change — Customer's needs changed (acquisition, pivot, shutdown)
  7. Involuntary churn — Payment failure, not a conscious decision to leave
Show full SKILL.md (448 more words)Show less
Cancel Flow Design
  1. Ask why (required). Present 5-7 reason options matching the taxonomy. Include free-text. This data is essential.
  2. Offer a targeted save based on stated reason: "too expensive" gets a discount/downgrade, "missing feature" gets the roadmap, "not using it" gets a billing pause.
  3. Confirm with friction. One extra click showing what they lose. Show value, not guilt.
  4. Offer a pause. 30-60 day billing pause saves 15-25% of would-be churners in B2C and 10-15% in B2B.
  5. Offboard gracefully. Confirmation email with data export and a "we'd love to have you back" message.

A well-designed cancel flow saves 10-20% of users who initiate cancellation.

Dunning and Payment Recovery

Involuntary churn accounts for 20-40% of total churn and is the easiest to reduce. Retry failed charges 4-6 times over 10-14 days. Send card update links (pre-authenticated). Warn before cards expire (30 and 7 days prior). A good dunning system recovers 30-50% of failed payments.

Win-Back Campaigns

Target customers who churned 30-90 days ago. Beyond 90 days, response rates drop sharply. Segment by churn reason — users who left for fixable reasons (price, missing feature now shipped) reactivate at 2-3x the average. Expect 5-15% overall reactivation from a well-executed sequence.

  • feedback-synthesis — Analyze qualitative feedback from churned customers alongside quantitative churn data
  • onboarding-flow — When churn analysis reveals early-tenure churn as the primary driver, indicating an activation problem
  • email-marketing — Build full lifecycle email sequences (dunning, win-back, health-triggered re-engagement)

Examples

Example 1: Weekly risk scorecard

User: "I manage 45 accounts manually. Help me figure out which ones are about to churn."

Good output excerpt:

Weekly Risk Scorecard — March 15, 2026

MRR at Risk: $18,400 (12% of total MRR)

AccountMRRRisk ScoreTierKey Signals
Acme Corp$2,40082RedChampion left 3 weeks ago, usage down 60%, no response to last 2 emails
Beta Inc$1,20055Orange4 support tickets in 2 weeks (up from 1/month), asked about downgrade
Gamma LLC$80028YellowLogin frequency declining, approaching renewal with no expansion signals

Save Play — Acme Corp: Root cause: Champion departure. New contact has not been onboarded. Action: Executive-level outreach to identify new stakeholder. Offer a dedicated re-onboarding session. Prepare a 20% renewal discount if needed. Escalation trigger: No response within 5 business days — CEO-to-CEO email.

Example 2: Churn diagnostic

User: "Our monthly churn jumped from 4% to 7% over the last quarter. Help me figure out why."

Good output approach: Segment the increase by cohort, plan tier, and acquisition channel. Cross-reference with exit survey data to identify which churn drivers are increasing. Produce a root cause hypothesis linking the spike to specific changes (pricing, acquisition quality, product issues) and recommend targeted interventions for each driver.

© shawnpang, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/churn-analysis of shawnpang/startup-founder-skills.

Open the folder on GitHubat commit 4ad31b4

Compare with similar skills

Churn Analysis next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Churn Analysis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Churn Analysis this skillshawnpang/startup-founder-skills343—~2.3kAutomated safety check: PassMIT
Support Feedback Prioritizationamplitude/builder-skills159—~949Automated safety check: PassNone
Keep Churnjeremylongshore/tons-of-skills-marketplace2.8k—~1.6kAutomated safety check: NotesMIT
Biz CRM Strategyasgard-ai-platform/skills242—~2.2kAutomated safety check: PassMIT
Customer Supportericrisco/rsc-harness180—~2.9kAutomated safety check: PassMIT
Retentionericrisco/rsc-harness180—~2.8kAutomated safety check: PassMIT

Similar skills

  • Support Feedback Prioritization

    amplitude/builder-skills

    Pull Intercom tickets and Slack support messages from the past 7 days, classify each signal, enrich with CRM data (ARR, plan, renewal), score by customer value and churn risk, and output a tiered…

    159 GitHub stars~949 tokensUpdated 2 mo ago
    Sales & SupportAuto-check passed
  • Keep Churn

    jeremylongshore/tons-of-skills-marketplace

    Churn risk identification and intervention — scans health signals for at-risk accounts, classifies risk level (CRITICAL/HIGH/MEDIUM), and produces an intervention sequence per risk type.

    2.8k GitHub stars~1.6k tokensUpdated today
    Sales & SupportAuto-check: notes
  • Biz CRM Strategy

    asgard-ai-platform/skills

    Customer relationship management strategy — integrated framework with six pillars: customer segmentation (RFM/CLV), journey orchestration (cross-channel), CDP technology stack, loyalty-program…

    242 GitHub stars~2.2k tokensUpdated 4 mo ago
    Sales & SupportAuto-check passed
  • Customer Support

    ericrisco/rsc-harness

    A skill your agent uses when a live support ticket needs triage (intent, P1–P4 priority, SLA clock), an on-voice reply, not a raw template, de-escalation of an angry or churn-risk customer, or…

    180 GitHub stars~2.9k tokensUpdated today
    Sales & SupportAuto-check passed
  • Retention

    ericrisco/rsc-harness

    A skill your agent uses when revenue is leaking out the bottom of the funnel and you need a program to keep, score and win back customers — a customer health score, NPS, catching churn signals…

    180 GitHub stars~2.8k tokensUpdated today
    Sales & SupportAuto-check passed
  • 28 Community Building Global

    minhnv0807/ai-business-skills

    A skill your agent uses when a PERSONAL brand needs its OWN community — Skool, Mighty Networks, Discord, Circle, or Slack: a three-layer public, member, and inner-circle blueprint, seven-day…

    609 GitHub stars~3.6k tokensUpdated 28 days ago
    Marketing & SEOAuto-check passed

More from shawnpang/startup-founder-skills

All 50 skills in this repo
  • Accelerator Application

    shawnpang/startup-founder-skills

    When the user wants to apply to startup accelerators, incubators, or fellowship programs.

    343 GitHub stars~2.7k tokensUpdated 6 mo ago
    Auto-check passed
  • Architecture Design

    shawnpang/startup-founder-skills

    When the user needs to design or evaluate system architecture — service boundaries, data models, API contracts, infrastructure topology, database selection, or dependency analysis.

    343 GitHub stars~2.1k tokensUpdated 6 mo ago
    Auto-check passed
  • Board Update

    shawnpang/startup-founder-skills

    When the user needs to write a monthly or quarterly investor update, prepare a board deck, or communicate company progress to stakeholders.

    343 GitHub stars~2.3k tokensUpdated 6 mo ago
    Auto-check passed
  • Cicd Setup

    shawnpang/startup-founder-skills

    When the user needs to set up or improve CI/CD pipelines — GitHub Actions, GitLab CI, deployment automation, or says "set up CI", "automate deployment", "add tests to pipeline", "fix my build".

    343 GitHub stars~1.7k tokensUpdated 6 mo ago
    Auto-check passed
  • Code Review

    shawnpang/startup-founder-skills

    When the user asks for a code review, shares code for feedback, or says "review this", "check my code", "what's wrong with this".

    343 GitHub stars~1.9k tokensUpdated 6 mo ago
    Auto-check passed
  • Cold Outreach

    shawnpang/startup-founder-skills

    When a founder needs to write cold emails or LinkedIn messages to prospects, partners, or investors.

    343 GitHub stars~1.8k tokensUpdated 6 mo ago
    Auto-check passed

Works with

Questions about Churn Analysis

What does Churn Analysis do?

When the user needs to identify at-risk accounts, understand why customers are leaving, reduce churn rate, build health scores, design save plays, or create win-back campaigns. Churn Analysis is an agent skill from shawnpang/startup-founder-skills. When the user needs to identify at-risk accounts, understand why customers are leaving, reduce churn rate, build health scores, design save plays, or create win-back campaigns.

When should I use Churn Analysis?

Churn Analysis fits situations like: needs to identify at-risk accounts; understand why customers are leaving; reduce churn rate; build health scores.

How do I install Churn Analysis in Claude Code?

Run `npx skills add shawnpang/startup-founder-skills --skill churn-analysis -a claude-code`. Or copy the skill folder (skills/churn-analysis in shawnpang/startup-founder-skills) into .claude/skills/churn-analysis in your project. Claude Code loads it when a task matches its description.

How do I install Churn Analysis in Codex?

Run `npx skills add shawnpang/startup-founder-skills --skill churn-analysis -a codex`. Or copy the skill folder (skills/churn-analysis in shawnpang/startup-founder-skills) into .agents/skills/churn-analysis in your project. Codex loads it when a task matches its description.

Can I use Churn Analysis in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add shawnpang/startup-founder-skills --skill churn-analysis -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/churn-analysis, .gemini/skills/churn-analysis, .github/skills/churn-analysis and .opencode/skills/churn-analysis in your project.

What does Churn Analysis need to run?

SKILL.md names no scripts, command-line tools or credentials: Churn Analysis is instructions for the agent only.

Does Churn Analysis access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Churn Analysis safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Churn Analysis use?

Churn Analysis is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Churn Analysis use?

About 2.3k tokens (SKILL.md is roughly 9.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Churn Analysis?

Skills that share tags, products or a category with Churn Analysis: Support Feedback Prioritization (amplitude/builder-skills, 159 stars), Keep Churn (jeremylongshore/tons-of-skills-marketplace, 2.8k stars), Biz CRM Strategy (asgard-ai-platform/skills, 242 stars) and Customer Support (ericrisco/rsc-harness, 180 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Churn Analysis?

shawnpang (a GitHub user) maintains it in shawnpang/startup-founder-skills, which has 343 GitHub stars. The repository holds 50 skills in this directory. The repository was last updated on March 16, 2026.

Source: shawnpang/startup-founder-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.