Root Cause Analyzer
SkillMonitoring & opsConduct structured root cause analysis using Ishikawa (Fishbone), 5 Whys, and Pareto methods. Suitable for production incidents, quality defects, customer complaints, and recurring operational problems. Use when problems recur or when initial fixes do not resolve the issue. Do not use for one-time, obvious fixes or strategic decision-making.
Use Root Cause Analyzer in Claude, ChatGPT or Ahel Desktop
Free. Sign in, add Root Cause Analyzer and connect your AI. About a minute.
Also: Claude Code · Cursor · Codex
Then ask your AI: use the Root Cause Analyzer skill
Details
Instructions available. Your AI can read the instructions. Execution depends on the setup they require.
Account requirements not reviewed. Check the skill instructions before use; Ahel provides instructions and does not run this skill.
No other account needed.
Add Ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.
What this skill tells your AI
The instructions your AI receives, as published by hoavdc/codexkit in skills/codexkit-root-cause-analyzer/SKILL.md and read by Ahel’s review.
Purpose
Move beyond symptomatic fixes to identify true root causes of recurring problems, using proven analytical methods and producing actionable corrective actions.
When to use
- a problem has occurred more than once despite previous fixes
- a production incident needs thorough investigation
- quality defects are increasing and the cause is unclear
- customer complaints cluster around a specific area
- post-mortem or incident review
When not to use
- the cause is obvious and the fix is straightforward
- strategic planning (use strategy tools)
- risk identification for future events (use risk-register)
Inputs
- problem statement (what happened, when, how bad)
- impact data (who was affected, financial cost, customer impact)
- timeline of events leading to the problem
- previous fix attempts and their outcomes
- relevant process or system documentation
- available data or metrics related to the problem
Procedure
- Define the problem precisely:
- What is happening vs. what should be happening?
- When did it start? How often does it occur?
- What is the quantified impact?
- Template: "[Thing] is [problem] resulting in [impact] since [when]"
- Choose analysis method based on problem type:
- 5 Whys: for linear causation chains (simple to moderate)
- Ishikawa / Fishbone: for complex problems with multiple potential causes
- 6M categories: Man, Machine, Method, Material, Measurement, Mother Nature (Environment)
- Pareto Analysis: when multiple causes contribute and you need to prioritize
- 80/20 rule: find the 20% of causes responsible for 80% of the impact
- Execute analysis:
- For 5 Whys: ask "why?" iteratively until you reach a systemic cause (typically 3–7 levels). Stop when the answer points to a process, policy, or system — not a person.
- For Ishikawa: brainstorm causes in each 6M category, then validate with data.
- For Pareto: list all contributing causes, quantify frequency or impact, sort descending, calculate cumulative %.
- Validate root cause — confirm it is:
- Actionable (you can do something about it)
- Preventable (fixing it prevents recurrence)
- Systemic (not blaming an individual)
- Define corrective actions (CAPA framework):
- Containment: immediate actions already taken
- Corrective Action: fix the root cause
- Preventive Action: prevent recurrence in similar processes
- Each action: What | Who | When | Verification method
- Define recurrence metrics — how will you know it's fixed?
Output
- problem statement (one clear sentence with impact data)
- analysis output (5 Whys ladder, Fishbone diagram, or Pareto chart)
- validated root cause with supporting evidence
- CAPA table: Containment | Corrective | Preventive actions with owners and dates
- recurrence monitoring plan
Definition of done
- root cause is systemic, not individual blame
- root cause is validated with evidence or data
- corrective and preventive actions are defined with owners and due dates
- recurrence metrics are established
Examples
- "Our deployment failed 3 times this month. Run a 5 Whys analysis."
- "Customer complaints about delayed invoices are increasing. Do a Fishbone analysis."
- "We have 12 different bug types from last quarter. Use Pareto to prioritize which to fix first."
Quality Criteria
- Steps are executable in sequence without external context
- Decision points have clear if/then branching
- Rollback or abort procedures are documented for risky steps
- Expected duration or time-per-step is estimated
Verification (4C)
| Check | Question |
|---|---|
| Correctness | Do the steps execute correctly in the order specified? |
| Completeness | Are decision points, error handling, and escalation paths all documented? |
| Context-fit | Could someone with the right access but no prior context complete this runbook? |
| Consequence | If Step N fails and the operator skips to Step N+1, what breaks? |
Edge Cases
- Steps require access the operator doesn't have — Document exact access requirements upfront. Include escalation contact for emergency access.
- Environment differs from documented state — Add a pre-flight check as Step 0 to verify prerequisites before starting.
- Runbook is triggered during off-hours — Document who to contact and which steps can be safely deferred to business hours.
Changelog
- v1.0.0 — Initial release
Signals
- GitHub stars
- 25
- Forks
- 13
- Last commit
- Oct 2026
Advanced
- Item type
- skill
- Key
codexkit-root-cause-analyzer- Source
- github.com/hoavdc/codexkit
More in Monitoring & ops
Skill · anthropics
More in Monitoring & opsagent-eval
Skill · affaan-m
More in Monitoring & opspricing
Skill · coreyhaines31
More in Monitoring & opslark-okr
Skill · larksuite
More in Monitoring & opsdashboard-builder
Skill · affaan-m
More in Monitoring & opsbabysit
Skill · thedotmack
More in Monitoring & ops