shipped@di-atomic/kpi-advisor · v0.1.1 · beta

Stop asking if your numbers are good. Ask who’s reading them.

A 26-month CAC payback read as “playing long” to a 2021 growth partner and un-fundable to a 2024 efficiency fund. Same number, opposite verdicts. kpi-advisor reads your metrics through the investor lens you pick, grades every one against a dated benchmark, and refuses to tell you they look fine.

For founders who can calculate their numbers but cannot yet read them the way the person across the table reads them — and for operators whose business does not run on SaaS maths at all.

Chalk diagram: one box reading 26 months, with arrows to 2021 playing long on the left and 2024 un-fundable on the right in gold
Built by Di-Atomic Marketing & compliance agency REACH / CLP vocabulary-aware 7-language team Clients incl. ONYX Radiance, Pamit Group
55registry items, each with a live source
4investor lenses on the same numbers
14institutional learnings
5scripts gate the agent’s own output
Installopvs skills install @di-atomic/kpi-advisor

Then say “read my numbers like a CFO”, “would these pass a Series A?”, or “we have four months of runway, what do I do?”

The difference a benchmark makes

What most tools say
NRR: 97% → "Your retention looks solid."

An un-anchored hedge. It launders a leaky bucket as health and gives you permission to do nothing for another quarter.

What kpi-advisor says
NRR: 97% → SMB median (Optifai, 939 cos) → best-in-class >120% → WATCH: renting, not compounding

A position, the dated benchmark that grades it, and what evidence would change the read. A script fails the output if the hedge comes back.

Anti-sycophancy is the product here, not a tone setting.

What you actually get

🔭

Four lenses, never picked silently

Growth VC, efficiency fund, bootstrapper, or regulated B2B distributor. It asks which one you want, because silently assuming growth-VC is how a bootstrapper ends up chasing somebody else’s metric.

📑

Every verdict carries a citation

Each HEALTHY, WATCH or CRITICAL call points at a specific dated benchmark, so you can check whether it even fits your segment and year. Benchmarks repriced after 2023; most advice did not.

⚖️

It will not invent a number

If a metric is missing from every source, it asks you for it or refuses to produce the brief. A guessed KPI delivered with confidence is the most dangerous output this skill could hand you.

Inside the read

Four chalk boxes in a row: growth VC with NRR, efficiency with CAC payback, bootstrap with ARPU, and distributor with reorder highlighted in gold
Each lens stares at a different metric first. A growth VC opens with NRR and walks below 100%. An efficiency fund opens with CAC payback. A bootstrapper cares about ARPU and owner cash-flow, not your TAM slide.
A 44 percent logo churn reading marked at the same point on two scales: critical on the SaaS scale, healthy on the distributor scale
The distributor branch is the part no other skill ships. Wholesale runs roughly 44% logo churn as normal and about 80% of value creation comes from existing accounts, so SaaS thresholds mis-flag a healthy chemicals distributor as CRITICAL.

One read, start to finish

you   → "read my numbers like a CFO"
      → gathers: GA4 + PostHog MCP, or typed, or from peers
      → branches on business model FIRST
      → asks which investor lens (never assumes)
      → benchmarks each metric against the CURRENT year
      → surfaces red flags, capped at 3 ranked fixes
      → hands back a 5-part board talk-track

Recommendations are capped at three on purpose. A list of eleven priorities is a list of zero priorities.

Where it stops

Three chalk lines reading never invent a number, never an uncited verdict, never more than three
kpi-advisor is guidance-only. There is no backend and nothing to provision: the agent’s own model reads SKILL.md and runs the decision tree. It does not measure — GA4 and PostHog do that — and it does not act on what it finds.
Five chalk boxes connected left to right: gather, branch, lens, benchmark, and top 3 highlighted in gold
It owns the number, not the play. A churn verdict routes to retention, which owns the save. Pipeline and CAC signal arrive from sales-pipeline. This skill decides what the numbers mean and hands the action to a peer.
Why this exists

I built this by dogfooding the same stack I run for clients.

kpi-advisor is one skill in the system behind Di-Atomic — the marketing & compliance agency that runs cognitoAI, SpiderIQ and OPVS. The distributor lens exists because my own clients sell regulated product to accounts that re-order, and every SaaS-trained advisor I pointed at their numbers produced confident, well-formatted, wrong answers.

Or read the launch story and the changelog.