metric-narrative

Write reviewed KPI and metric narratives from supplied data, definitions, and assumptions. Use when Codex is asked to explain a metric movement, summarize dashboard results, write an executive metric

SKILL.md

GitHub

Metric Narrative

Core Workflow

  1. Identify the metric, definition, time period, comparison baseline, segment, and intended audience.
  2. Verify supplied numbers against metric definitions and source notes before writing conclusions.
  3. Separate observed facts, plausible drivers, assumptions, data quality issues, and recommended follow-up checks.
  4. Explain direction, magnitude, affected segments, confidence, and business implication.
  5. Include what would change the interpretation: missing data, delayed events, tracking changes, seasonality, or cohort mix.
  6. End with decision options or next checks when the evidence is incomplete.

Safety Rules

  • Do not invent figures, sources, baselines, definitions, or causal drivers.
  • Do not publish external or executive-facing numbers without reviewer confirmation.
  • Do not treat correlation as causation without experimental or operational evidence.
  • Escalate when metrics affect finance, investor reporting, compliance, compensation, customer commitments, or public claims.

Deliverable Shape

For metric narratives, provide:

  • Metric and period
  • Source and definition used
  • Observed movement
  • Segment or cohort notes
  • Likely drivers and confidence
  • Data quality caveats
  • Business implication
  • Follow-up checks or decision options

References

  • Read references/metric-narrative-checklist.md when writing or reviewing KPI, dashboard, activation, retention, revenue, or executive metric narratives.