causal-inference-root-cause

Distinguish correlation from causation to identify true incident root causes.

16|Updated Dec 28, 2025
One-click install
npx skills add https://github.com/Hongyu-yu/matsci-ai-skills --skill causal-inference-root-cause-hongyu-yu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: causal-inference-root-cause
Source: https://github.com/Hongyu-yu/matsci-ai-skills/tree/main/skills/causal-inference-root-cause
Command: npx skills add https://github.com/Hongyu-yu/matsci-ai-skills --skill causal-inference-root-cause-hongyu-yu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematically distinguish true causal relationships from simple correlations to identify root causes in engineering, product, health, policy, and research contexts.

Core Features & Use Cases

  • Structured hypothesis generation: Employ techniques like 5 Whys, Fishbone diagrams, and timeline analysis to surface multiple plausible causes.
  • Causal modeling & evidence synthesis: Build explicit causal chains (root, proximate, confounders) with mechanisms and expected observations.
  • Evidence assessment framework: Apply temporal sequencing, counterfactuals, Bradford Hill criteria, and coherence checks to validate causal claims.
  • Use Case: Investigate a performance regression and determine whether a change was causal, identify the root cause, and propose interventions with confidence.

Quick Start

Describe the effect, generate at least three competing hypotheses, map a causal model, and validate using temporal sequence and counterfactual checks to determine the root cause.

Frequently Asked Questions about causal-inference-root-cause

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

FAQPage Schema
How do I identify the root cause of an incident instead of just finding correlations?

To identify the root cause, you must distinguish correlation from causation by building a defined causal model, establishing temporal sequencing, and testing counterfactuals. This structured approach surfaces true causal relationships rather than misleading correlations.

What is counterfactual testing and how does it validate causal claims?

Counterfactual testing validates causal claims by evaluating what would have happened if the suspected cause had not occurred. It helps isolate the true root cause by comparing actual outcomes against hypothetical scenarios to eliminate confounding variables.

How do I apply the Bradford Hill criteria to evaluate evidence for root cause analysis?

You apply the Bradford Hill criteria to evaluate evidence by checking temporal sequence, strength, and coherence of the association. This framework assesses whether observed correlations meet the standards required to confirm a true causal relationship.

Can I use causal inference to investigate a product metrics change with competing hypotheses?

Yes, causal inference handles competing hypotheses by generating multiple plausible causes using techniques like 5 Whys and Fishbone diagrams. It then maps explicit causal chains with confounders to systematically evaluate each hypothesis against the observed effect.

What is the best way to structure a causal model for engineering incident root cause analysis?

The best way to structure a causal model is to map explicit causal chains including root causes, proximate causes, and confounders. You then validate this model using temporal sequencing and counterfactual checks to propose targeted interventions with confidence.

When should I not use counterfactual testing for root cause analysis?

Counterfactual testing is less effective when you lack a defined causal model or sufficient temporal data to establish a clear sequence. Without these prerequisites, validating causal claims and distinguishing true root causes from correlations becomes unreliable.