---
title: "dbt-labs/dbt-agent-skills skills · skilld"
canonical_url: "https://skilld.dev/gh/dbt-labs/dbt-agent-skills"
meta:
description: "A curated collection of Agent Skills for working with dbt, to help AI agents understand and execute dbt workflows more effectively."
"og:description": "A curated collection of Agent Skills for working with dbt, to help AI agents understand and execute dbt workflows more effectively."
"og:title": "dbt-labs/dbt-agent-skills skills"
"twitter:description": "A curated collection of Agent Skills for working with dbt, to help AI agents understand and execute dbt workflows more effectively."
"twitter:title": "dbt-labs/dbt-agent-skills skills"
---
`
[All skills](https://skilld.dev/skills)
[](https://skilld.dev/gh/dbt-labs)
# **dbt-labs/dbt-agent-skills**
A curated collection of Agent Skills for working with dbt, to help AI agents understand and execute dbt workflows more effectively.
main Updated 7 hours ago [GitHub](https://github.com/dbt-labs/dbt-agent-skills)
## Repository statistics
- Indexed skills
**16**
- Skill groups
**1**
- GitHub stars
**729**
- Forks
**62**
## Skills
16 total
Sort skills
[
**/migrating-dbt-core-to-v2**
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). /migrating-dbt-core-to-v2](https://skilld.dev/gh/dbt-labs/dbt-agent-skills/migrating-dbt-core-to-v2)
Updated last week
[
**/upgrading-dbt**
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. /upgrading-dbt](https://skilld.dev/gh/dbt-labs/dbt-agent-skills/upgrading-dbt)
Updated last week
[
**/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. /troubleshooting-dbt-job-errors](https://skilld.dev/gh/dbt-labs/dbt-agent-skills/troubleshooting-dbt-job-errors)
Updated 3 weeks ago
[
**/migrating-dbt-project-across-platforms**
Use 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. /migrating-dbt-project-across-platforms](https://skilld.dev/gh/dbt-labs/dbt-agent-skills/migrating-dbt-project-across-platforms)
Updated 4 weeks ago
[
**/maintaining-dbt-documentation**
Audits dbt documentation coverage and drafts missing model/column descriptions in the project's own house style, one folder at a time, for human review. Use when documenting undocumented models, backfilling missing YAML descriptions, auditing doc coverage, or keeping schema YAML in sync with model SQL — especially on multi-contributor projects where new models routinely land undocumented. /maintaining-dbt-documentation](https://skilld.dev/gh/dbt-labs/dbt-agent-skills/maintaining-dbt-documentation)
Updated last month
[
**/building-dbt-semantic-layer**
Use 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 specs. /building-dbt-semantic-layer](https://skilld.dev/gh/dbt-labs/dbt-agent-skills/building-dbt-semantic-layer)
Updated 3 months ago
[
**/using-dbt-state**
Use 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 models rebuilding unexpectedly, views with \`select \*\` rebuilding, volatile SQL (\`current\_timestamp()\`, \`random()\`) rebuilding or not, cross-developer cloning, lag\_tolerance. /using-dbt-state](https://skilld.dev/gh/dbt-labs/dbt-agent-skills/using-dbt-state)
Updated 3 months ago
[
**/using-dbt-for-analytics-engineering**
Builds 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 impact of changes. /using-dbt-for-analytics-engineering](https://skilld.dev/gh/dbt-labs/dbt-agent-skills/using-dbt-for-analytics-engineering)
Updated 4 months ago
[
**/working-with-dbt-mesh**
Use 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 versioning a model (model versions, latest\_version, latest\_version\_pointer, deprecation\_date, migration windows), enforcing contracts, setting access or groups, or doing multi-project dbt Mesh work (cross-project refs via dependencies.yml, disambiguating similarly-named models, splitting a monolith). Covers single- and multi-project, and planning or advising as well as implementing. /working-with-dbt-mesh](https://skilld.dev/gh/dbt-labs/dbt-agent-skills/working-with-dbt-mesh)
Updated 4 months ago
[
**/running-dbt-commands**
Formats 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. /running-dbt-commands](https://skilld.dev/gh/dbt-labs/dbt-agent-skills/running-dbt-commands)
Updated 5 months ago
[
**/adding-dbt-unit-test**
Creates 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. /adding-dbt-unit-test](https://skilld.dev/gh/dbt-labs/dbt-agent-skills/adding-dbt-unit-test)
Updated 5 months ago
[
**/creating-mermaid-dbt-dag**
Generates 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. /creating-mermaid-dbt-dag](https://skilld.dev/gh/dbt-labs/dbt-agent-skills/creating-mermaid-dbt-dag)
Updated 5 months ago
[
**/auditing-skills**
Use when checking skills for security or quality issues, reviewing audit results from skills.sh or Tessl, or remediating findings across published skills. /auditing-skills](https://skilld.dev/gh/dbt-labs/dbt-agent-skills/auditing-skills)
Updated 7 months ago
[
**/configuring-dbt-mcp-server**
Generates 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. /configuring-dbt-mcp-server](https://skilld.dev/gh/dbt-labs/dbt-agent-skills/configuring-dbt-mcp-server)
Updated 7 months ago
[
Writes 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 for validating, testing, or building dbt models during development. /answering-natural-language-questions-with-dbt](https://skilld.dev/gh/dbt-labs/dbt-agent-skills/answering-natural-language-questions-with-dbt)
Updated 7 months ago
[
**/fetching-dbt-docs**
Retrieves 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. /fetching-dbt-docs](https://skilld.dev/gh/dbt-labs/dbt-agent-skills/fetching-dbt-docs)
Updated 7 months ago
## Add to your README
The badge links readers to this page. It shows the skilld mark and no counts, and it follows the reader's light or dark GitHub theme.
``