Index of every page on this site: llms.txt
All skills
nimrodfisher avatar

/business-metrics-calculator

@9449d36
Run it yourself

Standard business metric calculation with industry benchmarks. Use when calculating SaaS metrics (MRR, churn, LTV, CAC), e-commerce KPIs, or product analytics metrics with proper definitions.

Use this Skill: https://skilld.dev/gh/nimrodfisher/data-analytics-skills/business-metrics-calculator

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈55 tokens for metadata: the name and description. ≈611 when used: this file. ≈1.2k more on demand in 2 files.

Description uses 2.8% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈221 characters, or 2.8%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Business Metrics Calculator

When to use

  • Preparing a board or investor deck and need accurately defined metrics
  • The team disagrees on how a key metric (e.g., churn) should be calculated
  • Benchmarking performance against industry standards
  • Building a metrics report for a new business or new metric set
  • Validating that existing metric calculations match the standard definition

Process

  1. Identify the business model and period — confirm the model type (SaaS subscription, e-commerce, marketplace, product/app) and the calculation period (month, quarter, trailing 12M). Model type determines which metrics apply. See references/metric_definitions.md.
  2. Load and validate the underlying data — check for expected row counts, missing values, and plausible date ranges. A metrics report is only as good as the data feeding it.
  3. Calculate primary metrics — for SaaS: MRR, ARR, new MRR, churned MRR, expansion MRR, customer churn rate, revenue churn rate. For e-commerce: GMV, AOV, conversion rate, ROAS. Use scripts/saas_metrics.py or adapt for other models.
  4. Calculate unit economics — LTV (simple average and cohort-based), CAC, LTV:CAC ratio, payback period, and quick ratio. Document which assumptions were used for LTV lifetime.
  5. Compare to benchmarks — grade each metric against the industry benchmark thresholds in references/metric_definitions.md (good / average / poor). Flag anything outside the acceptable range.
  6. Produce the metrics report — assemble results into assets/metrics_report_template.md with trend charts, benchmark comparison, and 3–5 key insights. Document any definition choices that differ from industry standard.

Inputs the skill needs

  • Subscription or transaction data with at minimum: customer ID, date, value, status
  • Marketing spend data (for CAC calculation)
  • Monthly targets or goals (for vs-target comparisons)
  • The agreed-upon metric definitions (or default to industry standard)
  • Time period and any segmentation required (by plan, region, cohort)

Output

  • scripts/saas_metrics.py — calculates standard SaaS metrics from a subscriptions CSV; includes MRR waterfall, churn, LTV/CAC
  • references/metric_definitions.md — canonical definitions and benchmark thresholds by model type
  • assets/metrics_report_template.md — structured report: revenue metrics, customer metrics, unit economics, benchmark comparison, insights

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts2mo4 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    The business-metrics-calculator skill is a safe utility for defining and computing SaaS and e-commerce KPIs. It includes a Python script that performs standard arithmetic calculations on user-provided data without any network access, file system writing, or code execution risks.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: LOW · No issues

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at 9449d36. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last month.

Activeupdated 7 months ago

README badge

README badge for nimrodfisher/data-analytics-skills/business-metrics-calculator