metric-diagnostics

Diagnose metric changes, anomalies, gaps, and discrepancies across time windows and segments.

1|2|Updated Jun 16, 2026
One-click install
npx skills add https://github.com/MuzeWinter/CooperAPI-Plugin --skill metric-diagnostics-muzewinter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: metric-diagnostics
Source: https://github.com/MuzeWinter/CooperAPI-Plugin/tree/main/plugins/data-analytics/skills/metric-diagnostics
Command: npx skills add https://github.com/MuzeWinter/CooperAPI-Plugin --skill metric-diagnostics-muzewinter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you understand why a metric changed, diverged from expectation, or showed an anomaly by reproducing the measurement, checking the comparison frame, and tracing the most likely drivers.

Core Features & Use Cases

  • Metric Reproduction: Recreates the reported metric so the analysis starts from a verified baseline.
  • Source and Definition Validation: Checks metric logic, grain, filters, freshness, and source reliability before drawing conclusions.
  • Driver Decomposition: Separates mix shifts, segment effects, and within-segment changes to explain the movement.
  • Use Case: A revenue or conversion rate suddenly drops, and you need a clear, evidence-backed explanation of what changed, what is confirmed, and what still needs follow-up.

Quick Start

Use the metric-diagnostics skill to explain why the metric changed last week by reproducing it, validating the source, and identifying the strongest drivers.

Frequently Asked Questions about metric-diagnostics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I perform root cause analysis for a sudden drop in business metrics?

Root cause analysis for a sudden drop in business metrics requires reproducing the reported metric, validating its source and definitions, and decomposing drivers to separate mix shifts from segment effects. This process traces the movement to provide an evidence-backed explanation of the anomaly.

What is the best way to reconcile data discrepancies across multiple sources?

Data reconciliation across sources involves validating metric logic, grain, filters, and freshness before drawing conclusions. By reproducing the measurement from a verified baseline, you can quantify contributions and identify whether the discrepancy stems from source reliability or actual driver changes.

How does driver decomposition separate mix shifts from actual performance changes?

Driver decomposition separates mix shifts from actual performance changes by quantifying segment effects and within-segment variations. This isolates verified drivers that caused the metric movement from unresolved uncertainty, providing a clear breakdown of the anomaly.

Why does my anomaly detection alert trigger without an obvious change in the source data?

Anomaly detection alerts often trigger without obvious source changes due to comparison frame issues, stale data freshness, or filter misalignments. Validating the metric logic, source of truth, and grain reproduces the measurement to expose hidden driver shifts or definition errors.

Can I use metric diagnostics for investigating conversion rate gaps across different time windows?

You can use metric diagnostics for investigating conversion rate gaps across different time windows by validating definitions and reproducing the reported metric. This approach applies to business analytics investigations where a metric misses expectation or needs reconciliation across segments.

What are the limitations of source validation when diagnosing metric changes?

Source validation limitations arise when metric definitions, grain, or filters are ambiguous, leaving unresolved uncertainty. While it checks source reliability and freshness, it cannot fully explain movement if the underlying data lacks the granularity needed to separate verified drivers.