The AI 5 Whys Analyst skill for Claude
You describe a problem that keeps coming back, and Claude digs through it with the 5 whys method until it reaches the cause someone can genuinely change. Each layer gets a label: confirmed by data, plausible, or hypothesis. The root cause is phrased as a system or process, never as a person. And you get two measures kept separate: the quick fix for this week and the intervention that removes the cause. Elsewhere the same method is called five whys, 5 whys or vijf keer waarom (its Dutch name); the file responds to all of those names.
the lines above come from the zip on this page · SKILL.md is 14,085 bytes
The chain unrolls layer by layer
reg. W.001This is the case that sits literally in the SKILL.md, shortened here. Watch the labels on the right. They are the difference between a root cause analysis and a story that happens to sound logical: the skill states per layer whether the answer is confirmed, plausible, or still no more than a hypothesis.
# known: number of enquiries, average turnaround time, promise to the client
# unknown: spread per account manager, where in the chain the time gets stuck
What the 5 whys method is
The 5 whys method is a way of getting from a visible problem to the cause underneath it by repeatedly asking why about the answer you just received. You start at the symptom, ask why it happens, and ask why again about that answer, until you reach a layer where someone can actually change something. The same method is called five whys or 5 whys, in Dutch you also hear vijf keer waarom, and in the quality world it falls under the broader heading of root cause analysis. It is all the same tool.
The method is generally attributed to Sakichi Toyoda, the founder of Toyota Industries. Taiichi Ohno made it well known as a fixed part of the Toyota Production System and described it in his 1978 book about that system. The reasoning behind it is simple: every visible problem is the result of something that lies deeper, and you only reach that deeper cause once you have worked down through a few layers. Five is not a magic number here. It is a rule of thumb that says you are probably not there yet at the first plausible explanation.
The AI 5 Whys Analyst translates that method into a fixed way of working for Claude. A skill is an instruction file, SKILL.md, that gives an AI assistant a fixed approach for a task. Not software you install, no subscription, no connection to your systems: a text file of 2,189 words that tells Claude how a root cause analysis should be structured, what to ask first, how to mark certainty per layer, and what it must never invent itself. You download the zip at the top of this page, put it in your Claude environment, and from that moment every root cause question runs through this logic.
What makes the skill different from simply asking why five times yourself comes down to three things. First, it forces you to make the problem measurable before anything else. Before a single why gets asked, it rewrites your complaint into a factual sentence with place, time and scale. Second, it labels every layer by evidence, so at the end you can see which part of your analysis rests on data and which part on a story that happens to check out. Third, it separates the plaster from the intervention: the quick fix that stops the symptom this week stands apart from the structural measure that removes the cause, each with its own owner and deadline.
The file belongs to the TheSEO skill library NL, where 100 skills are free to download, and it comes out of the AI and automation service. New to files like this? Start with what Claude skills are NL: it explains in plain terms what a skill is and is not.
Why most why chains break down
Almost everyone can ask why five times. That is not the problem. The problem is that a chain can go off the rails in four ways without you noticing, leaving you with an analysis that looks like an analysis but solves nothing. The SKILL.md has an explicit rule for each of these four.
The chain points at people. This is the best known trap, and Eric Ries gave it a name in The Lean Startup from 2011: Five Blames. Every layer ends up with someone who forgot something, failed to pass something on, or was not paying attention. It feels satisfying, because there is a culprit. But you can repair a system and you cannot repair a human being, so an analysis like that always ends in a conversation and never in a measure. The skill flatly refuses to name a person as the root cause, and it deliberately writes causes in the passive voice to remove the question of blame. Not Jan forgot the check, but the check was skipped because there was no required field.
The chain rephrases instead of explaining. Layer three says the same thing as layer two in different words. Quotes take a long time because the turnaround time is high: that looks like a step deeper, but you are still standing in the same spot. In the skill's review mode this is the first checkpoint, and the file explicitly calls rephrasing the most common mistake.
The chain stops in the technical layer. The SKILL.md distinguishes three kinds of layers you usually encounter: the technical layer, where something went wrong in an action, a setting or a piece of code; the process layer, where the process allowed that mistake or even invited it; and the system layer, where nobody owned it, the incentives were wrong, or an earlier decision unintentionally caused this. A good analysis rarely ends in the technical layer. That is where the quick fix sits, not the structural solution.
Or the chain acts as if everything is certain. Five answers listed one after another read like five facts, even if three of them were guesses. That is why every layer in the output gets a certainty line, with one of three values: confirmed by data, plausible but unproven, or pure hypothesis. In FIG.01 two layers sit at hypothesis, and those two return at the end in a separate block of what you still need to find out. That block is the most honest section of the entire output.
In diff form, with a chain that reasons itself towards a person set against the same chain carried through to the system:
Blame on a person or on the process
reg. W.002Two chains that start at exactly the same point and then diverge. On the left, the version everyone knows from the meeting room: every layer gets closer to a name. On the right, the same question carried through to the process. The meter at the bottom shows where you end up, because that determines whether your measure still works tomorrow.
What is actually in the SKILL.md
A skill is only as good as its instructions, so we simply describe them here. The file opens with a frontmatter that states when Claude should pick up the skill. Not just the obvious terms like 5 whys, five whys, root cause, RCA, root cause analysis, problem analysis, fishbone diagram, Ishikawa, kaizen analysis, post mortem, incident analysis and complaint analysis, but also frustrations: we have already fixed this three times and it keeps coming back, we only put out fires, everyone points at each other, the client is complaining about the same thing again, our deadline is structurally missed, the fix worked for a week. Anyone who says something like that to Claude while the skill is loaded gets it automatically.
Next comes a chapter on the theory: Toyoda and Ohno, the three layers of technical, process and system, and four variants the skill may use when the context calls for it. The branching chain for when a layer has more than one valid cause. The combination with the Ishikawa diagram for when nobody yet knows where the problem sits. Five whys plus how, where after the root cause you run the chain back upward asking how you guard against each layer. And the lean startup variant from Eric Ries, where per layer you make an investment proportional to how serious the problem is.
At its core is a list of seven things the skill always does. It rewrites the problem into a factual, measurable sentence with place, time and scale before any why gets asked. It asks the five questions one at a time and answers them based on what you have supplied, not on assumption. It marks per layer how certain the answer is. It visibly splits the chain into branches as soon as a layer has more than one valid cause, and follows the branch with the greatest impact through.
It names the root cause in one sentence, phrased as a system or process. It delivers the quick fix and the structural measure separately, each with an owner and a deadline. And it closes with a verification step.
Before anything gets analysed, the skill runs through a mandatory input checklist of six points: the problem in your own words, when it occurs and how often, who or what suffers from it, what has already been tried and why that did not help, which facts or figures are available, and what you can and cannot change about budget, mandate and influence on other departments. It only asks about what is missing and then stops asking. If you do not know something, it carries on and marks that layer as unproven. So you do not get a form, at most two or three targeted questions.
A striking number of rules are about language. Plain Dutch (the file itself is written in Dutch), addressing the reader directly, no dashes in running text, AI written in capitals, no lists of exactly three items, concrete over abstract, a figure over an adjective, and short sentences alternating with long ones. There is even a list of words and turns of phrase that are banned because they smell of AI. And there is a writing rule that is substantive rather than cosmetic: write causes passively where that removes the question of blame. If you want to understand how rules like that end up in a skill file, writing a SKILL.md NL explains the structure step by step.
The output is fixed into seven blocks in a set order: problem statement, the chain of whys, root cause, quick fix, structural measure, verification, and what you still need to find out. The file also contains a separate review mode for existing analyses, a list of seven things the skill never does, and a source list of five titles. The last two get their own section further down this page.
When a layer has more than one cause
reg. W.003A straight chain works as long as every layer has just one valid answer. As soon as that is not the case, the chain becomes a tree. Then it visibly splits the chain, follows the branch with the greatest impact through, and leaves the other branches open instead of sweeping them aside. If nobody yet knows where the problem sits, it first uses the Ishikawa categories as an antechamber to work out which branch is worth pursuing.
The theory the skill rests on
Five sources are named in the file. That is deliberate: it lets you check them yourself and decide whether you agree. Each source explains one choice in the way of working.
The method itself comes from Toyoda and Ohno. Taiichi Ohno described the Toyota Production System in 1978, with the English edition in 1988, and credits the five why questions in it to Sakichi Toyoda. What often gets skipped is the context: at Toyota, asking why was not a meeting technique but a habit on the shop floor, close to the machine, with the people doing the work. That explains why the skill hammers so hard on facts and on what you can observe yourself.
The antechamber comes from Kaoru Ishikawa. His Guide to Quality Control from 1968 contains the cause and effect diagram that in practice is almost always used together with the 5 whys method. The division of roles is clear: the fishbone diagram widens, the chain of whys deepens. If you want to widen first and only then choose, the MECE Problem Structure Coach skill is another option, which splits a problem into boxes that do not overlap and together cover everything.
The trap comes from Eric Ries. The Lean Startup from 2011 describes the 5 whys method in product development and introduces the term Five Blames for the chain that points every layer at a person. Ries also attached an investment rule to it: the effort you put into a measure should be proportional to how serious the problem is, so you do not start a six month project after a minor incident.
The coaching side comes from Mike Rother. Toyota Kata from 2009 is about the way improving and coaching are structured within Toyota. That matters because a root cause analysis is rarely a one off action: run the same questioning routine every week and asking why becomes a habit rather than an occasional exercise.
The warning comes from Sidney Dekker. The Field Guide to Understanding Human Error from 2006 explains why root cause analyses that end at a person are useless. Human error is not an explanation but the point where you need to start looking. This source is the reason the ban on blame in the skill is not a courtesy rule but an analytical tool: as long as the chain ends at a name, you have not yet answered the question.
Even without installing the skill you can improve your own analyses with these principles: make the problem measurable first, label per layer how certain you are, and force yourself to phrase the final layer as a process rather than as a person.
What the skill refuses
reg. W.004The SKILL.md contains a list of seven things the skill never does, and that list matters at least as much as what it does do. A root cause analysis nobody dares to build on is wasted time. In conversation those rules play out like this: every line is a request you might make, with the response the skill gives according to its own instructions.
Installing in Claude Code, Claude.ai or Codex
The zip contains a folder with the SKILL.md inside. Installing is simply a matter of putting the file in the right place, and that place differs per environment. SKILL.md has been an open standard since December 2025, so the same skill also works in Codex, Cursor and Gemini CLI. So you are not downloading a Claude file but a working instruction any modern AI assistant can read.
- Unpack the zip into
~/.claude/skills/(or.claude/skills/in your project). - Claude then recognises the skill on its own as soon as you start talking about a cause or a recurring problem.
- You can also call it directly, with
/ai-5-waarom-analist.
- Go to Customize and then Skills.
- Upload the zip there as a skill.
- Or paste the contents of SKILL.md into the project instructions of a Project.
- Open
AGENTS.mdin your repo. - Paste the contents of SKILL.md into it, or put SKILL.md next to it as a separate file and refer to it from
AGENTS.md. - Codex reads that along at every session.
After that, using it is simple: describe the problem as you experience it, with whatever figures or logs you have. The rawer, the better, as long as there is real information in it. It asks itself what is still missing and carries on with what is there. If installing gets stuck anywhere, the full explanation per environment sits in installing Claude skills NL, including the common mistakes with folders and permissions. And if you want to learn more broadly about working with AI, you will find the background articles in the knowledge base.
When you do and do not use it
It is at its strongest on a defined problem that repeats and that you can capture in figures: turnaround times that are not met, complaints that keep coming back to the same thing, a fault that returns after every fix, a funnel that leaks at the same spot. That is where the straight five layer chain comes into its own. If a layer has more than one valid cause that does not rule the others out, it switches to the branching variant and follows the branch with the greatest impact, with the other branches explicitly named as open. If nobody yet knows where the problem sits, it first brings in the Ishikawa antechamber.
Two adjustments the file itself names, which many people miss. You may stop earlier than five layers if you are already at a cause you have influence over, provided you say that you are stopping and why. And you may go further than five layers if the fifth layer is still a symptom. For incidents with a safety or financial impact, the skill also adds an extra layer that is not about the cause but about detection: why was this not noticed sooner. That question often produces a second measure separate from the first.
There are also situations where you are better off leaving it be, and the skill says so itself in its frontmatter. Not during an ongoing incident: put out the fire first and analyse afterwards, because analysing during a fault costs attention you need to stop it. In brainstorm sessions where you actually want to widen your options it works against you, because this method narrows down rather than fanning out. It does not write text either. And not for several problems at once.
One more honest limit that is not in the file but counts in practice: the skill makes your analysis better, not your organisation. If the root cause is a decision someone above you made and will not reverse, you end up with a sharp analysis and still the same problem. What the skill does do then is put that sharply on paper, with a verification step underneath, so the conversation is about facts rather than impressions. Want to go from a cause to a priority? The Pareto Analyst skill is the logical next step: it works out which causes explain the largest share of the problem.
Run it yourself or have it run
reg. W.005This skill is the free do it yourself version of work we also deliver as a service. It stays complete and without any catches, but be clear about what a skill is: it teaches your AI how to do something, while every new session starts empty. So it is not the engine and not the memory either. You prompt, you supply the context again every time, you check the result. Anyone who wants that differently has two next steps: hand over the engine, or sort out the memory.
where you are now The skill: you are the engine You run the AI 5 Whys Analyst yourself in Claude, Codex or Cursor. Costs nothing, works today, and you keep it entirely in your own hands: no trial period, no locked off parts. The limit is your own time: the analysis only happens when you start it, and you have to supply last week's context again yourself.
a role built to fit A role built to fit: the incident log kept up to date You do not outsource a single root cause analysis. A business where something goes wrong every week and nobody keeps track of what does have a recurring process on its hands. The three roles we set up ready made are the Quotes Employee (sorting incoming enquiries and preparing draft quotes), the Sales Employee (prospect research and outreach drafts) and the Reporting Employee (summaries and weekly and monthly reports from your own data). This particular work is not among them, so this becomes a role built to fit via Mansotti, the company TheSEO is the trading name of. What a role like this can do is collect the reports, fill in the five layers as a draft per report, and show every month which root causes keep coming back. That only works if the reports get logged somewhere and someone reviews the outcome. Control stays with you, because output remains a draft until a human approves it. Read what an AI employee is and does.
everything from one source Jarvis: all your AIs work from the same company knowledge The skill teaches the AI; the brain is where the memory lives. Want all your AIs to work from the same company knowledge? That is Jarvis, the organisation brain. It connects ChatGPT, Claude, Codex and your people to the same projects, core knowledge and decisions, so your next AI session does not start from scratch. For root cause analysis that is extra noticeable: last month's analysis, the measure it produced and the verification that hung under it are all still there, so you can see whether a problem is genuinely new or already back. Client knowledge stays isolated and every step leaves a traceable record. What that delivers in practice, from the plans to your first week, you can read at Jarvis itself.
What Jarvis delivers in practice
reg. W.006Step 3 deserves more than a paragraph, because this is the difference between a smart chat and a system you can build on. Jarvis is the organisation brain: it remembers what your AIs need to know, divides up the work and keeps track of what happened. That matters especially for root cause analysis, because you can only answer whether a problem is recurring if the previous analysis is still there. You notice it first at the start of a new session.
We have been running on this system ourselves for months. Every agent session, every task and every decision gets logged in it and can be read back. So a new session does not start blank: it first retrieves the logged decisions, the running projects and the latest changes, and carries on from where the previous one stopped. So we are not describing a promise but the way of working we ourselves work in every day.
See the four plans at jarvis/pricing NL. Through the waiting list NL you only pass on your preferred plan with no obligation. That does not yet create an account, an order or a payment obligation. Business arrangements we discuss first.
The skills around it
reg. W.007A root cause analysis rarely stands on its own. A choice about which problem to tackle comes before it, and a decision about what to do about it comes after. These skills from the same library each take on a different piece of that chain.
Before the chain
which problem firstBefore you dig five layers deep, you want to know whether you are digging in the right spot.
Pareto AnalystFinds the few causes that explain the largest share of the problem, so you know which chain comes first.SKILL MECE Problem Structure CoachSplits the problem into boxes that do not overlap and together cover everything. The broad groundwork for the deep question.SKILL Theory of Constraints AnalystLooks for the one constraint holding up the whole chain. Related, but looks at flow rather than cause.SKILLOther ways of questioning
thinking techniqueWhy is not the only question that breaks an assumption.
First Principles ThinkerStrips down to what you can prove and rebuilds from there. Where 5 whys digs downward, this one goes back to the ground.SKILL Socratic Method CoachKeeps asking until you land on evidence or on an assumption, with no fixed number of layers.SKILL NL Feynman Technique CoachHas you explain it until a child understands. The gaps in your explanation are the gaps in your understanding of the cause.SKILL Cognitive Bias DetectorFlags the thinking errors that derail a chain before it reaches the system.SKILLBefore it goes wrong
preventionThe 5 whys method looks backward. These three look forward, with the same discipline.
Pre-Mortem AnalystDoes the same exercise before it goes wrong: imagine the plan has failed and write down why.SKILL NL Red Team AnalystAttacks your plan from the opposing side and scores the assumptions on damage.SKILL Inversion ThinkerFlips the question: how do you guarantee this fails. Then you avoid that route.SKILLThe basics first
the explanationNever worked with skills before? Start here, and the file will land properly.
What Claude skills areIn plain language: what a SKILL.md is, what it can and cannot do, and why it is not software.BLOG NL Installing Claude skillsStep by step per environment, including the mistakes everyone makes with folders and permissions.BLOG NL Writing a SKILL.md yourselfHow the structure works, from frontmatter to refusals list, if you want to make one yourself.BLOG NL The whole skill libraryAll 100 free skills in one list, sorted by subject.HUB NL AI and automationThe service behind it: from separate skills to working automation in your business.SRV AI trainingIf your team wants to learn to set up and sustain this kind of analysis themselves.SRV NLFrequently asked questions
What does the AI 5 Whys Analyst skill cost?
Nothing. The skill is free, falls under the MIT licence, and you do not have to create an account or leave an email address. You download a 5.7 KB zip containing a folder and a single file, SKILL.md, and that is the complete skill. There is no paid version and no sales email follows.
Is the 5 whys method the same as five whys or root cause analysis?
5 whys, five whys and vijf keer waarom (its Dutch name) are all names for the same method. Root cause analysis is the broader umbrella term for root cause work, and the 5 whys method is one of its best known forms. The file responds to all of those terms, plus root cause, RCA, fishbone diagram, Ishikawa, incident analysis and post mortem. So you do not need to know what the framework is called for the skill to kick in.
Does this skill also work in Codex, Cursor or Gemini CLI?
Yes. SKILL.md has been an open standard since December 2025, so the same file also works in Codex, Cursor, Gemini CLI and other tools that follow the standard. In Codex you unpack the zip into .agents/skills/ in your project, or into ~/.agents/skills/ for all your projects; Codex has supported SKILL.md directly since the open standard of December 2025. Putting the contents of SKILL.md into your AGENTS.md still works too. The instructions are plain readable text, so any AI assistant that accepts instruction files can work with it.
Does it always have to be exactly five whys?
No, and the file says so literally: five is a rule of thumb, not a limit. The skill stops earlier if you are already at a cause you genuinely have influence over and asking further only produces philosophy, and it then states that it stops at layer three or four, and why. If the fifth layer is still a symptom, it carries on. For incidents with a safety or financial impact it adds an extra layer about detection: why was this not noticed sooner.
What if the chain of whys ends up at a person?
Then, according to the skill, the analysis is not finished yet. Naming a person as the root cause is on the list of things the skill never does. It deliberately writes causes in the passive voice to remove the question of blame: not Jan forgot the check, but the check was skipped because there was no required field. Eric Ries called the trap where every layer points at a person Five Blames, and the skill has a separate check for it.
Can the skill review an existing root cause analysis?
Yes. Hand it an existing analysis and you get five things back: a verdict per layer on whether it is a real cause or just a rephrasing of the layer above, a blame check that flags every layer that ends at a person, an evidence check that names per layer what data would confirm it, a depth check on whether the analysis ends in the technical, process or system layer, and a rewritten chain with the quick fix and the structural measure kept separate.
When is it better not to use the 5 whys method?
Not during an ongoing incident: put out the fire first and analyse afterwards, and the skill says so itself too. Not for brainstorm sessions where you actually want to widen your options rather than narrow down to one cause. Not for writing text. And not for several problems at once, because one of its fixed rules is: one problem, one chain.
From cause to measure
A sharp analysis is half the job. The other half is that someone actually acts on it, and that in eight weeks someone genuinely checks whether it worked. That is where most root cause analyses fail: not on the logic, but on the follow-up. So put the verification step in the same agenda as the rest of your work, and agree in advance which outcome would prove your analysis was wrong. That last part is uncomfortable, and exactly for that reason useful.
If the problem you are looking into sits at the front end, in too few enquiries rather than in the turnaround time afterwards, then the work starts somewhere else: at being found by the people looking for you. The free SEO scan shows in a few seconds where your site stands. And if you want to talk further about what else AI can do for your business, from separate skills to full automation, we simply do that in a conversation.