tracking-net-revenue-retention-dynamics
Monitors NRR components with expansion, contraction, and churn decomposition across customer segments and cohorts. Use when analyzing revenue retention, decomposing NRR drivers, or assessing expansion revenue quality.
Best use case
tracking-net-revenue-retention-dynamics is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Monitors NRR components with expansion, contraction, and churn decomposition across customer segments and cohorts. Use when analyzing revenue retention, decomposing NRR drivers, or assessing expansion revenue quality.
Teams using tracking-net-revenue-retention-dynamics should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/tracking-net-revenue-retention-dynamics/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How tracking-net-revenue-retention-dynamics Compares
| Feature / Agent | tracking-net-revenue-retention-dynamics | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Monitors NRR components with expansion, contraction, and churn decomposition across customer segments and cohorts. Use when analyzing revenue retention, decomposing NRR drivers, or assessing expansion revenue quality.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Tracking Net Revenue Retention Dynamics Monitors NRR components with expansion, contraction, and churn decomposition across customer segments and cohorts. ## When To Use - Periodic (monthly/quarterly) NRR tracking for portfolio companies or investment targets - Diagnosing whether NRR changes are driven by expansion, contraction, or logo churn - Comparing cohort-level retention patterns to identify deterioration before it hits topline metrics - Evaluating expansion revenue quality — distinguishing price increases from genuine cross-sell/upsell - Benchmarking a company's NRR profile against stage-appropriate comps for underwriting or board reporting ## Inputs To Gather - **Revenue data by customer**: Monthly or quarterly ARR/MRR by account, with start dates for cohort assignment - **Revenue movement classification**: Each customer's period-over-period change categorized as new, expansion, contraction, churn, or reactivation - **Customer segmentation**: Segment labels (e.g., enterprise/mid-market/SMB, industry vertical, geo, product line) - **Cohort definitions**: Typically by customer start quarter or year; confirm whether cohort = first contract date or first revenue date - **Pricing change log**: Any list-price increases, packaging changes, or contractual escalators applied during the period - **Contract metadata** (if available): Contract term, renewal dates, multi-year vs. month-to-month, auto-renewal flags ## Workflow 1. **Validate revenue bridge completeness** - Confirm that Beginning ARR + New + Expansion − Contraction − Churn + Reactivation = Ending ARR within tolerance (< 0.5% gap) - If the bridge doesn't tie, identify the residual source before proceeding — common culprits: FX adjustments, mid-period reclassifications, or backdated bookings - Flag any customers with suspiciously large single-period swings for manual review 2. **Compute headline NRR and component rates** - NRR = (Beginning ARR − Contraction − Churn + Expansion) / Beginning ARR - Report gross retention (GRR) alongside NRR: GRR = (Beginning ARR − Contraction − Churn) / Beginning ARR - Calculate expansion rate, contraction rate, and logo churn rate separately - Present trailing-12-month and quarter-annualized figures; note which is being used [VERIFY: confirm company's standard NRR calculation methodology — some exclude reactivations, others include] 3. **Decompose by customer segment** - Break NRR, GRR, expansion, contraction, and churn rates by each segmentation axis - Identify which segments are accretive vs. dilutive to blended NRR - Size the ARR weight of each segment so that a high-NRR segment with 5% of ARR doesn't mask a low-NRR segment with 40% - Flag segments where contraction exceeds expansion — these are the priority risk areas 4. **Run cohort retention analysis** - Build a cohort retention matrix: rows = cohort vintage (start quarter), columns = quarters since start, cells = % of original cohort ARR retained - Identify whether newer cohorts retain better or worse than older ones at the same tenure — this reveals whether the company's retention is improving or degrading - Separate logo retention from dollar retention to distinguish "losing customers" from "customers spending less" - Note if cohorts are too small for statistical reliability [VERIFY: minimum cohort size for meaningful analysis given company's customer count] 5. **Assess expansion revenue quality** - Quantify how much expansion comes from price increases vs. seat/usage growth vs. cross-sell of new products - If price-driven expansion exceeds 30-40% of total expansion, flag durability risk — price increases face natural ceilings - Check whether expansion is concentrated in a small number of accounts (top-10 concentration) vs. broadly distributed - Examine expansion timing relative to contract renewals — expansion at renewal is stickier than mid-contract add-ons that could be reversed 6. **Trend and benchmark** - Plot NRR, GRR, and component rates over at least 4-6 quarters to identify trajectory - Compare against relevant benchmarks: >120% NRR is elite for enterprise SaaS, 110-120% is strong, <100% signals net shrinkage [VERIFY: adjust benchmarks for company stage, ACV, and business model] - Highlight inflection points and correlate with known events (pricing changes, new product launches, market shifts, sales team changes) ## Output The tracking report should include: - **Executive summary**: Current NRR/GRR with trend direction, top 2-3 drivers of change, and key risk flags - **Revenue bridge table**: Beginning ARR → Ending ARR with all movement categories, in dollars and as rates - **Segment decomposition table**: NRR, GRR, expansion rate, contraction rate, churn rate by segment, with ARR weighting - **Cohort retention matrix**: Dollar retention and logo retention by vintage, with color-coding for above/below-target performance - **Expansion quality breakdown**: Pie or waterfall showing price vs. seat/usage vs. cross-sell contribution - **Trend charts**: NRR and components over time with benchmark bands - **Watch list**: Specific accounts or segments flagged for elevated churn/contraction risk with recommended actions ## Quality Checks - Revenue bridge ties to within 0.5% — if not, the residual is explained and sourced - NRR and GRR are calculated on a consistent base (beginning-of-period ARR, not average or ending) - Segment-level rates weight back to the blended total — arithmetic checks pass - Cohort matrix doesn't include customers who churned and reactivated in the same cohort without flagging it - Expansion decomposition accounts for 100% of expansion dollars — no unexplained residual - All benchmark comparisons specify the source, vintage, and peer set used [VERIFY: benchmark data source and recency] - Assumptions about annualization method (quarter × 4 vs. trailing-12-month) are stated explicitly - Any customer representing >5% of total ARR is individually named in the watch list assessment
Related Skills
tracking-treatment-response
Monitors treatment response using imaging criteria, biomarkers, and clinical assessment with documentation. Use when assessing treatment response, documenting disease status, or tracking progression.
tracking-incidental-findings
Manages incidental finding follow-up using ACR White Paper recommendations. Use when tracking incidentalomas, scheduling follow-up imaging, or managing unexpected findings.
tracking-hospital-acquired-conditions
Monitors and documents hospital-acquired infections, pressure injuries, and other preventable conditions. Use when tracking HACs, documenting nosocomial events, or reporting patient safety indicators.
tracking-developmental-milestones
Applies ASQ and CDC milestone tracking with referral criteria for developmental delays. Use when tracking development, screening for delays, or documenting milestone achievement.
tracking-clinical-deterioration
Implements early warning score monitoring (NEWS, MEWS) with escalation criteria. Use when monitoring clinical deterioration, calculating early warning scores, or triggering rapid response criteria.
employee-retention-agreement
Drafts enforceable U.S. Employee Retention Agreements (ERAs) for M&A, restructurings, and leadership transitions. Covers cash/equity/hybrid incentives, 409A compliance, termination scenarios, change-in-control triggers, restrictive covenants, and 280G golden parachute analysis. Trigger when drafting retention bonus agreements, executive compensation packages, or key-employee continuity contracts for business transitions.
document-retention-policy
Drafts board-adoptable document retention policies for nonprofit organizations with IRS-grounded retention schedules, destruction protocols, and litigation hold procedures. Use when creating retention policies, records management governance, document destruction schedules, or compliance frameworks for 501(c)(3) and other tax-exempt entities.
data-retention-and-destruction-policy
Drafts a law firm Data Retention and Destruction Policy covering practice-area retention schedules, secure destruction procedures, legal hold protocols, and compliance infrastructure. Trigger when establishing or updating records management frameworks, drafting retention schedules by matter type, or implementing secure destruction procedures for paper and electronic records.
tracking-sector-rotation
Monitors sector performance rotation with factor exposure and macro sensitivity analysis. Use when tracking sector rotation, analyzing factor exposures, or identifying sector trends.
tracking-regulatory-changes
Monitors regulatory developments with impact assessment, gap analysis, and implementation timeline planning. Use when tracking regulatory changes, assessing compliance gaps, or planning implementation.
tracking-consensus-estimates
Monitors sell-side consensus estimates with revision tracking and surprise analysis. Use when tracking estimate revisions, analyzing consensus changes, or monitoring analyst expectations.
modeling-revenue-forecasts
Builds bottom-up revenue models from segment-level drivers with assumption documentation. Use when forecasting revenue, modeling growth drivers, or building segment-level projections.