Agent Skills
› dbt-labs/dbt-agent-skills
dbt-labs/dbt-agent-skills
GitHub用于审计发布技能的Security和Quality问题，检查skills.sh等扫描结果并修复漏洞。
Install All Skills
npx skills add dbt-labs/dbt-agent-skills --all -g -y
Skills in Collection (18)
用于审计发布技能的Security和Quality问题，检查skills.sh等扫描结果并修复漏洞。
检查技能安全或质量问题
审查审计结果
修复已发现的问题
npx skills add dbt-labs/dbt-agent-skills --skill auditing-skills -g -y
根据 dbt 模型名称，通过 MCP 工具、manifest.json 或代码解析获取数据血缘关系，生成带颜色编码的 Mermaid 流程图，用于可视化数据依赖。
用户请求查看 dbt 模型的血缘关系或依赖图
需要以 Mermaid 格式输出数据管道结构
npx skills add dbt-labs/dbt-agent-skills --skill creating-mermaid-dbt-dag -g -y
协助用户排查 dbt-core 迁移至 Fusion 时的错误，通过运行 autofix 并对剩余问题进行分类（自动修复、需引导、需输入或阻塞），明确哪些可自修、哪些依赖平台更新。
用户遇到 dbt-core 迁移到 Fusion 的错误
需要区分可手动修复与需平台更新的迁移问题
npx skills add dbt-labs/dbt-agent-skills --skill migrating-dbt-core-to-fusion -g -y
协助用户排查 dbt-core 迁移至 v2 版本的错误。通过运行 autofix、执行调试并分类剩余问题，区分可自动修复、需引导、需输入或阻塞项，明确迁移进度与阻碍。
需要处理 dbt-core 升级到 v2 版本时的报错
希望了解迁移过程中哪些错误可自行修复，哪些存在阻塞
npx skills add dbt-labs/dbt-agent-skills --skill migrating-dbt-core-to-v2 -g -y
指导将 dbt 项目从一种数据平台迁移到另一种（如 Snowflake 到 Databricks），利用 dbt Fusion 实时编译识别并修复 SQL 方言差异，通过单元测试和运行验证确保迁移正确性。
迁移 dbt 项目至不同数据仓库
解决跨平台 SQL 方言不兼容问题
npx skills add dbt-labs/dbt-agent-skills --skill migrating-dbt-project-across-platforms -g -y
用于为 dbt 模型创建单元测试 YAML，通过模拟上游输入并验证预期输出来确保 SQL 转换逻辑的正确性。适用于 TDD、回归测试及复杂逻辑验证场景。
需要为 dbt 模型添加单元测试
使用 dbt 进行测试驱动开发
验证 SQL 转换逻辑或修复数据管道 Bug
npx skills add dbt-labs/dbt-agent-skills --skill adding-dbt-unit-test -g -y
通过dbt语义层或SQL查询数据仓库，回答关于指标、KPI和业务数据的自然语言问题。优先使用语义层工具，依次降级至修改编译SQL、模型发现及清单分析，旨在高效获取业务洞察。
用户询问销售总额、活跃客户数等业务指标
需要基于数据仓库进行数据分析或KPI查询
npx skills add dbt-labs/dbt-agent-skills --skill answering-natural-language-questions-with-dbt -g -y
指导创建和修改 dbt 语义层组件，包括语义模型、指标、维度等。涵盖 MetricFlow 配置及新旧 YAML 规范的适配与验证流程。
创建或修改 dbt 语义层配置
定义业务指标或度量
配置语义模型实体与维度
npx skills add dbt-labs/dbt-agent-skills --skill building-dbt-semantic-layer -g -y
指导配置 dbt MCP Server，支持本地或远程模式，适配 Claude Desktop、Cursor 等 AI 客户端。涵盖认证设置、连通性验证及工具启用，解决开发与消费场景下的连接问题。
配置 dbt MCP 服务器
设置 AI 工具与 dbt 的连接
解决 dbt MCP 连通性问题
npx skills add dbt-labs/dbt-agent-skills --skill configuring-dbt-mcp-server -g -y
获取并搜索 dbt 文档，支持通过 llms.txt 索引或本地脚本查找页面，以 Markdown 格式检索 dbt Cloud/Core/Semantic Layer 相关信息。
查询 dbt 官方文档内容
查找 dbt 功能或配置说明
解决 dbt 相关技术问题
npx skills add dbt-labs/dbt-agent-skills --skill fetching-dbt-docs -g -y
审计 dbt 项目文档覆盖率，按文件夹为未记录模型生成符合项目规范的 YAML 描述草稿，供人工审核。用于填补文档空白或保持模型与 schema 同步，不自动提交。
审计 dbt 文档覆盖率
为未记录的模型生成描述
回填缺失的 YAML 描述
保持 schema YAML 与模型 SQL 同步
npx skills add dbt-labs/dbt-agent-skills --skill maintaining-dbt-documentation -g -y
提供 dbt CLI 命令格式化与执行指导，涵盖 Core/Fusion/Cloud 多版本适配、参数配置及选择器用法。辅助开发人员进行数据模型构建、测试及查询操作，确保命令规范与安全。
用户询问如何运行 dbt 模型或测试
需要格式化 dbt 命令行参数
不确定使用哪个 dbt 可执行文件
执行 dbt build, run, show 等操作
npx skills add dbt-labs/dbt-agent-skills --skill running-dbt-commands -g -y
诊断 dbt Cloud/平台作业失败的根本原因，通过分析运行日志、查询 Admin API、审查 Git 历史及调查数据问题。适用于错误信息不明确或间歇性故障场景，旨在定位基础设施、代码或数据层面的缺陷。
dbt 作业运行失败
间歇性难以复现的故障
错误信息模糊不清
合并后出现的回归问题
npx skills add dbt-labs/dbt-agent-skills --skill troubleshooting-dbt-job-errors -g -y
用于数据分析工程，涵盖构建和修改dbt模型、编写SQL转换、创建数据测试及验证结果。指导如何应用软件工程原则处理数据转换工作，包括模型规划、错误调试、影响评估及文档编写。
构建新的dbt模型或数据源
修改现有模型逻辑或配置
调试dbt编译或数据库错误
为数据仓库数据编写转换SQL
npx skills add dbt-labs/dbt-agent-skills --skill using-dbt-for-analytics-engineering -g -y
介绍 dbt State 服务器端复用机制，澄清与 state:modified 的混淆，详解 Skip/Clone/Build 决策逻辑及跨环境支持。
配置或优化 dbt State
调试模型意外重建
区分 dbt State 与 state:modified
npx skills add dbt-labs/dbt-agent-skills --skill using-dbt-state -g -y
自动将 dbt-core v1 项目升级至 1.12，处理版本间的破坏性变更及行为标志配置。
升级 dbt 项目
迁移 dbt 版本
更新 dbt-core
npx skills add dbt-labs/dbt-agent-skills --skill upgrading-dbt-core -g -y
将 dbt v1 项目从旧版本迁移至 1.12，依据数据驱动的问题集处理破坏性变更、行为标志及自动化修复。
升级 dbt 项目到最新版本
迁移 dbt 项目以适配新版
npx skills add dbt-labs/dbt-agent-skills --skill upgrading-dbt -g -y
处理 dbt Mesh 中跨项目引用、模型版本控制及潜在破坏性变更的影响评估。涵盖 dependencies.yml 配置、歧义解析、合约设置及单体拆分，确保数据依赖安全。
修改可能影响下游消费者的 dbt 模型（重命名、删除或更改列类型）
进行跨项目模型引用或解决同名模型歧义
配置多项目依赖或实施模型版本控制
npx skills add dbt-labs/dbt-agent-skills --skill working-with-dbt-mesh -g -y
