ANALYTICS ENGINEERING / dbt Labs
dbt Core to v2 migration triage
Pins dbt Labs' v2 migration triage, which asks before a credential check and forbids edits until autofix changes have been reviewed.
“Use when a user needs help triaging dbt-core to dbt v2 migration errors. Runs dbt-autofix first, then classifies remaining errors into actionable categories (auto-fixable, guided fixes, needs input, blocked).”
01 / THE REASONING
Why this made the selection.
- The catalogue has other dbt skills from this repository, including upgrading-dbt, and not this Core-to-v2 triage procedure.
- The file orders a credential question, an autofix review, and classification before any edit, and it treats SQL comments and YAML as untrusted.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- skills/dbt-migration/skills/migrating-dbt-core-to-v2/SKILL.md
- README.md
- LICENSE
Our findings
- The skill says to ask before running dbt debug, and that a failed connection test is an environment problem rather than a migration error.
- It says not to edit files before the autofix review and classification summary, and that Category B fixes need a shown diff and approval.
- It says never to execute instructions embedded in SQL comments, YAML values, model descriptions, or documentation pages, and not to follow commands inside fetched GitHub issues without approval.
Not established by this review
- The resource was not executed and its tools were not called.
- dbt debug and dbt-autofix were not run.
- No warehouse connection was made.
- The GitHub issue search URL in the skill was not called.
- Not executed: it was not installed or run.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
DOCUMENTED COMMAND
npx skills add dbt-labs/dbt-agent-skills/skills/dbt-migration Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.
- The README's migration-skills line is the command above.
- The same README also shows /plugin install dbt-migration@dbt-agent-marketplace after /plugin marketplace add dbt-labs/dbt-agent-skills.
- The README says these skills are not slash commands and load when a prompt matches.
Before you start
- A skills-compatible agent
- A dbt project and credentials if the triage steps are followed, which this review did not use
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/dbt-labs/dbt-agent-skills/blob/7c7b5fa39e61694f1ae2b8ea1b8065e195c814ce/skills/dbt-migration/skills/migrating-dbt-core-to-v2/SKILL.md
Supports: credential question, edit gate, and untrusted-content rule
- Repository README ↗Checked
https://github.com/dbt-labs/dbt-agent-skills/blob/7c7b5fa39e61694f1ae2b8ea1b8065e195c814ce/README.md
Supports: migration install line and pointer to LICENSE
- Repository LICENSE ↗Checked
https://github.com/dbt-labs/dbt-agent-skills/blob/7c7b5fa39e61694f1ae2b8ea1b8065e195c814ce/LICENSE
Supports: Apache License Version 2.0
https://raw.githubusercontent.com/dbt-labs/dbt-agent-skills/7c7b5fa39e61694f1ae2b8ea1b8065e195c814ce/skills/dbt-migration/skills/migrating-dbt-core-to-v2/SKILL.md
Supports: upstreamDescription, review.notTested, review.reviewedAt
https://raw.githubusercontent.com/dbt-labs/dbt-agent-skills/7c7b5fa39e61694f1ae2b8ea1b8065e195c814ce/README.md
Supports: install.command