skills/use-context-root-cause-analysis/SKILL.md
Root cause analysis with 5 Whys.
npx skillsauth add thkt/dotclaude use-context-root-cause-analysisInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Fix the root cause, not the symptom. Symptom fixes add complexity; root-cause fixes prevent recurrence.
Ask "why" five times, descending through abstraction levels.
| Step | Level | | ---- | ------------------------ | | 1 | Observable fact | | 2 | Implementation detail | | 3 | Design decision | | 4 | Architectural constraint | | 5 | Root cause |
| Tip | Description | | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- | | Stay factual | Evidence, not assumptions | | Don't stop early | First "why" is rarely root cause | | Don't go deep | Stop when actionable | | Validate | "Because [5], therefore [4]..." | | Verify fix | "Will this prevent the problem?" | | Watch complexity signals | When intermittent / multiple independent changes overlap / behavior unexplained, enumerate ≥3 cause-layer candidates before converging |
| Field | Description | | ---------- | ---------------------------------------- | | Symptom | User-facing failure | | Root cause | Why the failure occurred (5 Whys result) | | Pattern | Isolated / Recurring / Systematic |
Consumers such as the /fix Non-obvious flow branch on the Pattern field to decide whether to apply defense-in-depth or escalate.
| Value | Meaning | | ---------- | ------------------------------------------------- | | Isolated | Single location, no recurrence path | | Recurring | Similar code exists nearby, recurrence possible | | Systematic | Design-rooted, architecture-level recurrence risk |
| Topic | File | | -------------------- | -------------------------------------------------- | | Worked examples | ${CLAUDE_SKILL_DIR}/references/five-whys.md | | Symptom → Root Cause | ${CLAUDE_SKILL_DIR}/references/symptom-patterns.md |
tools
Delegate implementation to codex (coder) via the herdr-agentchat plugin and drive a two-pane conversation to completion.
development
Extract recurring patterns from past closed PRs/issues and the research findings in workspace/research/, verify them against the latest code, and propose them to docs/wiki/ via PR.
development
Create Decision Records (DR) in MADR v4 format with auto-numbering.
development
Detect flaky tests by shaking them — repeated runs under varied order, parallelism, and seed — plus a static smell scan that flags latent flakiness in tests that currently pass. Classify each target as confirmed-flaky, latent-flaky, or stable and fix the root cause without weakening the test. Do NOT use to fix a confirmed single bug (use /fix) or for static-only code review (use /audit).