# root-cause-analysis

The root-cause-analysis skill guides investigations with 5 Whys, Ishikawa diagrams, Pareto analysis, and fault trees. Use it to trace a bug or failure beyond its visible symptoms.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 107 installs · ★ 25 repo stars
- Author: markpitt
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/markpitt/claude-skills/tree/HEAD/skills/root-cause-analysis/SKILL.md
- Updated: 2026-02-19
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/markpitt-root-cause-analysis

## What it does

The skill starts by shaping a clear problem statement: what happened, where, when, and with what impact. It then matches the investigation to the situation. A straightforward failure chain can use 5 Whys; several plausible causes call for an Ishikawa diagram. Start with evidence.

Files under `resources/` explain the methods, catalog common causes by domain, and provide worked cases. Advanced material covers fault trees and barrier analysis. During an investigation, the skill guides evidence gathering, records the reasoning, and checks conclusions with forward and backward tests. Without observations or evidence about the issue, the analysis has little concrete material to test.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add markpitt/claude-skills --skill root-cause-analysis -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/root-cause-analysis/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/root-cause-analysis/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add markpitt/claude-skills --skill root-cause-analysis -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/root-cause-analysis/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add markpitt/claude-skills --skill root-cause-analysis -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/root-cause-analysis/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install markpitt/claude-skills skills/root-cause-analysis
```

2. **Manually: put the files in place**
- File: `.github/skills/root-cause-analysis/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add markpitt/claude-skills --skill root-cause-analysis -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/markpitt/claude-skills --path skills/root-cause-analysis
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/root-cause-analysis/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add markpitt/claude-skills --skill root-cause-analysis -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/markpitt/claude-skills/tree/HEAD/skills/root-cause-analysis/SKILL.md

## When to use it
- trace a software failure to its underlying cause
- investigate a chain of equipment failures
- sort possible causes of a process breakdown
- test an analysis against available evidence

## Example prompts
- Investigate the failure after the latest deployment and help me trace its root cause.
- Use 5 Whys on this error, then check the conclusion against the logs.
- Build an Ishikawa diagram for the service failures that keep recurring.

## Similar
- [022-root-cause-analysis](https://affpapa.org/en/nevibecode/skills/022-root-cause-analysis.md) — skill · 144 installs
- [cause-and-effect](https://affpapa.org/en/nevibecode/skills/cause-and-effect.md) — skill · 1300 installs
- [root-cause-analyst](https://affpapa.org/en/nevibecode/agents/root-cause-analyst.md) — subagent · ★ 23950 repo stars
- [diagnosing-root-causes](https://affpapa.org/en/nevibecode/skills/diagnosing-root-causes.md) — skill · 122 installs
- [root-cause-analyzer](https://affpapa.org/en/nevibecode/agents/root-cause-analyzer.md) — subagent · ★ 788 repo stars
- [root-cause-tracing](https://affpapa.org/en/nevibecode/skills/root-cause-tracing.md) — skill · 1400 installs

## Other versions with the same name
- [root-cause-analysis · aj-geddes](https://affpapa.org/en/nevibecode/skills/root-cause-analysis.md) — 940 installs
- [root-cause-analysis · autohandai](https://affpapa.org/en/nevibecode/skills/autohandai-root-cause-analysis.md) — ★ 219 repo stars

From the same set: [markpitt/claude-skills](https://affpapa.org/en/nevibecode/by/markpitt/claude-skills.md) — 10 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
