root-cause

Perform structured root cause analysis using 5-Whys methodology.

3|Updated Nov 19, 2025
One-click install
npx skills add https://github.com/meaganewaller/.dotfiles --skill root-cause-meaganewaller
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: root-cause
Source: https://github.com/meaganewaller/.dotfiles/tree/main/home/.claude/skills/common/root-cause
Command: npx skills add https://github.com/meaganewaller/.dotfiles --skill root-cause-meaganewaller

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you systematically investigate and understand the underlying causes of bugs, incidents, or unexpected behaviors, moving beyond surface-level symptoms to identify true root causes.

Core Features & Use Cases

  • Structured Analysis: Guides you through a step-by-step process including problem definition, timeline building, 5 Whys, contributing factors, and detection gap analysis.
  • Post-Mortem Aid: Provides a clear framework for conducting effective post-mortems and incident reviews.
  • Use Case: After a critical service outage, use this Skill to document what happened, reconstruct the event timeline, perform a 5 Whys analysis to find the ultimate cause, and define preventative actions.

Quick Start

Use the root-cause skill to analyze the recent login failure incident.

Frequently Asked Questions about root-cause

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I conduct a root cause analysis for a service outage or incident?

Root cause analysis for an incident is conducted by defining the problem, building an event timeline, applying the 5 Whys methodology, and identifying contributing factors to prevent recurrence. This structured approach moves beyond symptoms to find systemic issues.

What is the 5 Whys methodology for debugging failures?

The 5 Whys methodology for debugging is an iterative questioning technique used to explore cause-and-effect relationships. By repeatedly asking why a problem occurred, you uncover the underlying systemic issues rather than addressing surface-level symptoms.

How do I write an effective post-mortem after a critical bug or regression?

Writing an effective post-mortem involves documenting the incident timeline, performing a 5 Whys analysis to identify the ultimate cause, and defining preventative actions. This framework ensures incident reviews capture detection gaps and contributing factors.

Can I use this structured approach to identify detection gaps during incident response?

Yes, you can use this structured approach to identify detection gaps during incident response. The analysis process evaluates timelines and contributing factors to pinpoint where monitoring failed to catch the regression or outage early enough.

What is the best way to investigate systemic issues that cause recurring bugs?

The best way to investigate systemic issues causing recurring bugs is using a structured root cause analysis framework. By reconstructing the event timeline and applying the 5 Whys, you uncover the fundamental process failures rather than just fixing isolated errors.