troubleshooting-dbt-job-errors
OfficialDiagnose and fix failing dbt Cloud jobs.
Authordbt-labs
Version1.0.0
Installs0
System Documentation
What problem does it solve?
Use when a dbt Cloud/platform job fails and you need to diagnose the root cause, especially when error messages are unclear or when intermittent failures occur. Do not use for local dbt development errors.
Core Features & Use Cases
- Systematic MCP-based diagnostic workflow to identify root causes (Infrastructure, Code/Compilation, Data/Test Failure)
- Guidance on gathering logs, run_results, and contextual artifacts, classification of failure types, and recommended remediation steps
- Documentation and handoff artifacts when the root cause cannot be determined, including creating investigation findings
Quick Start
Describe a failing dbt Cloud job and gather logs, run_results.json, and recent changes to diagnose the root cause.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: troubleshooting-dbt-job-errors Download link: https://github.com/dbt-labs/dbt-agent-skills/archive/main.zip#troubleshooting-dbt-job-errors Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.