CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

65

Quality

82%

Does it follow best practices?

Impact

—

No eval scenarios have been run

SecuritybySnyk

Risky

Do not use without reviewing

Overview
Quality
Evals
Security
Files

README.md

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
  • 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 skills:

/plugin marketplace add dbt-labs/dbt-agent-skills
/plugin install dbt@dbt-agent-marketplace

Other AI Clients

Use the Vercel Skills CLI to install skills from this repository.

# Preview available skills
npx skills add dbt-labs/dbt-agent-skills --list

# Install all skills
npx skills add dbt-labs/dbt-agent-skills

# 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

The Vercel Skills CLI supports 30+ AI agents including Cursor, Cline, GitHub Copilot, and others.

Compatible Agents

These skills work with AI agents that support the Agent Skills format.

Available Skills

SkillDescription
using-dbt-for-analytics-engineeringBuild and modify dbt models, debug errors, explore data sources, write tests
adding-dbt-unit-testAdd unit tests for dbt models, practice test-driven development
building-dbt-semantic-layerCreate semantic models, metrics, and dimensions with MetricFlow
answering-natural-language-questions-with-dbtAnswer business questions by querying the semantic layer
troubleshooting-dbt-job-errorsDiagnose and resolve dbt platform job failures
configuring-dbt-mcp-serverSet up the dbt MCP server for Claude, Cursor, or VS Code
fetching-dbt-docsLook up dbt documentation efficiently
migrating-dbt-core-to-fusionMigrate dbt projects to the Fusion engine
running-dbt-commandsRun dbt CLI commands with correct flags, selectors, and parameter formats

Prerequisites

Most skills assume:

  • dbt is installed and configured
  • A dbt project with dbt_project.yml exists
  • 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.

CONTRIBUTING.md

README.md

tile.json