Skip to content
cccskills
FreePublished on GitHub

five-whys

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.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md1.6 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Find the root cause of this problem: $ARGUMENTS

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

  1. Restate the problem as a symptom someone can observe: what happens, where and when.
  2. 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.
  3. 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.
  4. Check the chain backwards: each cause must explain the step before it.
  5. 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.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Explains this repository's shared Claude Code setup to a new teammate, covering what is committed and shared, what stays personal, and what the team-kit plugin adds. Use when someone asks how the team's Claude Code setup works or what they get by cloning the repository.

The English summary is being prepared. Showing the original description.

wesammustafa/Claude-Code-Everything-You-Need-to-Know3.5KUpdated Oct 21, 2026

tdd

Free

TODO

The English summary is being prepared. Showing the original description.

wesammustafa/Claude-Code-Everything-You-Need-to-Know3.5KUpdated Oct 21, 2026

See all skills by wesammustafa

Report a problem with this skill