Skip to content
Back to search

dbt-agent-marketplace

MarketplaceWorks with Claude CodeGitHub

Skills for working with dbt Core and the dbt Fusion engine - analytics engineering, data modeling, semantic layer, and dbt platform (fka dbt Cloud) operations

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dbt-labs-dbt-agent-skills/badge.svg)](/listings/dbt-labs-dbt-agent-skills)

HTML

<a href="/listings/dbt-labs-dbt-agent-skills"><img src="/api/listings/dbt-labs-dbt-agent-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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](https://github.com/vercel-labs/skills) 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](https://tessl.io/), 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](https://tessl.io/registry/dbt-labs/dbt-agent-skills).

Compatible Agents

These skills work with AI agents that support the [Agent Skills](https://agentskills.io/home) format.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 26 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "dbt-agent-marketplace",
  4. "description": "Skills for working with dbt Core and the dbt Fusion engine - analytics engineering, data modeling, semantic layer, and dbt platform (fka dbt Cloud) operations",
  5. "owner": {
  6. "name": "dbt Labs",
  7. "email": "support@getdbt.com"
  8. },
  9. "plugins": [
  10. {
  11. "name": "dbt",
  12. "description": "Skills for analytics engineering with dbt — building models, writing tests, querying the semantic layer, troubleshooting jobs, and more.",
  13. "source": "./skills/dbt"
  14. },
  15. {
  16. "name": "dbt-migration",
  17. "description": "Skills for migrating dbt projects — moving from dbt Core to the Fusion engine or across data platforms.",
  18. "source": "./skills/dbt-migration"
  19. },
  20. {
  21. "name": "dbt-extras",
  22. "description": "Miscellaneous skills for dbt.",
  23. "source": "./skills/dbt-extras"
  24. }
  25. ]
  26. }
README.md · README · 205 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # dbt Agent Skills
  2. A curated collection of [Agent Skills](https://agentskills.io/home) for working with dbt. These skills help AI agents understand and execute dbt workflows more effectively.
  3. ## What are Agent Skills?
  4. Agent Skills are folders of instructions, scripts, and resources that agents can discover and use to do things more accurately and efficiently.
  5. ## How They Work
  6. 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](https://code.claude.com/docs/en/skills#control-who-invokes-a-skill) for more details.
  7. ## What's Included
  8. - **Analytics engineering**: Build and modify dbt models, write tests, explore data sources
  9. - **Semantic layer**: Create metrics, dimensions, and semantic models with MetricFlow
  10. - **dbt Mesh**: Work with multi-project setups, cross-project refs, model governance (contracts, versions, access)
  11. - **Platform operations**: Troubleshoot job failures, configure the dbt MCP server
  12. - **Migration**: Move projects from dbt Core to dbt v2
  13. ## Installation
  14. ### Claude Code
  15. Add the dbt skills marketplace and install the plugins:
  16. ```bash
  17. # Add the marketplace
  18. /plugin marketplace add dbt-labs/dbt-agent-skills
  19. # Install the dbt skills (analytics engineering, semantic layer, testing, etc.)
  20. /plugin install dbt@dbt-agent-marketplace
  21. # Install the migration skills (typically a one-off — not needed for every session)
  22. /plugin install dbt-migration@dbt-agent-marketplace
  23. ```
  24. ### Other AI Clients
  25. #### Vercel Skills CLI
  26. Use the [Vercel Skills CLI](https://github.com/vercel-labs/skills) to install skills from this repository. Supports 30+ AI agents including Cursor, Cline, GitHub Copilot, and others.
  27. ```bash
  28. # Preview available skills
  29. npx skills add dbt-labs/dbt-agent-skills --list
  30. # Install all skills
  31. npx skills add dbt-labs/dbt-agent-skills
  32. # Install only the dbt skills (analytics engineering, semantic layer, etc.)
  33. npx skills add dbt-labs/dbt-agent-skills/skills/dbt
  34. # Install only the migration skills
  35. npx skills add dbt-labs/dbt-agent-skills/skills/dbt-migration
  36. # Install a specific skill
  37. npx skills add dbt-labs/dbt-agent-skills --skill using-dbt-for-analytics-engineering
  38. # Install globally (available in all projects, stored in ~/.<agent>/skills/)
  39. npx skills add dbt-labs/dbt-agent-skills --global
  40. # Check for updates
  41. npx skills check
  42. # Update installed skills
  43. npx skills update
  44. ```
  45. #### Tessl
  46. Install skills using [Tessl](https://tessl.io/), a package manager for agent skills:
  47. ```bash
  48. # Install all skills
  49. tessl install dbt-labs/dbt-agent-skills
  50. # Install a specific skill
  51. tessl install dbt-labs/dbt-agent-skills --skill using-dbt-for-analytics-engineering
  52. # Install from GitHub directly
  53. tessl install github:dbt-labs/dbt-agent-skills
  54. ```
  55. Browse the tile on the [Tessl registry](https://tessl.io/registry/dbt-labs/dbt-agent-skills).
  56. #### dbt packages (`dbt deps`)
  57. Install skills as dbt package dependencies. This repository publishes three independent packages, so you can install any combination:
  58. | Package | Subdirectory | Contents |
  59. |---------|--------------|----------|
  60. | `dbt_agent_skills` | `skills/dbt` | Everyday dbt development skills |
  61. | `dbt_migration_skills` | `skills/dbt-migration` | One-off migration and upgrade skills |
  62. | `dbt_extras_skills` | `skills/dbt-extras` | Extra skills, such as Mermaid DAG diagrams |
  63. Add any of them to your project's `packages.yml`:
  64. ```yaml
  65. packages:
  66. # Everyday dbt skills
  67. - git: "https://github.com/dbt-labs/dbt-agent-skills.git"
  68. subdirectory: "skills/dbt"
  69. revision: main
  70. # Migration skills (typically a one-off)
  71. - git: "https://github.com/dbt-labs/dbt-agent-skills.git"
  72. subdirectory: "skills/dbt-migration"
  73. revision: main
  74. # Extra skills
  75. - git: "https://github.com/dbt-labs/dbt-agent-skills.git"
  76. subdirectory: "skills/dbt-extras"
  77. revision: main
  78. ```
  79. Then opt in by setting `ai_provider` in your own project's `dbt_project.yml` (it is ignored if set inside a package). Without it, `dbt deps` succeeds but installs no skills:
  80. ```yaml
  81. flags:
  82. ai_provider: claude # Claude Code -> .claude/skills
  83. ```
  84. Supported values include `claude`, `codex`, `cursor`, `gemini`, `openai`, and `wizard` (dbt Wizard CLI). Everything except `claude` installs to `.agents/skills`. To target several, use a list (`ai_provider: [wizard, claude]`), or pass `--ai-provider claude,codex` on the command line.
  85. ```bash
  86. dbt deps
  87. ```
  88. > [!TIP]
  89. > `revision: main` tracks the latest changes. For reproducible installs, pin `revision` to a Git tag or commit SHA instead.
  90. See the [dbt documentation on package skills](https://docs.getdbt.com/docs/dbt-ai/package-skills) for the full configuration reference, including how to disable individual skills.
  91. ### Compatible Agents
  92. These skills work with AI agents that support the [Agent Skills](https://agentskills.io/home) format.
  93. ## Available Skills
  94. ### dbt (analytics engineering)
  95. | Skill | Description |
  96. |-------|-------------|
  97. | `using-dbt-for-analytics-engineering` | Build and modify dbt models, debug errors, explore data sources, write tests |
  98. | `adding-dbt-unit-test` | Add unit tests for dbt models, practice test-driven development |
  99. | `maintaining-dbt-documentation` | Audit model/column doc coverage and draft missing descriptions in the project's own style |
  100. | `building-dbt-semantic-layer` | Create semantic models, metrics, and dimensions with MetricFlow |
  101. | `answering-natural-language-questions-with-dbt` | Answer business questions by querying the semantic layer |
  102. | `working-with-dbt-mesh` | Implement dbt Mesh governance (contracts, access, groups, versions) and cross-project collaboration |
  103. | `troubleshooting-dbt-job-errors` | Diagnose and resolve dbt platform job failures |
  104. | `configuring-dbt-mcp-server` | Set up the dbt MCP server for Claude, Cursor, or VS Code |
  105. | `fetching-dbt-docs` | Look up dbt documentation efficiently |
  106. | `running-dbt-commands` | Run dbt CLI commands with correct flags, selectors, and parameter formats |
  107. | `querying-the-dbt-information-schema` | Answer questions about project metadata (models, tests, columns, lineage) with SQL on dbt v2 |
  108. ### dbt-migration (one-off use)
  109. These skills are typically used once during a migration project rather than in every agent session.
  110. | Skill | Description |
  111. |-------|-------------|
  112. | `migrating-dbt-core-to-v2` | Migrate dbt projects from dbt Core to dbt v2 |
  113. | `migrating-dbt-project-across-platforms` | Migrate dbt projects across data platforms |
  114. | `upgrading-dbt` | Upgrade a dbt-core v1 project (1.3-1.7) to the latest dbt, applying breaking, behavior, and deprecated changes |
  115. ## Prerequisites
  116. Most skills assume:
  117. - dbt is installed and configured
  118. - A dbt project with `dbt_project.yml` exists
  119. - Basic familiarity with dbt concepts (models, tests, sources)
  120. Some skills like `fetching-dbt-docs` and `configuring-dbt-mcp-server` can be used without an existing project.
  121. ## Contributing
  122. We welcome contributions! Whether you want to add a new dbt skill, improve existing ones, or fix issues, please see our [Contributing Guide](CONTRIBUTING.md).
  123. ## Format Specification
  124. All skills in this repository follow the [Agent Skills specification](https://agentskills.io/specification) to ensure compatibility across different agent products.
  125. ## Resources
  126. - [dbt Documentation](https://docs.getdbt.com/)
  127. - [dbt CLI Reference](https://docs.getdbt.com/reference/dbt-commands)
  128. - [Agent Skills Documentation](https://agentskills.io/home)
  129. - [Agent Skills Specification](https://agentskills.io/specification)
  130. ## Community
  131. - **Issues**: Report problems or suggest new skills
  132. - **Discussions**: Share use cases and patterns
  133. - **Pull Requests**: Contribute new skills or improvements
  134. - **Star** this repository if you find it useful!
  135. ## License
  136. See [LICENSE](LICENSE) for details.
  137. ## Skill Evaluation
  138. See [evals/README.md](evals/README.md) for the A/B testing tool to compare skill variations.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.