--- title: "Upgrading dbt: review, setup & limitations · Undominated.ai" canonical: https://undominated.ai/skills/dbt-labs-upgrading-dbt/ description: "Plans a dbt v1 migration to 1.12 using adapter-specific issue bundles and a recorded verification gate." --- # Upgrading dbt: review, setup & limitations · Undominated.ai > Plans a dbt v1 migration to 1.12 using adapter-specific issue bundles and a recorded verification gate. [← Explore all skills](/skills/) DATA AND ANALYTICS / dbt Labs # Upgrading dbt Plans a dbt v1 migration to 1.12 using adapter-specific issue bundles and a recorded verification gate. [See setup guidance ↓](#setup)[Original source ↗](https://github.com/dbt-labs/dbt-agent-skills/tree/168a2b0b92da59be88866257140907c206ff0e44/skills/dbt-migration/skills/upgrading-dbt) SOURCE REVIEW Reviewed 2026-10-07 Evidence 3 linked sources Publisher dbt Labs Licence [Apache-2.0 ↗](https://github.com/dbt-labs/dbt-agent-skills/blob/168a2b0b92da59be88866257140907c206ff0e44/LICENSE) Revision 168a2b0b92da [Read what was—and wasn’t—checked ↓](#review) “Use when a user wants to upgrade, update, or migrate a dbt project to the latest version — e.g. "upgrade my dbt project," "migrate this off dbt 1.5," "get this project running on the latest dbt," "bump the dbt version." Upgrades a dbt v1 project (on 1.3, 1.4, 1.5, 1.6, or 1.7) all the way to 1.12, applying the required breaking, behavior, and deprecated changes from a data-driven issue corpus. Inputs — starting_version (the project's current dbt minor, one of 1.3/1.4/1.5/1.6/1.7) and adapter_type (snowflake/redshift/bigquery/databricks/spark); both are normally supplied by the caller (e.g. the dbt VS Code extension), with fallbacks described in the skill.” [dbt Labs · upstream description ↗](https://github.com/dbt-labs/dbt-agent-skills/blob/168a2b0b92da59be88866257140907c206ff0e44/skills/dbt-migration/skills/upgrading-dbt/SKILL.md) Our analysis follows below. 01 / THE REASONING ## Why this made the selection. - Separates sequential pre-1.8 changes from detected behavior flags and preserves unresolved outside-repository job changes. - Distinguishes parse-only evidence from user-approved compile, test and build results, preserving issue and phase histories. ### A good fit for - Planning a dbt upgrade from 1.3–1.7 - Checking that a migration does not skip a required boundary ### Weigh up before choosing - Its stated target is 1.12, not a promise to reach whichever release is newest. Starting versions 1.3–1.7 have bundles; later versions have narrower flag handling. Parsing alone does not prove migration correctness. - Reviewed definition and licence are pinned; installation and real-task outcomes for this resource were not tested. 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/upgrading-dbt/SKILL.md (complete frontmatter and body) - https://github.com/dbt-labs/dbt-agent-skills/blob/168a2b0b92da59be88866257140907c206ff0e44/LICENSE (applicable licence text) ### Our findings - Separates sequential pre-1.8 changes from detected behavior flags and preserves unresolved outside-repository job changes. - Distinguishes parse-only evidence from user-approved compile, test and build results, preserving issue and phase histories. - Reads project/profiles, writes migration artifacts and project files, and runs the selected local or Studio dbt workflow. Approved verification can query or build warehouse data. ### Not established by this review - Host discovery, task execution and model quality were not tested. - Referenced helpers, sibling plugins and external service operations were not exhaustively audited or executed. 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. [Upstream setup instructions ↗](https://github.com/dbt-labs/dbt-agent-skills/blob/168a2b0b92da59be88866257140907c206ff0e44/README.md) DOCUMENTED COMMAND npx skills@1.7.1 add https://github.com/dbt-labs/dbt-agent-skills/tree/168a2b0b92da59be88866257140907c206ff0e44/skills/dbt-migration/skills/upgrading-dbt --skill upgrading-dbt Copy command ↗ Copying does not execute this command. It may retrieve a newer version than the reviewed source. - Use the exact reviewed directory/revision and select the intended host/project scope in Skills CLI. - Retain all supporting files; separately configure companion skills, runtimes and service credentials named in the definition. - Review the resulting diff and use an isolated target before any migration, deployment, load test or warehouse operation. ### Before you start - The complete upgrading-dbt directory and compiled issue bundles, a supported adapter, an isolated migration branch and the relevant local or Studio execution profile. ### Compatibility Agent Skills-compatible hosts · dbt 1.3 through 1.7 as a starting version ### Host-mediated code, files and tools - Reads project/profiles, writes migration artifacts and project files, and runs the selected local or Studio dbt workflow. Approved verification can query or build warehouse data. - The host enforces permissions; installing instructions does not itself create a sandbox. ### Cost model Source is available under the stated licence. Model usage, compute and connected services can incur charges. 04 / FOLLOW THE EVIDENCE ## The source trail. Our notes are separate from the original resource. Check upstream before adopting a new version. - [Skill definition ↗](https://github.com/dbt-labs/dbt-agent-skills/blob/168a2b0b92da59be88866257140907c206ff0e44/skills/dbt-migration/skills/upgrading-dbt/SKILL.md) Checked 2026-10-07 https://github.com/dbt-labs/dbt-agent-skills/blob/168a2b0b92da59be88866257140907c206ff0e44/skills/dbt-migration/skills/upgrading-dbt/SKILL.md Supports: summary, whySelected, limitations, access, review - [Repository licence ↗](https://github.com/dbt-labs/dbt-agent-skills/blob/168a2b0b92da59be88866257140907c206ff0e44/LICENSE) Checked 2026-10-07 https://github.com/dbt-labs/dbt-agent-skills/blob/168a2b0b92da59be88866257140907c206ff0e44/LICENSE Supports: Redistribution terms - [Install instructions ↗](https://github.com/dbt-labs/dbt-agent-skills/blob/168a2b0b92da59be88866257140907c206ff0e44/README.md) Checked 2026-10-07 https://github.com/dbt-labs/dbt-agent-skills/blob/168a2b0b92da59be88866257140907c206ff0e44/README.md Supports: Documented install command KEEP COMPARING ## Other approaches to consider. Related by category or shared topics. These are alternatives to inspect, not a measured quality order. [### Adding a dbt unit test ↗ Builds dbt SQL-model unit tests from explicit input fixtures and expected output rows.](/skills/dbt-labs-adding-dbt-unit-test/)[### dbt Documentation Maintenance ↗ Audits descriptions in a dbt manifest and drafts missing model or column documentation in the project’s existing style.](/skills/dbt-labs-maintaining-dbt-documentation/)[### Expo Web to Native Migration ↗ Migrates a web React codebase to a native Expo app screen by screen: native shell first, whole web UI shippable in DOM components on day one, then strangler-order nativization with device verification.](/skills/expo-expo-web-to-native/) [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/) ## Continue your investigation - [Choose a toolkit](/tools/) - [Inspect execution hosts](/agents/) - [Check tool access](/mcp-servers/) - [Check project dependencies](/check-repo/)