Data
Plugin
dbt-agent-skills
A curated collection of Agent Skills for working with dbt. These skills help AI agents understand and execute dbt workflows more effectively.
Plugin Signal80/100Strong
maintained97
capable58
documented100
adopted60
Install on Claude Code
> /plugin marketplace add dbt-labs/dbt-agent-skills
In this plugin
- auditing-skills
- creating-mermaid-dbt-dag
- migrating-dbt-core-to-fusion
- migrating-dbt-project-across-platforms
- upgrading-dbt-core
- adding-dbt-unit-test
- answering-natural-language-questions-with-dbt
- building-dbt-semantic-layer
- configuring-dbt-mcp-server
- fetching-dbt-docs
- running-dbt-commands
- troubleshooting-dbt-job-errors
- using-dbt-for-analytics-engineering
- using-dbt-state
- working-with-dbt-mesh
What's inside
Skills
15/auditing-skillsUse when checking skills for security or quality issues, reviewing audit results from skills.sh or Tessl, or remediating findings across published skills./creating-mermaid-dbt-dagGenerates a Mermaid flowchart diagram of dbt model lineage using MCP tools, manifest.json, or direct code parsing as fallbacks. Use when visualizing dbt model lineage and dependencies as a Mermaid diagram in markdown format./migrating-dbt-core-to-fusionUse when a user needs help triaging dbt-core to Fusion migration errors. Runs dbt-autofix first, then classifies remaining errors into actionable categories (auto-fixable, guided fixes, needs input, blocked)./migrating-dbt-project-across-platformsUse when migrating a dbt project from one data platform or data warehouse to another (e.g., Snowflake to Databricks, Databricks to Snowflake) using dbt Fusion's real-time compilation to identify and fix SQL dialect differences./upgrading-dbt-coreUse when a user wants to upgrade, update, or migrate a dbt-core project to a newer or the latest version — e.g. "upgrade my dbt project," "migrate this off dbt-core 1.5," "get this project running on the latest dbt," "bump the dbt-core version." Upgrades a dbt-core v1 project/adding-dbt-unit-testCreates unit test YAML definitions that mock upstream model inputs and validate expected outputs. Use when adding unit tests for a dbt model or practicing test-driven development (TDD) in dbt.
Show all 15 skillsShow fewer
/answering-natural-language-questions-with-dbtWrites and executes SQL queries against the data warehouse using dbt's Semantic Layer or ad-hoc SQL to answer business questions. Use when a user asks about analytics, metrics, KPIs, or data (e.g., "What were total sales last quarter?", "Show me top customers by revenue"). NOT/building-dbt-semantic-layerUse when creating or modifying dbt Semantic Layer components — semantic models, metrics, dimensions, entities, measures, or time spines. Covers MetricFlow configuration, metric types (simple, derived, cumulative, ratio, conversion), and validation for both latest and legacy YAML/configuring-dbt-mcp-serverGenerates MCP server configuration JSON, resolves authentication setup, and validates server connectivity for dbt. Use when setting up, configuring, or troubleshooting the dbt MCP server for AI tools like Claude Desktop, Claude Code, Cursor, or VS Code./fetching-dbt-docsRetrieves and searches dbt documentation pages in LLM-friendly markdown format. Use when fetching dbt documentation, looking up dbt features, or answering questions about dbt Cloud, dbt Core, or the dbt Semantic Layer./running-dbt-commandsFormats and executes dbt CLI commands, selects the correct dbt executable, and structures command parameters. Use when running models, tests, builds, compiles, or show queries via dbt CLI. Use when unsure which dbt executable to use or how to format command parameters./troubleshooting-dbt-job-errorsDiagnoses 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/using-dbt-for-analytics-engineeringBuilds and modifies dbt models, writes SQL transformations using ref() and source(), creates tests, and validates results with dbt show. Use when doing any dbt work - building or modifying models, debugging errors, exploring unfamiliar data sources, writing tests, or evaluating/using-dbt-stateUse when a user is enabling, configuring, optimizing, or debugging dbt State (the server-backed reuse mechanism that clones or skips nodes instead of rebuilding them). Use when they conflate dbt State with the `state:modified` selector or `--state` deferral. Use when asked about/working-with-dbt-meshUse when changing a dbt model in a way that could break its consumers — renaming, removing, or retyping a column, or changing a model that downstream models, exposures, dashboards, or BI tools depend on — to judge whether the change is breaking and who it affects. Also use when
README
1dbt Agent Skills
A curated collection of Agent Skills for working with dbt. These skills help AI agents understand and execute dbt workflows more effectively.
What are Agent Skills?
Agent Skills are folders of instructions, scripts, and resources that agents can discover and use to do things more accurately and efficiently.
How They Work
These skills are not slash commands or user-invoked actions. Once installed, the agent automatically loads the relevant skill when your prompt matches its use case. Just describe what you need in natural language and the agent handles the rest. See skill invocation control for more details.
What's Included
- Analytics engineering: Build and modify dbt models, write tests, explore data sources
- Semantic layer: Create metrics, dimensions, and semantic models with MetricFlow
- dbt Mesh: Work with multi-project setups, cross-project refs, model governance (contracts, versions, access)
- Platform operations: Troubleshoot job failures, configure the dbt MCP server
- Migration: Move projects from dbt Core to the Fusion engine
Installation
Claude Code
Add the dbt skills marketplace and install the plugins:
# Add the marketplace
/plugin marketplace add dbt-labs/dbt-agent-skills
# Install the dbt skills (analytics engineering, semantic layer, testing, etc.)
/plugin install dbt@dbt-agent-marketplace
# Install the migration skills (typically a one-off — not needed for every session)
/plugin install dbt-migration@dbt-agent-marketplace
Other AI Clients
Vercel Skills CLI
Use the Vercel Skills CLI to install skills from this repository. Supports 30+ AI agents including Cursor, Cline, GitHub Copilot, and others.
# Preview available skills
npx skills add dbt-labs/dbt-agent-skills --list
# Install all skills
npx skills add dbt-labs/dbt-agent-skills
# Install only the dbt skills (analytics engineering, semantic layer, etc.)
npx skills add dbt-labs/dbt-agent-skills/skills/dbt
# Install only the migration skills
npx skills add dbt-labs/dbt-agent-skills/skills/dbt-migration
# Install a specific skill
npx skills add dbt-labs/dbt-agent-skills --skill using-dbt-for-analytics-engineering
# Install globally (available in all projects, stored in ~/.<agent>/skills/)
npx skills add dbt-labs/dbt-agent-skills --global
# Check for updates
npx skills check
# Update installed skills
npx skills update
Tessl
Install skills using Tessl, a package manager for agent skills:
# Install all skills
tessl install dbt-labs/dbt-agent-skills
# Install a specific skill
tessl install dbt-labs/dbt-agent-skills --skill using-dbt-for-analytics-engineering
# Install from GitHub directly
tessl install github:dbt-labs/dbt-agent-skills
Browse the tile on the Tessl registry.
Compatible Agents
These skills work with AI agents that support the Agent Skills format.
Available Skills
dbt (analytics engineering)
| Skill | Description |
|---|---|
using-dbt-for-analytics-engineering | Build and modify dbt models, debug errors, explore data sources, write tests |
adding-dbt-unit-test | Add unit tests for dbt models, practice test-driven development |
building-dbt-semantic-layer | Create semantic models, metrics, and dimensions with MetricFlow |
answering-natural-language-questions-with-dbt | Answer business questions by querying the semantic layer |
working-with-dbt-mesh | Implement dbt Mesh governance (contracts, access, groups, versions) and cross-project collaboration |
troubleshooting-dbt-job-errors | Diagnose and resolve dbt platform job failures |
configuring-dbt-mcp-server | Set up the dbt MCP server for Claude, Cursor, or VS Code |
fetching-dbt-docs | Look up dbt documentation efficiently |
running-dbt-commands | Run dbt CLI commands with correct flags, selectors, and parameter formats |
dbt-migration (one-off use)
These skills are typically used once during a migration project rather than in every agent session.
| Skill | Description |
|---|---|
migrating-dbt-core-to-fusion | Migrate dbt projects from dbt Core to the Fusion engine |
migrating-dbt-project-across-platforms | Migrate dbt projects across data platforms |
upgrading-dbt-core | Upgrade a dbt-core v1 project (1.3-1.7) to the latest dbt-core, applying breaking, behavior, and deprecated changes |
Prerequisites
Most skills assume:
- dbt is installed and configured
- A dbt project with
dbt_project.ymlexists - Basic familiarity with dbt concepts (models, tests, sources)
Some skills like fetching-dbt-docs and configuring-dbt-mcp-server can be used without an existing project.
Contributing
We welcome contributions! Whether you want to add a new dbt skill, improve existing ones, or fix issues, please see our Contributing Guide.
Format Specification
All skills in this repository follow the Agent Skills specification to ensure compatibility across different agent products.
Resources
Community
- Issues: Report problems or suggest new skills
- Discussions: Share use cases and patterns
- Pull Requests: Contribute new skills or improvements
- Star this repository if you find it useful!
License
See LICENSE for details.
Skill Evaluation
See evals/README.md for the A/B testing tool to compare skill variations.
File tree
273dbt-labs/dbt-agent-skillsView on GitHub
.changes/
header.tpl.md
unreleased/
.gitkeep
Docs-20260130-093412.yaml
Features-20260303-120000.yaml
Features-20260616-101133.yaml
Fixes-20260203-104922.yaml
Fixes-20260715-102833.yaml
Under the Hood-20260211-085024.yaml
Under the Hood-20260217-122047.yaml
Under the Hood-20260217-132356.yaml
Under the Hood-20260217-143356.yaml
Under the Hood-20260218-100000.yaml
Under the Hood-20260220-103318.yaml
.changie.yaml
.claude/
.claude-plugin/
marketplace.json
skills/
auditing-skills/
SKILL.md
.cursor-plugin/
marketplace.json
.github/
CODEOWNERS
dependabot.yml
ISSUE_TEMPLATE/
bug-report.md
config.yml
new-skill.md
pull_request_template.md
workflows/
codeowners-check.yml
publish-tile.yml
.gitignore
.pre-commit-config.yaml
CHANGELOG.md
CLAUDE.md
CONTRIBUTING.md
evals/
.gitignore
AGENTS.md
CLAUDE.md
pyproject.toml
README.md
runs/
.gitignore
scenarios/
.gitignore
dbt-docs-arguments/
prompt.txt
scenario.md
skill-sets.yaml
dbt-docs-unit-test-fixtures/
prompt.txt
scenario.md
skill-sets.yaml
dbt-job-failure/
.env.example
prompt.txt
scenario.md
skill-sets.yaml
dbt-unit-test-format-choice/
prompt.txt
scenario.md
skill-sets.yaml
example-yaml-error/
context/
models/
broken.yml
prompt.txt
scenario.md
skill-sets.yaml
fusion-migration-triage-basic/
context/
dbt_compile_output.txt
dbt_project.yml
models/
example_model.sql
prompt.txt
scenario.md
skill-sets.yaml
fusion-migration-triage-blocked/
context/
dbt_compile_output.txt
dbt_project.yml
models/
example_model.sql
prompt.txt
scenario.md
skill-sets.yaml
fusion-triage-cat-a-static-analysis/
context/
analyses/
explore_data.sql
dbt_compile_output.txt
dbt_project.yml
models/
example_model.sql
prompt.txt
scenario.md
skill-sets.yaml
fusion-triage-cat-b-dict-meta-get/
context/
dbt_compile_output.txt
dbt_project.yml
models/
example_model.sql
prompt.txt
scenario.md
skill-sets.yaml
fusion-triage-cat-b-unexpected-config/
context/
dbt_compile_output.txt
dbt_project.yml
models/
my_model.sql
prompt.txt
scenario.md
skill-sets.yaml
fusion-triage-cat-b-unused-schema/
context/
dbt_compile_output.txt
dbt_project.yml
models/
schema.yml
stg_orders.sql
prompt.txt
scenario.md
skill-sets.yaml
fusion-triage-cat-b-yaml-syntax/
context/
dbt_compile_output.txt
dbt_project.yml
models/
example_model.sql
prompt.txt
scenario.md
skill-sets.yaml
fusion-triage-cat-c-hardcoded-fqn/
context/
dbt_compile_output.txt
dbt_project.yml
models/
example_model.sql
prompt.txt
scenario.md
skill-sets.yaml
semantic-layer-inline-latest-spec/
prompt.txt
scenario.md
skill-sets.yaml
semantic-layer-inline-legacy-spec/
prompt.txt
scenario.md
skill-sets.yaml
src/
skill_eval/
__init__.py
cli.py
grader.py
logging.py
models.py
reporter.py
runner.py
scaffold.py
selector.py
templates/
.env
prompt.txt
scenario.md
skill-sets.yaml
tests/
test_cli_commands.py
test_cli.py
test_grader.py
test_models.py
test_reporter.py
test_runner.py
test_scaffold.py
test_selector.py
test_semantic_layer_examples.py
uv.lock
LICENSE
pyproject.toml
README.md
RELEASING.md
scripts/
dbt-skills-install
README.md
validate_repo.py
skills/
dbt/
dbt-extras/
.claude-plugin/
plugin.json
skills/
creating-mermaid-dbt-dag/
references/
parsing-code-directly.md
using-get-lineage-dev.md
using-get-lineage.md
using-manifest-json.md
SKILL.md
dbt-migration/
.claude-plugin/
plugin.json
skills/
migrating-dbt-core-to-fusion/
references/
classification-categories.md
error-patterns-reference.md
README.md
SKILL.md
migrating-dbt-project-across-platforms/
references/
generating-unit-tests.md
installing-dbt-fusion.md
switching-targets.md
SKILL.md
upgrading-dbt-core/
references/
_schema.json
bigquery/
1_3_008.yaml
1_3_009.yaml
1_3_012.yaml
1_4_015.yaml
1_6_006.yaml
core/
1_10_001.yaml
1_10_002.yaml
1_11_001.yaml
1_11_002.yaml
1_11_003.yaml
1_11_004.yaml
1_11_005.yaml
1_11_006.yaml
1_11_007.yaml
1_3_001.yaml
1_3_002.yaml
1_3_003.yaml
1_3_013.yaml
1_3_014.yaml
1_4_001.yaml
1_4_002.yaml
1_4_003.yaml
1_4_004.yaml
1_4_005.yaml
1_4_006.yaml
1_4_007.yaml
1_4_008.yaml
1_5_001.yaml
1_5_002.yaml
1_5_003.yaml
1_6_001.yaml
1_6_002.yaml
1_6_003.yaml
1_6_011.yaml
1_7_001.yaml
1_7_002.yaml
1_7_003.yaml
1_7_008.yaml
1_7_009.yaml
1_7_010.yaml
1_8_001.yaml
1_8_002.yaml
1_8_003.yaml
1_8_004.yaml
1_9_001.yaml
1_9_002.yaml
1_9_003.yaml
databricks/
1_3_004.yaml
1_3_005.yaml
1_3_006.yaml
1_5_010.yaml
1_6_005.yaml
redshift/
1_3_007.yaml
1_4_011.yaml
1_4_013.yaml
1_4_014.yaml
1_5_006.yaml
1_5_007.yaml
1_5_008.yaml
1_6_004.yaml
1_7_004.yaml
snowflake/
1_3_015.yaml
1_4_009.yaml
spark/
1_3_010.yaml
1_3_011.yaml
1_6_010.yaml
scripts/
tools.py
validate.py
SKILL.md
.claude-plugin/
plugin.json
.cursor-plugin/
plugin.json
skills/
adding-dbt-unit-test/
references/
examples.md
spec.md
special-cases-ephemeral-dependency.md
special-cases-incremental-model.md
special-cases-special-case-overrides.md
special-cases-versioned-model.md
warehouse-bigquery-caveats.md
warehouse-bigquery-data-types.md
warehouse-postgres-data-types.md
warehouse-redshift-caveats.md
warehouse-redshift-data-types.md
warehouse-snowflake-data-types.md
warehouse-spark-data-types.md
SKILL.md
answering-natural-language-questions-with-dbt/
SKILL.md
building-dbt-semantic-layer/
references/
best-practices.md
latest-spec.md
legacy-spec.md
time-spine.md
SKILL.md
configuring-dbt-mcp-server/
references/
environment-variables.md
finding-credentials.md
troubleshooting.md
SKILL.md
fetching-dbt-docs/
scripts/
search-dbt-docs.sh
SKILL.md
running-dbt-commands/
SKILL.md
troubleshooting-dbt-job-errors/
references/
investigation-template.md
SKILL.md
using-dbt-for-analytics-engineering/
references/
debugging-dbt-errors.md
discovering-data.md
evaluating-impact-of-a-dbt-model-change.md
managing-packages.md
planning-dbt-models.md
writing-data-tests.md
writing-documentation.md
scripts/
review_run_results.md
SKILL.md
using-dbt-state/
SKILL.md
working-with-dbt-mesh/
references/
cross-project-collaboration.md
groups-and-access.md
model-contracts.md
model-versions.md
SKILL.md
tile.json
uv.lockFAQ
dbt-agent-skills is a Claude Code plugin with 15 hand-picked skills for data work, indexed on Flowy. Install it with the command on its page. It includes auditing-skills, creating-mermaid-dbt-dag, migrating-dbt-core-to-fusion. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is dbt-agent-skills?
- A curated collection of Agent Skills for working with dbt. These skills help AI agents understand and execute dbt workflows more effectively.
- How do I install dbt-agent-skills?
- Run these in Claude Code: /plugin marketplace add dbt-labs/dbt-agent-skills. Then prompt normally.
- Does dbt-agent-skills auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is dbt-agent-skills free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.