skills/cs-metrics-explainer/SKILL.md
Takes a CS metric and produces a comprehensive explanation including definition, calculation method, industry benchmarks, what drives it, how to influence it, and common misinterpretations. Use when asked to explain a CS metric, understand NRR or GRR, learn about health scoring, define a retention metric, understand what a metric means and how to move it, or when a CSM needs to build commercial and analytical fluency on CS metrics. Also triggers for questions about CS KPIs, metric definitions, benchmark ranges, how metrics are calculated, what good looks like for a specific metric, or how to explain a CS metric to leadership.
npx skillsauth add stephenrogan/csm-skills cs-metrics-explainerInstall 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.
Takes any CS metric and produces a complete breakdown: what it measures, how to calculate it, what good looks like, what drives it, how to influence it, and how to present it to different audiences. The analytical fluency tool for CSMs levelling up their commercial and data skills.
Provide:
For each metric, the skill produces:
What it measures in one sentence, with no jargon.
The exact formula with an example using realistic numbers.
What "good" looks like by company stage, segment, and motion:
| Context | Good | Median | Concerning | |---------|------|--------|-----------| | [Company stage / segment / motion] | [range] | [range] | [range] |
The 3-5 factors that most influence this metric, ranked by impact.
Specific actions a CSM or CS leader can take to move the metric.
How the metric is frequently misunderstood or misused.
How to explain this metric to different audiences (CFO, CRO, board, team).
Definition: The percentage of revenue retained from existing customers over a period, including expansion and contraction. Measures whether you are growing or shrinking from your existing base.
Calculation: NRR = (Starting ARR - Churn - Contraction + Expansion) / Starting ARR * 100
Example: Starting ARR EUR 10M, Churn EUR 500k, Contraction EUR 200k, Expansion EUR 1.2M NRR = (10M - 500k - 200k + 1.2M) / 10M = 115%
Benchmarks:
| Context | Good | Median | Concerning | |---------|------|--------|-----------| | Enterprise SaaS | >120% | 110-120% | <105% | | Mid-Market SaaS | >110% | 100-110% | <95% | | SMB SaaS | >100% | 90-100% | <85% |
What drives it: Churn rate (negative impact), expansion rate (positive impact), contraction rate (negative), pricing power, product-market fit.
How to influence it: Reduce churn through proactive risk management. Drive expansion through adoption depth and value evidence. Reduce contraction by maintaining product relevance and stakeholder coverage.
Misinterpretation: NRR >100% does not mean you are not losing customers. It means expansion from remaining customers exceeds the revenue lost. You can have 15% logo churn and still show 110% NRR if your expanding accounts grow enough. Track logo churn separately.
Present to CFO as: "For every EUR 1 of revenue we started the year with from existing customers, we ended the year with EUR 1.15. Our existing customer base is a growing asset, not a depreciating one."
Definition: The percentage of revenue retained from existing customers, excluding expansion. Measures the health of your base without the offset of growth.
Calculation: GRR = (Starting ARR - Churn - Contraction) / Starting ARR * 100. Maximum is 100% (expansion is excluded).
Benchmarks:
| Context | Good | Median | Concerning | |---------|------|--------|-----------| | Enterprise SaaS | >95% | 90-95% | <88% | | Mid-Market SaaS | >90% | 85-90% | <80% | | SMB SaaS | >85% | 75-85% | <70% |
What drives it: Product-market fit, customer health, service quality, competitive positioning, pricing appropriateness.
Misinterpretation: GRR is harder to hide behind than NRR. A company with 85% GRR and 115% NRR is losing a lot of customers but making up for it with aggressive expansion. That works until expansion slows -- then GRR becomes the real retention story.
Present to board as: "We retained [X]% of our existing revenue base. This is our loyalty metric -- it tells us whether customers are staying and at what level, independent of growth."
For each, the skill produces the same 7-element breakdown.
## Metric Explainer: [Metric Name]
### Definition
[One sentence]
### Calculation
[Formula + worked example]
### Benchmarks
[Table by context]
### What Drives It
1. [Factor 1 -- highest impact]
2. [Factor 2]
3. [Factor 3]
### How to Influence It
- [Action 1]
- [Action 2]
### Common Misinterpretations
- [Misinterpretation 1 with correction]
### How to Present It
- To CFO: [framing]
- To CRO: [framing]
- To board: [framing]
- To your team: [framing]
development
Structures the CSM's week based on their portfolio status, upcoming events, overdue items, and strategic priorities. Produces a time-blocked plan that balances reactive demands with proactive account management. Use when asked to plan a week, structure daily priorities, build a weekly schedule, allocate time across accounts, manage a busy week, or when a CSM feels overwhelmed and needs to determine where to focus. Also triggers for questions about time management, weekly planning, account prioritisation for the week, daily priority setting, or how to balance competing demands across a portfolio.
development
Constructs a compelling value narrative for a customer account by connecting product usage to business outcomes in the customer's language. Produces different versions for different audiences -- the champion, the CFO, the board. Use when asked to build a value story, articulate ROI, create a business case for the customer, prepare value evidence for a renewal or QBR, or when a CSM needs to translate usage metrics into business impact the customer will recognise. Also triggers for questions about value articulation, ROI storytelling, customer business case, value evidence, or how to prove the product is worth the investment.
data-ai
Takes raw usage data -- even a spreadsheet export or pasted metrics -- and identifies patterns, risks, and opportunities. Translates product analytics into account intelligence a CSM can act on. Use when asked to interpret usage data, analyse product metrics, make sense of a usage report, identify trends in customer behaviour, flag usage-based risks, or when a CSM has data but does not know what it means for the account. Also triggers for questions about usage analysis, product analytics interpretation, behavioural pattern detection, usage-based risk identification, or turning raw metrics into actionable insight.
development
Builds a structured 30-60-90 day plan for a CSM taking over a new book of accounts or joining a new team. Prioritises accounts by risk and value, identifies immediate relationship actions, and structures the ramp to full productivity. Use when asked to plan a book transition, create a new CSM onboarding plan, structure a territory takeover, build a 30-60-90 plan for a new role, or when a CSM is inheriting accounts and needs a systematic approach to getting up to speed. Also triggers for questions about account transitions, new book ramp-up, CSM onboarding to a portfolio, territory planning, or how to take over accounts from another CSM.