kpi-reporting — Codex skill: what it does, how to install
Generates executive scorecards, WBR and MBR updates, tracks pacing against targets, and highlights validated drivers.
npx skills add openai/plugins --skill kpi-reporting -a codexWhat kpi-reporting does
This skill structures operational reviews and recurring cadence updates like WBRs. It establishes metric boundaries and sets freshness cutoffs before drafting. Topline numbers are split into components. The breakdown focuses strictly on actionable slices like volume versus rate.
Inspection covers structured data catalogs and internal project documentation. If an authoritative data source is unavailable, execution stops immediately. The skill explicitly rejects weaker proxies and placeholder actuals. It leaves causal investigations to $metric-diagnostics rather than guessing unproven explanations.
What it helps with
- build executive WBR or MBR scorecards from production data
- decompose a headline KPI into volume, rate, or funnel drivers
- evaluate performance variance against pacing models and goals
- identify conflicting metric definitions across team docs and warehouses
Example prompts for the agent
- Generate a WBR scorecard for active subscriptions compared against our quarterly plan.
- Prepare an MBR readout for checkout conversion and break down the validated drivers.
- Review last month's churn rate against target and highlight operational takeaways.
How to install kpi-reporting
1Skills CLI (Vercel)
npx skills add openai/plugins --skill kpi-reporting -a codex2Manually: put the files in place
.agents/skills/kpi-reporting/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add openai/plugins --skill kpi-reporting -a claude-code2Manually: put the files in place
~/.claude/skills/kpi-reporting/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/kpi-reporting/
Manually: put the files in place
.cursor/skills/kpi-reporting/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openai/plugins kpi-reporting2Manually: put the files in place
.github/skills/kpi-reporting/SKILL.mdPlatform CLI
gemini skills install https://github.com/openai/plugins --path plugins/data-analytics/skills/kpi-reportingManually: put the files in place
.devin/skills/kpi-reporting/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: Codex skills: how to install, where they live, how to call them
Questions about kpi-reporting
How to install kpi-reporting in Codex?
Run npx skills add openai/plugins --skill kpi-reporting in your terminal.
What does kpi-reporting do?
It converts raw business metrics into structured executive readouts, tracking progress against goals and highlighting verified drivers.
What happens if a critical data source is missing?
The skill halts the readout and asks for access, refusing to substitute weaker data or placeholders for required truth sources.
