Agent Skills
› dbt-labs/dbt-agent-skills
dbt-labs/dbt-agent-skills
GitHub用于审计发布技能的安全与质量问题，检查skills.sh或Tessl的审核结果，并针对凭证泄露、供应链风险等发现进行修复。
Install All Skills
npx skills add dbt-labs/dbt-agent-skills --all -g -y
Skills in Collection (19)
用于审计发布技能的安全与质量问题，检查skills.sh或Tessl的审核结果，并针对凭证泄露、供应链风险等发现进行修复。
检查技能安全质量
审查第三方审计报告
修复技能安全漏洞
npx skills add dbt-labs/dbt-agent-skills --skill auditing-skills -g -y
根据 dbt 模型血缘关系生成 Mermaid 流程图，支持通过 MCP 工具、manifest.json 或直接解析代码获取数据，用于可视化依赖和 lineage。
用户请求查看 dbt 模型的血缘或依赖关系
需要以 Mermaid 格式可视化 dbt DAG
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 版本时的编译或构建错误
用户需要分析 dbt 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 或模型发现，专注于数据洞察而非模型开发测试。
询问销售总额、活跃用户数等业务指标
需要按区域展示收入等数据分析请求
npx skills add dbt-labs/dbt-agent-skills --skill answering-natural-language-questions-with-dbt -g -y
指导创建和修改dbt语义层组件，包括语义模型、指标、维度等。根据dbt版本自动路由至最新或遗留YAML规范，提供配置、验证及最佳实践指南。
创建或修改dbt语义模型
定义业务指标或维度
配置MetricFlow
npx skills add dbt-labs/dbt-agent-skills --skill building-dbt-semantic-layer -g -y
指导配置 dbt MCP Server，生成 JSON 配置并验证连接。适用于 Claude Desktop、Cursor 等 AI 工具与 dbt 集成场景。
配置 dbt MCP 服务器
AI 工具连接 dbt
解决认证或连通性问题
npx skills add dbt-labs/dbt-agent-skills --skill configuring-dbt-mcp-server -g -y
获取并搜索 dbt 文档的 LLM 友好型 Markdown 内容，支持通过索引或脚本查找页面及全文检索。
查询 dbt Cloud、dbt Core 或 Semantic Layer 相关文档
检索 dbt 功能特性或解答 dbt 相关问题
npx skills add dbt-labs/dbt-agent-skills --skill fetching-dbt-docs -g -y
审计 dbt 项目文档覆盖率，按文件夹为缺失的模型和列生成符合项目规范描述的草稿。支持回填旧数据和同步新变更，仅输出供人工审查，不自动提交或推送。
审计文档覆盖率
为未记录的模型生成描述草稿
回填缺失的 YAML 描述
保持 schema YAML 与 SQL 同步
npx skills add dbt-labs/dbt-agent-skills --skill maintaining-dbt-documentation -g -y
用于查询 dbt v2 项目元数据，如模型、依赖关系及运行结果。通过 SQL 视图分析项目结构，替代解析 manifest.json，支持高效的数据探查与质量检查。
查询 dbt 项目中的模型、源或测试定义
分析模型间的依赖关系或血缘
检查未测试或未文档化的内容
查看最近一次运行的耗时信息
npx skills add dbt-labs/dbt-agent-skills --skill querying-the-dbt-information-schema -g -y
指导如何格式化并执行dbt CLI命令，包括选择正确的可执行文件、参数结构及最佳实践。涵盖MCP工具优先、使用build替代run、静默模式及选择器策略，支持Core/Fusion/Cloud三种CLI及各类资源筛选。
用户需要运行或构建数据模型
用户询问如何执行dbt测试或查询
不确定应使用哪个dbt可执行文件或命令格式
npx skills add dbt-labs/dbt-agent-skills --skill running-dbt-commands -g -y
用于诊断 dbt Cloud 平台作业失败的根本原因，通过分析运行日志、查询 Admin API、审查 Git 历史及调查数据问题。适用于报错不清或间歇性故障场景，旨在定位基础设施、代码或数据层面的错误根源。
dbt Cloud 作业执行失败
出现难以复现的间歇性故障
错误信息不明确导致无法直接修复
合并后出现的潜在回归问题
npx skills add dbt-labs/dbt-agent-skills --skill troubleshooting-dbt-job-errors -g -y
指导使用 dbt 进行数据分析工程，包括构建和修改模型、编写 SQL 转换、创建测试及验证结果。涵盖新模型开发、现有逻辑修改、项目重构、数据管道创建及仓库数据处理，强调软件工程规范与 DRY 原则。
构建新的 dbt 模型或测试
修改现有模型逻辑或配置
调试 dbt 编译或数据库错误
探索不熟悉的数据源
npx skills add dbt-labs/dbt-agent-skills --skill using-dbt-for-analytics-engineering -g -y
介绍 dbt State 服务器端复用机制，涵盖跳过、克隆和构建逻辑。澄清与 state:modified 及 deferral 的区别，说明跨环境适用性及计费模式。
配置或优化 dbt State
调试 dbt State 导致的意外重建问题
区分 dbt State 与 state:modified 或 --state
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.3-1.7）升级至 1.12 版本。通过读取数据驱动的变更包，自动处理破坏性更改、行为标志配置及自动化修复，支持多种数据仓库适配器，并集成迁移遥测报告功能。
用户请求升级或更新 dbt 项目到最新版本
用户希望迁移 dbt 项目以适配新版本
npx skills add dbt-labs/dbt-agent-skills --skill upgrading-dbt -g -y
用于处理 dbt Mesh 项目中的跨项目引用、模型版本控制及破坏性变更风险评估。指导用户通过 dependencies.yml 理解依赖关系，解决命名歧义，实施模型契约与访问控制，以及规划从单体到多项目的拆分策略。
评估模型变更的破坏性影响
配置跨项目模型引用
管理模型版本与弃用
解析多项目中同名模型的歧义
npx skills add dbt-labs/dbt-agent-skills --skill working-with-dbt-mesh -g -y
