metric-rca

Localize metric changes through decomposition, drift classification, and causality checks.

3|2|Updated Aug 24, 2026
One-click install
npx skills add https://github.com/hero-engine/hero --skill metric-rca-hero-engine
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: metric-rca
Source: https://github.com/hero-engine/hero/tree/main/domains/pm/skills/metric-rca
Command: npx skills add https://github.com/hero-engine/hero --skill metric-rca-hero-engine

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a headline metric drops or spikes, teams reflexively name a cause from a hunch. This Skill replaces that reflex with a disciplined root-cause analysis method that localizes the move before asserting any explanation. ## Core Features & Use Cases - Metric-tree decomposition: Break top-line metrics (revenue, conversion, activation) into components and build a decomposition table that shows which leaf carries the move. - Five-class drift taxonomy: Classify the move as component, temporal, influence (Simpson's paradox / mix shift), dimension, or event-shock, each with its own confirming cut. - Causality guard: Treat correlation as a hypothesis, requiring every candidate cause to name the specific cut, segment, or time window that would confirm or kill it before assertion. - Use Case: Conversion fell 14% last week and someone blames the new checkout. The Skill decomposes the funnel, finds the move sits in one step, and demands the saw-it-vs-didn't comparison cut before the redesign is blamed or exonerated. ## Quick Start Ask the assistant to run metric RCA on why the activation metric dropped last week, decomposing it into components and ranking candidate causes with their confirming cuts.

Frequently Asked Questions about metric-rca

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

FAQPage Schema
How do I find out why a product metric dropped?▼

Decompose the metric into its components (e.g., Revenue = Users × ARPU) and build a table showing which component carries the move. Then classify the drift type and rank candidate causes, each with a confirming cut that would validate or kill it.

What is metric-tree decomposition in root cause analysis?▼

Metric-tree decomposition breaks a top-line metric into the components that multiply or add up to it, such as Conversions = Sessions × Conversion-rate. It localizes a move to a specific leaf so the investigation targets one component instead of the headline number.

How do I detect Simpson's paradox in metric changes?▼

Check the influence drift class: segment the metric and weight each segment by prior-period shares to hold the mix constant. If every segment is flat while the blended number falls, the move is a composition shift, not a real decline.

Can correlation prove a product launch caused a metric drop?▼

No. Temporal coincidence is a hypothesis, not a cause. Run a confirming cut such as comparing the metric for users who saw the change versus those who did not in the same window before asserting causality.

When should I run an experiment instead of observational RCA?▼

When observational cuts cannot resolve the cause, the answer is a pre-registered experiment rather than a stronger assertion. RCA produces ranked, disconfirmable hypotheses; experiments settle causation that cuts cannot.