incident-root-cause-analyzer

Diagnose cascading failure root causes using logs, metrics, and traces.

Updated Nov 3, 2025
One-click install
npx skills add https://github.com/LitheScript/incident-root-cause-analyzer --skill incident-root-cause-analyzer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: incident-root-cause-analyzer
Source: https://github.com/LitheScript/incident-root-cause-analyzer/tree/main/incident-root-cause-analyzer
Command: npx skills add https://github.com/LitheScript/incident-root-cause-analyzer --skill incident-root-cause-analyzer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires polars, numpy, matplotlib, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill provides a comprehensive, end-to-end methodology for analyzing production incidents in distributed systems, enabling teams to quickly identify cascading failures, resource contention, and backpressure-driven root causes. It helps reduce mean time to detection and resolution by automating data collection, anomaly scoring, hypothesis testing, and evidence-based reporting.

Core Features & Use Cases

  • Automated root-cause analysis across microservice boundaries using logs, metrics, and traces.
  • Anomaly detection with timeline correlation to reveal the sequence of events leading to an incident.
  • Evidence-based hypothesis testing and automated visualizations (Mermaid diagrams) to communicate findings.
  • Generates formal Root Cause Analysis reports and structured evidence artifacts to speed incident reviews.

Quick Start

Load the incident root cause analyzer skill into Claude, provide:

  • Incident time window (e.g., 07:00:00 ± 30s)
  • Metrics data directory (CSV files)
  • Optional logs or traces directory Then run the analysis to produce a Root Cause Analysis report, evidence charts, a fault evolution diagram, and an evidence index.

Frequently Asked Questions about incident-root-cause-analyzer

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

FAQPage Schema
How do I analyze root causes of cascading failures in distributed systems?

Root-cause analysis of cascading failures uses logs, metrics, and traces to map temporal causality across microservices. This Skill automates anomaly detection, hypothesis testing, and evidence correlation to identify resource contention, backpressure propagation, and failure sequences, then generates structured reports with actionable remediation guidance.

Can I use this for incident analysis with CSV metrics data?

Yes. The Skill accepts metrics data as CSV files in a directory alongside an incident time window. It processes the data using polars and numpy to score anomalies, correlate timeline events, and produce evidence artifacts including visualizations and a formal Root Cause Analysis report.

What's included in the automated incident report output?

Reports include a structured Root Cause Analysis document, evidence charts generated with matplotlib, a Mermaid fault evolution diagram showing failure sequences, and an evidence index mapping findings to remediation actions.

Does this work with logs and traces in addition to metrics?

Yes. The Skill accepts optional logs and traces directories alongside metrics data. It correlates all three data sources to verify temporal causality, rank anomalies, and test hypotheses across distributed system boundaries.

How quickly can I reduce mean time to detection and resolution?

By automating data collection, anomaly scoring, and hypothesis evaluation across microservice boundaries, the Skill accelerates incident investigation. It enables faster identification of resource contention and backpressure-driven root causes compared to manual log analysis.

What are the prerequisites for running an analysis?

You need metrics data as CSV files, an incident time window (e.g., 07:00:00 ± 30s), and optionally logs or traces directories. The Skill handles data ingestion and processing automatically using polars, numpy, and matplotlib.

Related Skills