# Troubleshooting dbt Job Errors

Investigate failed dbt jobs using logs and project history\.

Canonical: https://claudelist.com/listings/skill-dbt-labs-dbt-agent-skills-troubleshooting-dbt-job-errors

Category: Skills

Source: vendor · dbt Labs

Source checked: 2026-10-14

Website: https://github.com/dbt-labs/dbt-agent-skills/tree/main/skills/dbt/skills/troubleshooting-dbt-job-errors

Diagnoses dbt Cloud/platform job failures by analyzing run logs, querying the Admin API, reviewing git history, and investigating data issues. 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.

## Install or set up

1. Review this skill’s `SKILL.md` and any prerequisites at the source.
2. From the project where you use Claude Code, run the command below. It installs only this skill into project scope; add `-g` for your personal scope.
3. Restart Claude Code and invoke `/troubleshooting-dbt-job-errors` or ask Claude to use the skill. If it does not appear, check `.claude/skills/` and the source’s setup notes.

```sh
npx skills add https://github.com/dbt-labs/dbt-agent-skills/tree/main/skills/dbt/skills/troubleshooting-dbt-job-errors --agent claude-code
```

Installation guide: https://github.com/dbt-labs/dbt-agent-skills/tree/main/skills/dbt/skills/troubleshooting-dbt-job-errors