Skip to content
Get packs

Metric Diagnostics

Investigates why a metric moved or differs from expectations, and sizes the likely drivers.

Source Download skill
Repository
XiaomiMiMo/MiMo-Code
Stars
13,743
Licence
MIT
Files
2 files

What it does

When you ask why a number changed or doesn't match what you expected, the agent follows a structured investigation: it confirms the metric definition and data source, measures the size and timing of the change, breaks it down by likely drivers, and checks whether those drivers really explain it. It ends by stating what is verified, what is only likely, what remains unresolved, and what to check next. It also points to related skills for business context, data quality checks, or recommendations.

Great for

  • Analysts investigating a sudden drop or spike in a KPI
  • Teams reconciling two dashboards or reports that disagree
  • Data-savvy product or business owners who want a rigorous explanation of a metric change

Skip it if

  • Quick one-number lookups with no need for explanation (the workflow is heavier than necessary)
  • Situations where the agent has no access to the actual source data, since it may then mislead with guesses; it is designed to stop and ask for the required source instead
  • Making business decisions on its own; the skill explains movements but is not a substitute for human judgement on recommendations

Try asking

  • “Why did our weekly active users drop 12% last week compared with the prior four weeks?”
  • “Dashboard A shows revenue $2.1M but the finance table shows $1.9M. Figure out why they differ.”
  • “Which segments and regions drove the increase in churn this quarter?”
  • “Diagnose the spike in checkout errors starting Tuesday and whether it was broad or localized.”
Step-by-step guide: how to use Metric DiagnosticsInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 2 original files, the MIT licence and an attribution note.

    metric-diagnostics.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip metric-diagnostics.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip metric-diagnostics.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Give the exact metric name, time window, and comparison baseline up front so the agent does not have to guess.
  • Connect the warehouse or semantic layer you trust most; the skill prefers authoritative sources and will ask if one is missing.
  • Ask for the sized list of drivers and the residual unexplained amount, and review the stated assumptions before acting on conclusions.

What's inside

  • agents/openai.yaml
  • SKILL.md

Redistributed unmodified from XiaomiMiMo/MiMo-Code under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.