five-whys

Agent Skills › wesammustafa/Claude-Code-Everything-You-Need-to-Know › five-whys

five-whys

GitHub

Finds the root cause of a bug, failure or recurring problem by asking "why" until the answer is a cause you can fix. Use when the user asks why something keeps happening, or wants the root cause rather than a quick fix.

solutions/i-1/dot-claude/skills/five-whys/SKILL.md wesammustafa/Claude-Code-Quest

Install

npx skills add wesammustafa/Claude-Code-Quest --skill five-whys -g -y

More Options

Non-standard path

npx skills add https://github.com/wesammustafa/Claude-Code-Quest/tree/main/solutions/i-1/dot-claude/skills/five-whys -g -y

Use without installing

npx skills use wesammustafa/Claude-Code-Quest@five-whys

指定 Agent (Claude Code)

npx skills add wesammustafa/Claude-Code-Quest --skill five-whys -a claude-code -g -y

安装 repo 全部 skill

npx skills add wesammustafa/Claude-Code-Quest --all -g -y

预览 repo 内 skill

npx skills add wesammustafa/Claude-Code-Quest --list

SKILL.md

Frontmatter

{
    "name": "five-whys",
    "description": "Finds the root cause of a bug, failure or recurring problem by asking \"why\" until the answer is a cause you can fix. Use when the user asks why something keeps happening, or wants the root cause rather than a quick fix.",
    "argument-hint": "[problem]"
}

Find the root cause of this problem: $ARGUMENTS

If no problem is given, ask for one in a single sentence, then stop.

Restate the problem as a symptom someone can observe: what happens, where and when.
Ask "Why does this happen?" Answer from evidence: the code, tests, logs and git history. Mark any answer you can't back with evidence as a guess.
Ask "Why?" of that answer, and keep going until the answer is a cause the team can change. That often takes about five rounds; stop sooner if you get there, and say so if you need more.
Check the chain backwards: each cause must explain the step before it.
Report the chain as a numbered list, the root cause in one sentence, then one fix for the root cause and one for the symptom.

Don't change any files. Propose the fixes and let the user decide.