dbt-labs / dbt-agent-skills
★ 605A skill package that teaches your agent 14 capabilities — every one documented and browsable below, no GitHub required · by dbt-labs.
Each skill below is one capability this package teaches your agent. Install the whole package, or open a skill to install just that one.
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…
15 files — installable on its own
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…
1 file — installable on its own
Use when checking skills for security or quality issues, reviewing audit results from skills.sh or Tessl, or remediating findings across published skills.
1 file — installable on its own
Use when creating or modifying dbt Semantic Layer components — semantic models, metrics, dimensions, entities, measures, or time spines. Covers MetricFlow…
6 files — installable on its own
configuring-dbt-mcp-server — an installable skill for AI agents, published by dbt-labs/dbt-agent-skills.
5 files — installable on its own
Generates MCP server configuration JSON, resolves authentication setup, and validates server connectivity for dbt. Use when setting up, configuring, or…
5 files — installable on its own
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…
6 files — installable on its own
Retrieves and searches dbt documentation pages in LLM-friendly markdown format. Use when fetching dbt documentation, looking up dbt features, or answering…
3 files — installable on its own
Use when a user needs help triaging dbt-core to Fusion migration errors. Runs dbt-autofix first, then classifies remaining errors into actionable categories…
5 files — installable on its own
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…
5 files — installable on its own
Formats and executes dbt CLI commands, selects the correct dbt executable, and structures command parameters. Use when running models, tests, builds, compiles,…
1 file — installable on its own
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…
3 files — installable on its own
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…
11 files — installable on its own
Implements dbt Mesh governance features (model contracts, access modifiers, groups, versioning) and multi-project collaboration with cross-project refs. Use…
6 files — installable on its own
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.
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-marketplaceOther 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 updateTessl
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-skillsBrowse 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 |
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.
Install the whole package (14 skills):
npx skills add https://github.com/dbt-labs/dbt-agent-skillsOr install a single skill:
npx skills add https://github.com/dbt-labs/dbt-agent-skills --skill <name>Pick the skill name from the Skills tab — each entry there installs independently.