incident-rca

Facilitate five-why incident investigations with real-time Mermaid mind maps.

7|4|Updated Nov 1, 2025
One-click install
npx skills add https://github.com/windschord/claude_skils --skill incident-rca
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: incident-rca
Source: https://github.com/windschord/claude_skils/tree/main/incident-rca
Command: npx skills add https://github.com/windschord/claude_skils --skill incident-rca

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps facilitate incident investigations using a structured '5 Whys' approach, records every user utterance, builds a real-time Mermaid mind-map to visualize the analysis, and provides a neutral facilitation role. It guarantees at least one root cause and offers fresh perspectives when discussions stall.

Core Features & Use Cases

  • Structured root cause analysis via a "Why" questioning framework
  • Real-time Mermaid mind-map generation and visualization
  • Comprehensive transcripts of user and facilitator statements
  • Handling multiple contributing factors with clear separation
  • Neutral facilitation that does not inject opinions or guesses
  • Guarantees at least one root cause
  • Provides alternative viewpoints when analysis stalls

Quick Start

  • Start RCA: 「インシデントの根本原因分析を開始します」 or 「なぜなぜ分析を始めたい」
  • The session will save results to a default path and begin logging in real time
  • After each answer, the mind-map is updated and displayed

Frequently Asked Questions about incident-rca

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

FAQPage Schema
How do I conduct a structured root cause analysis for an incident?

Root cause analysis uses iterative why-why questioning to systematically identify underlying causes rather than symptoms. This Skill guides you through five-why facilitation, records each response, builds a real-time mind map, and guarantees at least one root cause is documented before concluding the session.

Can I visualize incident RCA discussions in real time?

Yes. The Skill generates a real-time Mermaid mind map that updates after each answer, displaying the hierarchical relationship between factors, questions, and root causes as the analysis progresses, so participants see the emerging structure immediately.

What makes structured why-why analysis different from informal incident post-mortems?

Structured why-why analysis enforces neutral facilitation without speculation, records every participant statement verbatim, separates composite factors into distinct branches, and requires explicit identification of root causes—preventing incomplete investigations and documenting the full reasoning chain.

How do I handle multiple contributing factors in a single incident?

The Skill supports splitting composite factors into separate branches within the mind map, allowing each contributing cause to be explored independently while maintaining the complete causal chain in one session artifact.

What happens if the RCA discussion stalls or circles back?

The facilitator workflow detects stalled analysis and offers alternative viewpoints or fresh questioning angles to break the loop, ensuring the investigation progresses toward identifying genuine root causes rather than remaining stuck on surface-level factors.

Where are RCA session results and logs saved?

All artifacts—the final mind map, complete transcript of user and facilitator statements, identified root causes, and analysis logs—are saved automatically to a session-specific directory, creating a permanent record for documentation and future reference.