dbt

dbt Troubleshoot

Debug broken dbt builds with project context.

Diagnose dbt compilation failures, runtime errors, failing tests, wrong results, and performance issues.

Debug dbt with an agent that knows your project.

The problem it solves

When dbt fails, pasting the error into a chatbot is usually not enough. The fix depends on model SQL, compiled SQL, upstream dependencies, tests, configuration, and warehouse-specific errors.

What it does

Follows a structured dbt debugging workflow.

Inspects the failing model, compiled context, and likely upstream causes.

Explains the root cause rather than only patching the symptom.

Recommends or applies fixes when file edits are appropriate.

When to use it

WHEN

a dbt build, run, compile, or test command fails

WHEN

a model returns wrong or unexpected data

WHEN

a dbt model is slow or timing out

WHEN

a warehouse error needs to be mapped back to dbt logic

How it works

The skill checks project health, inspects the failing artifact, follows dependencies, diagnoses the likely cause, proposes a fix path, and validates the result.