metrics-definition

metrics-definition is a skill for Claude Code from hollandkevint/data-product-operator. It costs 71 tokens per session (949 once invoked), scanned A, original, MIT.

A guide for defining business metrics precisely, including what a number measures, how it is calculated, and the time period and level of detail it covers.

In plain words
What is it for?
Use it to specify KPIs, write metric definitions and SQL logic, document daily or weekly reporting rules, build a metrics catalogue, and resolve conflicting calculations.
Why use it?
It prevents teams from using the same label, such as revenue or active users, for different calculations and making decisions from numbers they interpret differently.

Skill for Claude Code

Written for Claude Code: user-invocable in frontmatter.

Part of the data-product-operator plugin — 24 skills, 7 commands, 1 MCP server shipped together

Good fit Use it to specify KPIs, write metric definitions and SQL logic, document daily or weekly reporting rules, build a metrics catalogue, and resolve conflicting calculations.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/hollandkevint/data-product-operator/metrics-definition
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add hollandkevint/data-product-operator --skill metrics-definition
Clone the repo
git clone --depth 1 https://github.com/hollandkevint/data-product-operator

Made for: Claude Code.

Or install data-product-operator, the plugin that ships this one along with the rest of its 24 skills, 7 commands, 1 MCP server.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for metrics-definition

README.md
[![agentmods](https://agentmods.dev/badge/skills/hollandkevint/data-product-operator/metrics-definition/github.svg)](https://agentmods.dev/skills/hollandkevint/data-product-operator/metrics-definition)
Your own site
<a href="https://agentmods.dev/skills/hollandkevint/data-product-operator/metrics-definition"><img src="https://agentmods.dev/badge/skills/hollandkevint/data-product-operator/metrics-definition/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for metrics-definition

Your own site · 80×15
<a href="https://agentmods.dev/skills/hollandkevint/data-product-operator/metrics-definition"><img src="https://agentmods.dev/badge/skills/hollandkevint/data-product-operator/metrics-definition.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 71 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 949 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00071 $0.00949
Opus 5 $0.00036 $0.00475
Sonnet 5 $0.00014 $0.00190
Haiku 4.5 $0.00007 $0.00095

Measured 12d ago against content hash 801e3c0de54d, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

metrics-definition scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/metrics-definition/SKILL.md · 89 lines

How it starts

The opening of the file, as written. The whole thing — 89 lines — stays where its author put it; the contents beside it link to each section on GitHub.

The Core Problem

"47 dashboards and no answers." The failure mode is building metrics without agreeing on what they mean. "Revenue" means three different things to three different teams. "Active users" has no agreed-upon time window. Fix the definitions before building the dashboards.

Metric Definition Template

Every metric must specify:

  • Name: Human-readable, follows naming convention (see below)
  • Business definition: One sentence a non-technical person understands
  • SQL logic: Exact calculation including numerator, denominator, and filters
  • Grain: What level is this calculated at? (daily, weekly, per-user, per-account)
  • Time window: What period does this cover? (trailing 7 days, calendar month, since signup)
  • Dimensional attributes: What can you slice this by? (region, product line, customer segment)
  • Owner: Who maintains this definition?
  • Update cadence: How often does this refresh?
  • Known edge cases: What situations produce unexpected results?

NEVER define a metric without specifying grain and time window. "Monthly active users" means nothing until you define what "active" means and whether "monthly" is calendar month or trailing 30 days.

Outcome Metric Trees

Connect metrics from business outcomes down to leading indicators:

Business outcome: Reduce hospital readmissions 10%
  Product outcome: Clinical decisions made 3x faster
    Feature outcome: Risk scores updated in real-time
      Leading indicator: Query latency under 1 second

Every metric at a lower level should causally influence the level above. If you can't draw the causal link, the metric doesn't belong in the tree.

Trust Metrics

Alongside performance metrics, track trust:

  • Data accuracy rate: Percentage of values matching gold standard (target: 99.9%)
  • Query response time: P95 latency for consumer queries (target: <3 seconds)
  • Data freshness: Time between source update and availability (target: within SLA)
  • Support response time: How fast you resolve data questions (target: <24 hours)
  • Incident count: Zero algorithmic bias incidents, zero data breaches

Read the full file on GitHub · 89 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 89 lines · 71 tokens per session scan A 801e3c0de54d

Subscribe to this mod's changes

metrics-definition is a skill published in the GitHub repository hollandkevint/data-product-operator (3 stars, last pushed yesterday), licensed MIT. It adds 71 tokens to every session and 949 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

fechar-dia

Fecha o dia de trabalho. Avalia as 3 do dia, classifica o que não fechou, semeia o movimento.

pe-menezes/pm-chief-of-staff · 31 tokens

processar-reuniao

Transforma uma reunião que aconteceu em nota estruturada e propaga o que importa. A pessoa cola a transcrição, o resumo automático ou as notas cruas. Use quando a pessoa disser "processa essa reunião", "processa esse 1:1", "olha o que rolou na reunião", colar uma transcrição pedindo organização, ou…

pe-menezes/pm-chief-of-staff · 99 tokens

preparar-conversa

Monta a pauta antes de uma conversa que importa. 1:1 com liderado, 1:1 com o próprio líder, alinhamento com par ou stakeholder. Use quando a pessoa disser "prepara o 1:1 com [nome]", "monta a pauta", "vou falar com [nome]", "tenho reunião com [nome], me prepara", "/preparar-conversa". NÃO use pra processar a conversa…

pe-menezes/pm-chief-of-staff · 106 tokens

classify

Assess or re-assess the innovation-vs-implementation classification and 0-100 innovation weight for one feature or the whole Product/Features set, then regenerate the ranked features-index.md and run the portfolio sanity check. Use when features need (re)ranking or after editing the UVP.

InSciCo/i-framework · 62 tokens

feature

Create or revise a single Product feature file with a complete user story, Given/When/Then acceptance criteria, and an innovation-vs-implementation classification. Use when adding one feature to Product/Features/, or refining an existing feature, outside a full /innovate run.

InSciCo/i-framework · 57 tokens

iflow

The front door / orchestrator for the I-Framework. Reads the Product/ folder, determines which stage (Intent, Ideation, Innovation) you're in from the artifacts and their gates, reports the risk-burndown state, and routes you to the next step. Use to start or resume the Intent → Ideation → Innovation flow.

InSciCo/i-framework · 72 tokens