Skip to content
Agentmart
Submit a tool

five-whys

Conduct root cause analysis using the Five Whys technique.

Skill by yokuze

IndexedMIT★ 1
Write a review

Install

Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install skill/yokuze-five-whys

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Conduct root cause analysis using the Five Whys technique. Use when investigating problems, debugging issues, understanding failures, analyzing churn, or finding the underlying cause of any issue.

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this skill can do and what it asks for, from its SKILL.md. Checked Oct 25, 2026.

Tools
No tools found
Secrets
None asked for
Install scripts
None found

Network hosts it talks to 1

  • codeload.github.com · found in install command

Files it touches

  • ~/.claude/skills/five-whys

What's inside

Skill name
five-whys
Description
Conduct root cause analysis using the Five Whys technique. Use when investigating problems, debugging issues, understanding failures, analyzing churn, or finding the underlying cause of any issue.
License
MIT
Instructions
267 lines in SKILL.md · view on GitHub

Files (1)

  • SKILL.md

SKILL.md (first lines)

# Five Whys - Root Cause Analysis

Systematic guide to uncovering root causes through iterative questioning,
originally developed by Sakichi Toyoda for Toyota Motor Corporation.

## When to Use This Skill

- Investigating recurring problems
- Debugging system failures
- Understanding customer churn
- Analyzing project delays or budget overruns
- Post-mortem analysis
- Process improvement initiatives

## Core Concepts

### The Method

```
Problem Statement
    ↓
Why? → Answer 1
    ↓
Why? → Answer 2
    ↓
Why? → Answer 3
    ↓
Why? → Answer 4
    ↓
Why? → Answer 5
    ↓
Root Cause Identified
    ↓
Solution Implementation
```

### Key Principles

| Principle                    | Description                          |
| ---------------------------- | ------------------------------------ |
| **Facts over assumptions**   | Base questions on data, not guesses  |
| **Systems over individuals** | Focus on process failures, not blame |
| **Flexibility**              | Go beyond 5 questions if needed      |
| **Verification**             | Validate findings with evidence      |

## Questioning Techniques

### Standard Approach

For each iteration, ask:

- Why did this happen?
- What caused this situation?
- What led to this outcome?

### Alternative Phrasing (Less Confrontational)

When direct "why" questions feel threatening, use softer alternatives:

#### Root Cause Investigation

| Instead of...        | Try...                                |
| -------------------- | ------------------------------------- |
| Why did this happen? | What was going on when this happened? |
| Why did you do that? | What were you trying to accomplish?   |
| Why is this broken?  | How do you suppose we ended up here?  |

#### Understanding Motivation

| Instead of...         | Try...                                     |
| --------------------- | ------------------------------------------ |
| Why do you want this? | What happens if we don't get this done?    |
| Why does this matter? | What problems does this solve?             |
| Why is this urgent?   | What do you think will happen if we delay? |

#### Understanding Decisions

| Instead of...                   | Try...                                        |
| ------------------------------- | --------------------------------------------- |
| Why did leadership decide this? | What were the reasons we went this direction? |
| Why this approach?              | How do you see this working long term?        |

## Analysis Framework

### Step 1: Define the Problem

Be specific and measurable:

```
❌ Bad:  "The system is slow"
✅ Good: "Page load time increased from 2s to 8s after the March release"

❌ Bad:  "Customers are unhappy"
✅ Good: "Customer churn increased by 40% over three months"
```

### Step 2: Iterate Through Whys

Document each level clearly:

```
Problem: Customer churn increased by 40%

1. Why? → Customers canceling after free trial
2. Why? → Not seeing enough value during trial
3. Why? → Not completing the onboarding process
4. Why? → Onboarding too complex, requires too much setup
5. Why? → Product lacks automation and intelligent defaults

Root Cause: Poor onboarding experience due to lack of automation
```

### Step 3: Identify Solutions

Target the root cause, not symptoms:

```
Symptom-level fix (avoid):
├── Offer discounts to retain customers

From yokuze/aix-config, MIT.

Signals

Stars
1
Forks
1
Open issues
0
Last commit (this folder)
Feb 14, 2026 (8 months ago)

From GitHub (fetched Oct 24, 2026).

Details

License
MIT
First seen
Oct 24, 2026
Last checked
Oct 24, 2026

More from yokuze

Cite this page

five-whys skill. Agent Mart. https://agentmart.dev/skills/yokuze-five-whys (last updated 2026-10-24)