# Starter Root Cause Investigation

> Starter skill for incident post-mortems and deep scientific investigations. Orchestrates 5-Whys causal analysis, empirical hypothesis testing, and simulation modeling.

- Skill: `felipecustodio/starter-root-cause-investigation` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add felipecustodio/starter-root-cause-investigation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/felipecustodio/starter-root-cause-investigation/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: felipecustodio (https://skillmd.com/u/felipecustodio)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/felipecustodio/starter-root-cause-investigation

---


## Overview & Purpose

starter-root-cause-investigation is a starter workflow that chains skills together. It chains together the ideal combination of reasoning skills for high-level tasks, without needing manual setup.

## Execution Workflow

1. **Execute 5-Whys Traversal (`causal-analysis`)**: Map symptoms back to fundamental root causes using counterfactual testing.
2. **Empirical Hypothesis Testing (`scientific-method`)**: create falsifiable hypotheses, design experiments, and record findings.
3. **Simulate Dynamic Behavior (`simulation-reasoning`)**: Model system behavior over time under seed conditions to observe emergent failures.
4. **Self-Audit Reasoning (`metacognitive-monitoring`)**: Perform real-time bias detection to ensure conclusions are grounded strictly in evidence.

## Expected Output Contract

```markdown
### Starter Workflow Execution: [starter-root-cause-investigation]
- **Phase 1 Output**: [Initial Analysis]
- **Phase 2 Output**: [Detailed Evaluation]
- **Final Synthesized Solution**: [Complete Recommendation]
```

## Scripts

- `scripts/starter_root_cause_investigation.py` - Orchestration helper and state validation tool for starter-root-cause-investigation.

## Gotchas

- Ensure all sub-skill prerequisites are satisfied before executing downstream pipeline steps.

