product-data-metric-investigation-triage

Diagnose KPI drops and funnel regressions using variance decomposition and dimensional slicing.

1|Updated Jun 29, 2026
One-click install
npx skills add https://github.com/coreyone/software-maestro --skill product-data-metric-investigation-triage-coreyone
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: product-data-metric-investigation-triage
Source: https://github.com/coreyone/software-maestro/tree/main/data-and-api/product-data-metric-investigation-triage
Command: npx skills add https://github.com/coreyone/software-maestro --skill product-data-metric-investigation-triage-coreyone

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? When a core product metric like conversion, retention, or revenue suddenly drops, unstructured guessing wastes critical hours. This Skill provides a rigorous triage framework to isolate whether a decline is caused by a true product regression, a traffic mix shift, or a telemetry failure. ## Core Features & Use Cases - 3-Factor Variance Decomposition: Mathematically splits a metric delta into Volume, Rate, and Mix Shift effects to quantify the true driver of a drop. - Simpson's Paradox Detection: Identifies cases where every segment improves individually while the blended top-line metric falls due to traffic composition changes. - Incident Severity Triage: Classifies anomalies as P0 (critical outage), P1 (funnel degradation), or P2 (mix/seasonal shift) with corresponding response protocols. - Use Case: Your booking conversion drops from 3.5% to 2.8% week-over-week. The Skill slices by platform and app version, discovers iOS v12.5 is the sole regression driver, and recommends an immediate feature flag rollback. ## Quick Start Ask the agent to triage why your conversion rate dropped this week and produce a waterfall decomposition with a root-cause action plan.

Frequently Asked Questions about product-data-metric-investigation-triage

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

FAQPage Schema
How do I investigate a sudden drop in conversion rate?▼

Start with a 3-factor variance decomposition that splits the delta into volume, rate, and mix shift effects. Then slice the metric by platform, app version, geography, channel, and user cohort, and cross-reference the timeline with recent releases and feature flag changes.

What is Simpson's Paradox in product metrics?▼

Simpson's Paradox occurs when every individual segment's conversion rate improves but the blended top-line metric falls because traffic shifted toward lower-converting segments. It signals a mix shift problem in acquisition, not a product regression.

How do I decompose a metric change into mix shift vs rate effect?▼

Use the formula delta R equals the sum of segment weight changes times average rates (mix effect) plus the sum of average weights times rate changes (rate effect). This quantifies exactly how many basis points came from traffic composition versus true conversion degradation.

When should a metric drop be treated as a P0 incident?▼

Classify as P0 when the drop exceeds 20% in core conversion or revenue, is concentrated in a recent build or platform, and actively blocks users. Drops of 5-20% in a key funnel step are P1, while small mix-driven movements are P2.

When should I not use metric triage for a KPI drop?▼

Do not use this approach for infrastructure stack traces or crash logs, which belong to observability and debugging workflows. It also does not cover designing new North Star metric trees or running A/B test statistical analysis.