AGENT SKILL

saas-metrics-coach

SaaS financial health advisor. Use when a user shares revenue or customer numbers, or mentions ARR, MRR, churn, LTV, CAC, NRR, or asks how their SaaS business is doing.

License 许可
MIT
最近更新
2026-11-15
Stars
★ 0
Forks
0

01 前言 Front Matter

name
saas-metrics-coach
license
MIT
metadata
{ "author": "Abbas Mir", "updated": 1772928000000, "version": "1.0.0", "category": "finance" }
description
SaaS financial health advisor. Use when a user shares revenue or customer numbers, or mentions ARR, MRR, churn, LTV, CAC, NRR, or asks how their SaaS business is doing.

02 资源文件 6

03 SKILL.md 正文

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.

04 同仓库更多 Skills

ziyabicilecommerce-hub
ziyabicilecommerce-hub/ai-cash-machine

youtube-full

Use when the user needs YouTube transcripts, video search, channel browsing, playlist extraction, or content monitoring. Trigger phrases: 'get the transcript for', 'search YouTube for', 'what are the latest videos on', 'list this playlist', 'monitor this channel', or any request involving a YouTube URL, video ID, or @handle. Do NOT use for downloading video or audio files, YouTube engagement data (likes, comments), or private/age-restricted videos.

★ 0
ziyabicilecommerce-hub
ziyabicilecommerce-hub/ai-cash-machine

x-twitter-growth

X/Twitter growth engine for building audience, crafting viral content, and analyzing engagement. Use when the user wants to grow on X/Twitter, write tweets or threads, analyze their X profile, research competitors on X, plan a posting strategy, or optimize engagement. Complements social-content (generic multi-platform) with X-specific depth: algorithm mechanics, thread engineering, reply strategy, profile optimization, and competitive intelligence via web search.

★ 0
ziyabicilecommerce-hub
ziyabicilecommerce-hub/ai-cash-machine

write-a-skill

Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, build, or author a new skill.

★ 0
ziyabicilecommerce-hub
ziyabicilecommerce-hub/ai-cash-machine

workflow-builder

Design and write deterministic multi-agent workflow scripts (.js files in .claude/workflows/) for Claude Code's Workflow tool. Use when a user wants to build, create, author, scaffold, or run a custom Claude Code workflow, orchestrate sub-agents (fan-out, pipeline, loop, judge-panel), or automate a repeatable multi-step task across fresh-context agents.

★ 0
ziyabicilecommerce-hub
ziyabicilecommerce-hub/ai-cash-machine

weekly-review

Use when someone wants to run a weekly review, close open loops, audit stalled projects and commitments, get their system back to trusted, restart a lapsed review habit, or says "/cs:weekly-review". Walks David Allen's three-phase loop — GET CLEAR, GET CURRENT, GET CREATIVE — with deterministic scripts that inventory open loops, gate the checklist with named gaps, and score commitment health 0-100.

★ 0
ziyabicilecommerce-hub
ziyabicilecommerce-hub/ai-cash-machine

webinar-marketing

When the user wants to plan, promote, run, or improve a webinar or virtual event to generate and convert demand. Use when the user mentions 'webinar,' 'virtual event,' 'online event,' 'live demo,' 'virtual summit,' 'workshop,' 'masterclass,' 'fireside chat,' 'roundtable,' 'registration funnel,' 'show-up rate,' 'attendance rate,' 'webinar promotion,' 'webinar follow-up,' or 'on-demand webinar.' Also use when they have a webinar that isn't converting — low registrations, low show-up, or attendees who don't buy — and want to diagnose and fix it. Covers the full funnel: registration, promotion, show-up, live engagement, live-to-close, and post-event nurture. Distinct from launch-strategy (full product launches) and email-sequence (lifecycle nurture) — this is the end-to-end webinar/event motion. NOT for in-person field events logistics, and NOT for generic lifecycle email (use email-sequence).

★ 0