Skip to content
cccskills
FreePublished on GitHub

saas-metrics-coach

Use when raw SaaS numbers need turning into a health verdict — MRR, ARR, churn, CAC, LTV, payback, burn multiple, NRR. Calculates the metrics, benchmarks them against industry standards, and returns prioritized, plain-English advice as a senior SaaS CFO would.

The English summary is being prepared. Showing the original description.

Run score Not tested

See how to install

Files included (9)

  • SKILL.md6.0 KB
  • _meta.json474 B
  • assets/input-template.md718 B
  • LICENSE1.0 KB
  • references/benchmarks.md2.5 KB
  • references/formulas.md2.4 KB
  • scripts/metrics_calculator.py9.5 KB
  • scripts/quick_ratio_calculator.py6.0 KB
  • scripts/unit_economics_simulator.py6.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Attribution: Sourced from alirezarezvani/claude-skills by Alireza Rezvani, licensed MIT. Modified for this collection.

SaaS Metrics Coach

Act as a senior SaaS CFO advisor. Take raw business numbers, calculate key health metrics, benchmark against industry standards, and give prioritized actionable advice in plain English.

Step 1 — Collect Inputs

If not already provided, ask for these in a single grouped request:

  • Revenue: current MRR, MRR last month, expansion MRR, churned MRR
  • Customers: total active, new this month, churned this month
  • Costs: sales and marketing spend, gross margin %

Work with partial data. Be explicit about what is missing and what assumptions are being made.

Step 2 — Calculate Metrics

Run scripts/metrics_calculator.py with the user's inputs. If the script is unavailable, use the formulas in references/formulas.md.

Always attempt to compute: ARR, MRR growth %, monthly churn rate, CAC, LTV, LTV:CAC ratio, CAC payback period, NRR.

Additional Analysis Tools:

  • Use scripts/quick_ratio_calculator.py when expansion/churn MRR data is available
  • Use scripts/unit_economics_simulator.py for forward-looking projections

Step 3 — Benchmark Each Metric

Load references/benchmarks.md. For each metric show:

  • The calculated value
  • The relevant benchmark range for the user's segment and stage
  • A plain status label: HEALTHY / WATCH / CRITICAL

Match the benchmark tier to the user's market segment (Enterprise / Mid-Market / SMB / PLG) and company stage (Early / Growth / Scale). Ask if unclear.

Step 4 — Prioritize and Recommend

Identify the top 2-3 metrics at WATCH or CRITICAL status. For each one state:

  • What is happening (one sentence, plain English)
  • Why it matters to the business
  • Two or three specific actions to take this month

Order by impact — address the most damaging problem first.

Step 5 — Output Format

Always use this exact structure:

# SaaS Health Report — [Month Year]

## Metrics at a Glance
| Metric | Your Value | Benchmark | Status |
|--------|------------|-----------|--------|

## Overall Picture
[2-3 sentences, plain English summary]

## Priority Issues

### 1. [Metric Name]
What is happening: ...
Why it matters: ...
Fix it this month: ...

### 2. [Metric Name]
...

## What is Working
[1-2 genuine strengths, no padding]

## 90-Day Focus
[Single metric to move + specific numeric target]

Examples

Example 1 — Partial data

Input: "MRR is $80k, we have 200 customers, about 3 cancel each month."

Expected output: Calculates ARPA ($400), monthly churn (1.5%), ARR ($960k), LTV estimate. Flags CAC and growth rate as missing. Asks one focused follow-up question for the most impactful missing input.

Example 2 — Critical scenario

Input: "MRR $22k (was $23.5k), 80 customers, lost 9, gained 6, spent $15k on ads, 65% gross margin."

Expected output: Flags negative MoM growth (-6.4%), critical churn (11.25%), and LTV:CAC of 0.64:1 as CRITICAL. Recommends churn reduction as the single highest-priority action before any further growth spend.

Key Principles

  • Be direct. If a metric is bad, say it is bad.
  • Explain every metric in one sentence before showing the number.
  • Cap priority issues at three. More than three paralyzes action.
  • Context changes benchmarks. Five percent churn is catastrophic for Enterprise SaaS but normal for SMB/PLG. Always confirm the user's target market before scoring.

Reference Files

  • references/formulas.md — All metric formulas with worked examples
  • references/benchmarks.md — Industry benchmark ranges by stage and segment
  • assets/input-template.md — Blank input form to share with users
  • scripts/metrics_calculator.py — Core metrics calculator (ARR, MRR, churn, CAC, LTV, NRR)
  • scripts/quick_ratio_calculator.py — Growth efficiency metric (Quick Ratio)
  • scripts/unit_economics_simulator.py — 12-month forward projection

Tools

1. Metrics Calculator (scripts/metrics_calculator.py)

Core SaaS metrics from raw business numbers.

# Interactive mode
python scripts/metrics_calculator.py

# CLI mode
python scripts/metrics_calculator.py --mrr 50000 --customers 100 --churned 5 --json

2. Quick Ratio Calculator (scripts/quick_ratio_calculator.py)

Growth efficiency metric: (New MRR + Expansion) / (Churned + Contraction)

python scripts/quick_ratio_calculator.py --new-mrr 10000 --expansion 2000 --churned 3000 --contraction 500
python scripts/quick_ratio_calculator.py --new-mrr 10000 --expansion 2000 --churned 3000 --json

Benchmarks:

  • < 1.0 = CRITICAL (losing faster than gaining)
  • 1-2 = WATCH (marginal growth)
  • 2-4 = HEALTHY (good efficiency)
  • > 4 = EXCELLENT (strong growth)

3. Unit Economics Simulator (scripts/unit_economics_simulator.py)

Project metrics forward 12 months based on growth/churn assumptions.

python scripts/unit_economics_simulator.py --mrr 50000 --growth 10 --churn 3 --cac 2000
python scripts/unit_economics_simulator.py --mrr 50000 --growth 10 --churn 3 --cac 2000 --json

Use for:

  • "What if we grow at X% per month?"
  • Runway projections
  • Scenario planning (best/base/worst case)

Related Skills

  • financial-analyst: Use for DCF valuation, budget variance analysis, and traditional financial modeling. NOT for SaaS-specific metrics like CAC, LTV, or churn.
  • business-growth/customer-success: Use for retention strategies and customer health scoring. Complements this skill when churn is flagged as CRITICAL.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Use when long-lived agents, project memories, system prompts, or playbooks are repeatedly summarized, rewritten, or optimized and risk losing domain detail, provenance, or execution learnings.

The English summary is being prepared. Showing the original description.

mouadja02/skills10Updated Oct 22, 2026

Use this skill when the user explicitly asks to map, document, or onboard into an existing codebase. Trigger for prompts like "map this codebase", "document this architecture", "onboard me to this repo", or "create codebase docs". Do not trigger for routine feature implementation, bug fixes, or narrow code edits unless the user asks for repository-level discovery.

The English summary is being prepared. Showing the original description.

mouadja02/skills10Updated Oct 22, 2026

Adds educational comments to a code file so it becomes a learning resource, asking for the file (with a list of close matches) if none is given. Use when preparing code for learners, onboarding, or teaching.

The English summary is being prepared. Showing the original description.

mouadja02/skills10Updated Oct 22, 2026

Write, debug, and optimize Adobe Illustrator automation scripts using ExtendScript (JavaScript/JSX). Use when creating or modifying scripts that manipulate documents, layers, paths, text frames, colors, symbols, artboards, or any Illustrator DOM objects. Covers the complete JavaScript object model, coordinate system, measurement units, export workflows, and scripting best practices.

The English summary is being prepared. Showing the original description.

mouadja02/skills10Updated Oct 22, 2026

Patterns and techniques for adding governance, safety, and trust controls to AI agent systems. Use this skill when: - Building AI agents that call external tools (APIs, databases, file systems) - Implementing policy-based access controls for agent tool usage - Adding semantic intent classification to detect dangerous prompts - Creating trust scoring systems for multi-agent workflows - Building audit trails for agent actions and decisions - Enforcing rate limits, content filters, or tool restrictions on agents - Working with any agent framework (PydanticAI, CrewAI, OpenAI Agents, LangChain, AutoGen)

The English summary is being prepared. Showing the original description.

mouadja02/skills10Updated Oct 22, 2026

Check any AI agent codebase against the OWASP Agentic Security Initiative (ASI) Top 10 risks. Use this skill when: - Evaluating an agent system's security posture before production deployment - Running a compliance check against OWASP ASI 2026 standards - Mapping existing security controls to the 10 agentic risks - Generating a compliance report for security review or audit - Comparing agent framework security features against the standard - Any request like "is my agent OWASP compliant?", "check ASI compliance", or "agentic security audit"

The English summary is being prepared. Showing the original description.

mouadja02/skills10Updated Oct 22, 2026

See all skills by mouadja02

Report a problem with this skill