de-root-cause-analysis

Diagnose data pipeline failures with evidence-driven taxonomy and lineage-aware impact assessment.

14|1|Updated May 5, 2026
One-click install
npx skills add https://github.com/ivanshamaev/de-agent-skills --skill de-root-cause-analysis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: de-root-cause-analysis
Source: https://github.com/ivanshamaev/de-agent-skills/tree/main/skills/de_rca
Command: npx skills add https://github.com/ivanshamaev/de-agent-skills --skill de-root-cause-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you quickly identify why a data engineering pipeline failed or produced incorrect data, so you can restore service and prevent recurrence.

Core Features & Use Cases

  • Failure taxonomy for fast triage: classifies issues into infrastructure, data, logic, dependency, configuration, and concurrency failures with concrete first checks.
  • Investigation workflow (5-step RCA): reconstructs timelines, assesses blast radius, gathers evidence, generates and eliminates hypotheses, and writes a clear root-cause statement.
  • Tech-specific diagnosis patterns: supports practical troubleshooting approaches for Airflow, Spark/PySpark, and dbt, plus data-quality anomaly RCA methods.

Quick Start

Use the de-root-cause-analysis skill to produce a structured root-cause analysis for a failing Airflow DAG run by uploading the relevant logs and stating the affected tables and the incident time window.

Frequently Asked Questions about de-root-cause-analysis

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

FAQPage Schema
How do I perform root cause analysis on Airflow DAG failures or Spark job errors?

Root cause analysis of pipeline failures uses an evidence-driven taxonomy and 5-step investigation workflow to diagnose Airflow DAG stalls and Spark job errors like OOM or shuffle issues. It reconstructs incident timelines and eliminates hypotheses to produce a clear RCA statement.

What is the best way to troubleshoot dbt compilation or runtime test failures?

Troubleshooting dbt compilation and runtime test failures uses tech-specific diagnosis patterns to classify issues into logic, configuration, or dependency failures. The workflow assesses blast radius and gathers evidence to isolate the root cause and generate an incident runbook.

How do I investigate data quality anomalies like sudden volume drops or null explosions?

Investigating data quality anomalies like volume drops and null explosions uses lineage-aware impact assessment to trace upstream and downstream blast radius. The analysis applies evidence-driven hypothesis elimination to identify the exact pipeline failure source.

Can I use this root cause analysis workflow for data pipeline incidents in Airflow, Spark, and dbt together?

Yes, this RCA workflow supports concurrent diagnosis across Airflow, Spark, and dbt environments. It classifies infrastructure, concurrency, and dependency failures while producing a unified runbook-style checklist for deterministic incident documentation.

What steps are needed to start root cause analysis for a failing data pipeline?

Starting root cause analysis requires uploading relevant pipeline logs, stating affected tables, and defining the incident time window. The workflow then reconstructs the timeline, assesses blast radius, and generates elimination steps to isolate the failure.

Why does my data pipeline RCA lack downstream impact visibility during incident triage?

Lineage-aware impact assessment evaluates downstream blast radius to ensure your pipeline RCA captures full incident scope. It maps affected tables and dependencies to prevent blind spots during the failure triage and documentation process.