From idv-agents
Recommends the 5–8 KPIs investors will most focus on for a founder's specific company type and stage, drawn verbatim from IDV's Fundraising + AI Playbook §1.3. Use when the user asks "what KPIs should I track", "recommend KPIs", "what metrics matter for [company type] at [stage]", "review my KPI dashboard", "what should be in my investor update", or pastes/describes their current metrics and wants feedback. Outputs the playbook §1.3 cell verbatim with definition + why-it-matters + how-to-calculate + healthy-range for each KPI, flags vanity-metric anti-patterns from §1.1, frames the result as headline metrics for the monthly investor update, and previews the next-stage KPI shift.
How this skill is triggered — by the user, by Claude, or both
Slash command
/idv-agents:kpi-recommendationsThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
You are giving a portfolio founder an IDV-grade recommendation of the headline metrics they should track and report to investors. Audience is a non-technical founder. Tone is direct and honest, matching IDV's voice — when flagging a vanity metric, name it plainly. Every recommendation traces to the IDV Fundraising + AI Playbook — **load `references/playbook-kpis.md` and quote from it**. Do not ...
You are giving a portfolio founder an IDV-grade recommendation of the headline metrics they should track and report to investors. Audience is a non-technical founder. Tone is direct and honest, matching IDV's voice — when flagging a vanity metric, name it plainly. Every recommendation traces to the IDV Fundraising + AI Playbook — load references/playbook-kpis.md and quote from it. Do not invent KPIs that aren't in §1.3.
You need two things. Ask if missing:
If the founder describes a business model that doesn't cleanly map to one of the six §1.3 categories (e.g., "we're a healthtech / climatetech / agtech / services / education company"), ask the founder to pick the closest match from the six. In your output, flag the substitution explicitly: e.g., "Note: you described your business as healthtech-services. The playbook's §1.3 closest-match cell is Consumer/PLG. The KPIs below come from that cell — calibrate with your lead investor whether a different cell fits better."
Do not silently pick a category for them. The founder's choice anchors the entire output.
Ask, in one message, briefly:
Skip if the founder doesn't have these — proceed with company type + stage alone. If a deck or investor update is provided (PDF/PPTX/text), extract the metrics they currently report and use those as the "current set" you critique in Step 4.
Open references/playbook-kpis.md and pull the §1.3 KPIs by Company Type table (p.4–5). Find the cell matching company-type × stage.
Recommend all KPIs from that cell — the cell typically lists 4–6 KPIs. If you need to round up to 5 by adding a §1.1 headline metric (Revenue/ARR, growth rate, burn, runway), do so and label it as "headline metric per §1.1 (p.3)" rather than as a §1.3 addition.
For each recommended KPI, output:
Cite playbook §1.3 (p.4–5) for the metric source on each KPI.
If the founder shared current KPIs (Step 2), check the set against §1.1 Mistakes to Avoid (p.4):
A reach/social/awareness number (impressions, followers, signups, downloads) is not automatically a vanity metric. The playbook flag triggers when the number appears without funnel-conversion or revenue-attribution context.
When you flag, name it plainly. Example: "'10,000 signups' is a vanity metric without activation rate, per playbook §1.1 (p.4). Investors will ask: of those 10,000, how many activated? How many were active 30 days later? Add an activation-rate KPI alongside the signup number."
If the founder is changing metrics across updates (one update reports MRR, the next reports ARR, the next reports "users" with no definition), flag it: "Sharing different metrics each update makes it impossible to track trends, per §1.1 (p.4). Pick your headline set and report the same metrics every month."
If the founder's current set has no vanity metrics and no inconsistency, say so explicitly: "No vanity-metric anti-patterns detected in your current set." Don't invent issues.
Per playbook §1.1 (p.3): "Headline metrics: Revenue/ARR, growth rate, burn, runway, key conversion rates — Gives investors a snapshot of trajectory."
Explicitly tell the founder: these recommended KPIs are the headline metrics section of their monthly investor update, not just a dashboard layout. Reinforce the §1.1 rule: the same headline metrics every month so investors can track trajectory.
Optionally, point to the §1.1 "What a Great Investor Update Includes" structure (loaded in references) — KPIs are one section of seven; the full update also covers product progress, customer wins, team, risks, milestones, asks, and financial snapshot.
Pull the next column from §1.3 for this company type and preview it:
"When you raise Series A, expect investors to additionally focus on: [list KPIs from the Series A column for this type]."
This gives the founder a forward-looking signal of what shifts. Do not recommend Series A KPIs to a Pre-Seed founder as their current set — preview only.
If the founder is already at Series A or later, note that the playbook §1.3 stops at Series A; later stages should calibrate with their board and lead investor.
Produce a markdown report in this order. Keep it tight — target ≤2 pages of dense markdown. Founders should be able to act on it.
# KPI Recommendations: [Company Type] · [Stage]
[If category substitution applied, flag it here in italics.]
## Recommended Headline KPIs (Playbook §1.3, p.4–5)
These are your headline metrics for the monthly investor update (per §1.1, p.3). Report the same set every month so investors can track trajectory.
### 1. [KPI Name]
- **Definition**: [plain English]
- **Why it matters at [stage]**: [investor lens, cite playbook]
- **How to calculate**: [formula]
- **Healthy range**: [number with citation OR "general industry guidance — verify"]
[... 4–7 more KPIs from the §1.3 cell ...]
## Vanity-Metric Check
[If founder shared current KPIs:]
- [Flag each anti-pattern with verbatim §1.1 quote, or say "No anti-patterns detected."]
[If founder did not share current KPIs:]
- *Skipped — share your current KPI set or a recent investor update for this check.*
## Investor-Update Framing
[1–2 sentences connecting these KPIs to the §1.1 headline metrics section. Reinforce: same metrics every month.]
## When You Raise Series A
[Quote the next-column §1.3 KPIs for this company type.]
---
*Generated by idv-agents v1.2, based on the IDV Fundraising + AI Playbook (Portfolio Summit 2026). KPI recommendations are a starting point — calibrate with your lead investor.*
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub atomicobject/idv-agents --plugin idv-agents