Metric Definition Document skill for Claude and Codex
A metric definition document with the exact calculation, edge-case rules, and a worked example, so two teams asking the same question get the same number.
Install it once and Claude or Codex runs it for you. When your request matches, your AI loads the skill, asks for anything it is missing, and works through the template itself. Prefer to fill it in by hand? See the full prompt template.
Download the skill (.zip) · View SKILL.md
When it is used
Use when two teams report different numbers for the same metric and need one agreed, written definition. Do not use for building the dashboard or pipeline that computes the metric. Related topics: Data, Reporting, Communication.
What it will ask you for
- Metric name (free text, e.g. "What people call it")
- What it is meant to measure (longer free text)
- How it is calculated now (longer free text)
- Sources (longer free text)
- Where the numbers disagree (longer free text)
- Who uses it and for what (longer free text)
How it works
- State the business question the metric answers and the decisions it drives.
- Write the exact calculation with inclusions, exclusions, time grain, and the source of truth.
- Trace each reported disagreement to the edge case behind it, done when every gap has a named cause.
- Set an explicit rule for refunds, test accounts, timezones, deleted records, and late data.
- Add what the metric does not measure, a worked example, and the owner of future changes.
What you get
A definition document with calculation, scope rules, edge-case table, limits of use, a worked numeric example, and an owner.
What it watches out for
- Defining the formula but not the edge cases, which leaves the original disagreement in place.
- Naming a source of truth that teams cannot actually query.
- Omitting a change owner, so the definition drifts again within a quarter.
How to install
Claude.ai and the Claude desktop app
- Download the skill .zip.
- Open Settings, then Capabilities, and find Skills.
- Choose Upload skill and select the .zip.
- Ask Claude for help with the task. It loads the skill when your request matches.
Claude Code
- Download the skill .zip.
- Unzip it into ~/.claude/skills/ (or .claude/skills/ inside a project).
- Start a new session. Claude Code loads the skill when your request matches.
Codex
- Download the skill .zip.
- Unzip it into ~/.agents/skills/ (or .agents/skills/ inside a project).
- Codex picks it up on its own. Type $ and the skill name to use it, or just ask for the task.
Cursor
- Download the Cursor rule (.mdc).
- Save it in .cursor/rules/ inside your project.
- Cursor's agent applies the rule when your request matches its description.
AGENTS.md (Codex, Cursor, and other coding agents)
- Copy the AGENTS.md section.
- Paste it into AGENTS.md at the root of your repository, creating the file if needed.
- Coding agents that read AGENTS.md follow it when your request fits.