migrating-dbt-core-to-fusion

Migrate dbt Core projects to Fusion using dbtf debug, parse, autofix, and compile.

653|60|Updated Jan 8, 2026
One-click install
npx skills add https://github.com/dbt-labs/dbt-agent-skills --skill migrating-dbt-core-to-fusion-dbt-labs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migrating-dbt-core-to-fusion
Source: https://github.com/dbt-labs/dbt-agent-skills/tree/main/skills/migrating-dbt-core-to-fusion
Command: npx skills add https://github.com/dbt-labs/dbt-agent-skills --skill migrating-dbt-core-to-fusion-dbt-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Guides teams through migrating dbt Core projects to Fusion, addressing deprecations and aligning projects with Fusion's authoring layer.

Core Features & Use Cases

  • Migration workflow guidance: Step-by-step procedure to verify connections, identify deprecations, autofix issues, and complete migration with zero errors.
  • Resource-driven fixes: Leverages the references directory for manual remediation tips (custom configuration, dynamic SQL, misspelled keys).
  • Audit-ready output: Provides a ready-to-share Migration Changes Summary template (changes_made.md) for documenting code changes and rationale.
  • Validation and tooling: Recommends running dbtf debug, parse, and compile to ensure a clean migration path.

Quick Start

Provide a migration plan to convert a dbt Core project to Fusion and generate a changes_made.md documenting the steps.

Frequently Asked Questions about migrating-dbt-core-to-fusion

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

FAQPage Schema
How do I migrate a dbt Core project to Fusion?

To migrate a dbt Core project to Fusion, follow the step-by-step workflow: run dbtf debug and dbtf parse, apply autofixes, manually resolve remaining issues using references, and run dbtf compile to ensure a clean migration.

What deprecated dbt Core features need to be addressed for Fusion compatibility?

Migrating to Fusion requires addressing deprecated dbt Core features by aligning your project with Fusion's authoring layer, resolving misspelled keys, custom configurations, and dynamic SQL through resource-driven manual remediation tips.

Can I automatically fix deprecation issues when transitioning to dbt Fusion?

Yes, the migration workflow recommends using an autofix step to automatically resolve compatibility issues, followed by manual fixes via the references directory for custom configurations and dynamic SQL to achieve zero errors.

What is the best way to document code changes during a dbt Fusion migration?

The best way to document code changes during a dbt Fusion migration is to generate a Migration Changes Summary template (changes_made.md), providing an audit-ready record of code changes and their rationale.

Why does dbtf compile fail after migrating my dbt Core project to Fusion?

dbtf compile may fail after migrating to Fusion if deprecated features or misspelled keys remain; use the references directory for manual remediation tips and validate the project using dbtf debug and parse before compiling.

Do I need to run dbtf debug and parse before migrating to dbt Fusion?

Yes, running dbtf debug and dbtf parse is required to verify connections and identify deprecations early, ensuring a smooth migration path to dbt Fusion with zero compilation errors.