dbt-troubleshooting

Classifies Airflow errors and guides users through step-by-step troubleshooting and recovery workflows.

8|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/rittmananalytics/wire-plugin --skill dbt-troubleshooting
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dbt-troubleshooting
Source: https://github.com/rittmananalytics/wire-plugin/tree/main/skills/dbt-troubleshooting
Command: npx skills add https://github.com/rittmananalytics/wire-plugin --skill dbt-troubleshooting

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps users proactively identify and resolve failures in dbt data transformation workflows, reducing downtime and improving data reliability.

Core Features & Use Cases

  • Error Classification: Distinguishes infrastructure, code, or data-related issues for faster troubleshooting.
  • Root Cause Investigation: Guides through investigation steps such as analyzing logs, SQL, and recent changes.
  • Use Case: When a dbt model fails during run, users can follow this Skill's workflow to pinpoint whether the error stems from environment issues, code syntax, or data anomalies, then implement targeted fixes.

Quick Start

Describe the encountered error, then follow the diagnostic workflows and queries to identify and fix the root cause.

Frequently Asked Questions about dbt-troubleshooting

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

FAQPage Schema
How do I troubleshoot a failing dbt data pipeline job?

To troubleshoot a failing dbt data pipeline, describe the encountered error to classify it as an infrastructure, code, or data quality issue, then follow diagnostic workflows to pinpoint and implement targeted fixes.

Why does my dbt model fail during a run?

A dbt model fails during a run due to environment issues, code syntax errors, or data anomalies. Analyze logs, SQL, and recent changes to investigate the root cause and resolve the specific failure.

What is the best way to diagnose dbt errors in BigQuery?

Diagnosing dbt errors in BigQuery involves classifying the failure type and guiding root cause investigation by analyzing logs, SQL, and recent changes to recommend corrective actions across infrastructure and data quality.

How do I identify if a dbt job failure is a data quality issue?

Identify if a dbt job failure is a data quality issue by distinguishing it from infrastructure or code problems, then analyzing the SQL logic and data anomalies to confirm the root cause of the transformation error.

Can I use this to find the root cause of dbt transformation errors?

Yes, you can find the root cause of dbt transformation errors by following guided investigation steps that analyze logs, SQL, and recent changes to classify the failure and recommend corrective actions.