One-click install
npx skills add https://github.com/xpert-ai/xpert-plugins --skill metric-diagnostics-xpert-ai
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: metric-diagnostics
Source: https://github.com/xpert-ai/xpert-plugins/tree/main/community/roles/data-analytics/skills/metric-diagnostics
Command: npx skills add https://github.com/xpert-ai/xpert-plugins --skill metric-diagnostics-xpert-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates guesswork when a key business metric moves unexpectedly, whether due to a spike, drop, gap against forecasts, or unexplained anomaly, by providing a structured, evidence-based diagnostic workflow.

Core Features & Use Cases

  • Metric Validation & Reproduction: Confirms metric definitions, source data quality, and aggregation logic to rule out measurement errors before investigating causes.
  • Driver Decomposition: Breaks down metric movements into contributing segments, mix shifts, and within-segment performance changes to identify the strongest root causes.
  • Use Case: For example, if your monthly recurring revenue drops 10% quarter-over-quarter, this skill will reproduce the metric, validate its source, decompose the drop by product line and customer segment, and identify whether the decline is driven by a specific product or broad market factors.

Quick Start

Use the metric-diagnostics skill to explain why yesterday's website checkout completion rate fell 8% compared to the same day last week.

Frequently Asked Questions about metric-diagnostics

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

FAQPage Schema
How do I find the root cause of unexpected metric movements in my business analytics?โ–ผ

To find the root cause of unexpected metric movements, you can decompose the changes by segment and mix shifts. This validates data quality and identifies the specific drivers causing performance spikes or regressions.

What is the best way to investigate anomalies and validate data quality for key metrics?โ–ผ

Investigating anomalies and validating data quality requires reproducing metric definitions and aggregating source data. This structured diagnostic workflow rules out measurement errors before analyzing actual performance drivers.

How do I decompose metric changes to quantify segment contributions?โ–ผ

Decomposing metric changes quantifies segment contributions by breaking down movements into within-segment performance shifts and mix changes. This process isolates whether specific business segments or broad factors drive the variance.

Can I reconcile conflicting metric definitions across different data sources?โ–ผ

You can reconcile conflicting metric definitions across data sources by querying connected structured data and semantic layers. The workflow cross-references definitions to calibrate explanations and resolve discrepancies.

Do I need a semantic layer to diagnose gaps between actual and expected metric values?โ–ผ

You need connected structured data sources and a semantic layer to diagnose gaps between actual and expected values. Access to business context is required to reproduce metrics, run live queries, and produce calibrated explanations.

When should I not use automated driver decomposition for anomaly detection?โ–ผ

Automated driver decomposition for anomaly detection is not suitable when your underlying structured data sources lack a connected semantic layer. Accurate root cause analysis requires accessible business context to reproduce metric logic.