dbt-debugging

Diagnose and fix common dbt run and parse errors.

475|25|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/SignalPilot-Labs/SignalPilot --skill dbt-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dbt-debugging
Source: https://github.com/SignalPilot-Labs/SignalPilot/tree/main/benchmark/signalpilot-plugin/skills/dbt-debugging
Command: npx skills add https://github.com/SignalPilot-Labs/SignalPilot --skill dbt-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

dbt projects frequently fail during run or parse due to issues like duplicate YAML patches, unresolved references, passthrough model warnings, current_date-related warnings, DuckDB error messages, or zero-row results. This Skill provides structured guidance to diagnose and resolve these common dbt errors, reducing debugging time and improving reliability.

Core Features & Use Cases

  • Detect and guide fixes for Duplicate YML patches and reference errors in dbt projects.
  • Provide actionable steps for Passthrough model warnings, current_date issues, and common DuckDB error messages.
  • Help diagnose zero-row models and package/model build failures, with deterministic steps for remediation.
  • Use in CI/CD pipelines or during development when dbt runs fail, to accelerate root-cause analysis and repairs.

Quick Start

Run this skill when a dbt run or parse fails, and follow the step-by-step guidance to diagnose and fix the issues described above.

Frequently Asked Questions about dbt-debugging

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

FAQPage Schema
How do I fix duplicate YAML patch errors when parsing a dbt project?

To fix duplicate YAML patch errors in dbt, you need to diagnose conflicting property definitions across your schema files. This Skill provides structured checks to identify duplicate patches and actionable steps to resolve the reference conflicts quickly.

Why does my dbt run fail with unresolved ref resolution errors?

Unresolved ref resolution errors occur when dbt cannot find a model referenced in your code. This Skill diagnoses these reference failures during dbt runs and applies scripted checks to guide you through correcting the model dependencies.

How do I troubleshoot zero-row models and passthrough warnings in dbt?

Troubleshooting zero-row models and passthrough warnings in dbt requires deterministic root-cause analysis. This Skill helps diagnose why models return no rows and provides guided fixes for passthrough warnings to restore data flow.

Can I use this to diagnose DuckDB errors and current_date issues during dbt runs?

Yes, you can use this Skill to diagnose DuckDB errors and current_date-related warnings during dbt runs. It provides actionable remediation steps specifically targeting these common dbt execution failures.

What is the best way to debug dbt package or model build failures in CI/CD pipelines?

The best way to debug dbt model build failures in CI/CD pipelines is to apply structured diagnostic checks. This Skill integrates into dbt workflows to accelerate root-cause analysis and provide deterministic fallback recommendations for failed builds.

When should I not use automated dbt debugging for my data engineering workflows?

Automated dbt debugging should not replace manual intervention for complex, custom adapter failures outside standard error categories. This Skill targets duplicate YAML patches, ref errors, and DuckDB messages, providing fallback recommendations when scripted fixes are insufficient.