1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | motherduckdb-motherduckdb-agent-skills | — |
| 作者/维护者 | MotherDuck Corporation（官方组织账号） | GitHub API |
| 来源链接 | https://github.com/motherduckdb/agent-skills | — |
| 许可证 | MIT | GitHub 仓库 LICENSE 文件 |
| GitHub Stars/Forks | 53★ / 3 forks | GitHub API，2026-08-04 |
| 最新版本 | v2.5.0（发布于 2026-07-31） | GitHub Releases API |
| 安装方式 | 按目标 agent 选择插件市场命令或通用 Skills CLI，见第 10 章 | 官方 README |
2. 功能介绍与亮点
motherduckdb-motherduckdb-agent-skills 是 MotherDuck（DuckDB 官方托管云服务）发布的完整 agent 技能包，把“怎么正确地在 MotherDuck 上做事”这件事从零散的团队文档变成可安装的结构化指南：
- 技能而非工具的定位：官方博客明确区分——MCP 给 agent“手”（能执行查询、读取 schema 的工具），技能给 agent“作业手册”（何时用、怎么用这些工具），把连接方式选择、SQL 方言偏好、命名约定这类通常只存在于团队记忆里的隐性知识固化下来
- 三层技能架构：utility 层（连接、探查、查询、DuckDB SQL 语法、REST API）→ workflow 层（数据加载、建模、共享、Dive 仪表盘、DuckLake、安全治理、成本）→ use-case 层（客户可见分析应用、仪表盘、数据管道、迁移、自助分析上线）逐层编排，20 个技能按依赖关系互相调用
- 懒加载设计：agent 启动时只看到技能名称与一句话描述，只有任务命中时才加载完整指令内容，避免占满上下文窗口
- 五种 agent 环境的一条命令安装：Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot CLI 各有专属安装命令，其余 agent 可用通用 Skills CLI 一次装全套
- 安全意识内置：明确写明“不要把 token 粘贴进 prompt 或技能文件”，优先使用后端可控的密钥与环境变量、服务账号而非个人 token
亮点：官方组织账号发布并配发布博客，v2.5.0 发布于 2026-07-31，仍在持续新增技能。
3. 适用场景
所属分类：数据分析与可视化
面向用 AI 编码 agent 在 MotherDuck 上做数据分析与应用开发的用户：数据分析师需要正确的连接方式与 DuckDB SQL 写法参考；数据工程师搭建从数据加载到建模的端到端管道；产品/工程团队用 Dive 快速搭建可分享的仪表盘或客户可见分析功能；从 Snowflake、Redshift、Postgres 或 dbt 重度依赖的技术栈评估迁移到 MotherDuck 的团队，可以按用例层技能直接获得迁移规划指导。
4. 跨 Agent 兼容性
- Claude Code：原生支持——
/plugin marketplace add motherduckdb/agent-skills后/plugin install motherduck-skills@motherduck-skills - Codex：原生支持——
codex plugin marketplace add motherduckdb/agent-skills后从/plugins安装 - OpenClaw：未验证——已抓取材料中未提及，仓库遵循标准 SKILL.md 格式并提供通用
npx skills add安装路径 - Hermes Agent：未验证——已抓取材料中未提及
5. 推荐理由
把 MotherDuck 连接路径选择、DuckDB SQL 方言规范、Dive 仪表盘搭建、数据迁移规划这些原本要靠试错或团队文档积累的经验，固化成官方维护、按依赖关系分层编排的 20 个 agent 技能，覆盖从入门连接到生产级数据管道与迁移的完整场景。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 官方组织账号发布并配发布博客，53★，作为体量适中的官方厂商发布未见刷星迹象；未发现独立于官方渠道的第三方讨论 |
| 可用性 | 9 | 覆盖 5 种 agent 环境的一条命令安装 + 通用 CLI 兜底，README 含验证步骤、故障排查、维护者自检清单；v2.5.0 发布于 2026-07-31，维护活跃；无付费依赖之外的额外安装成本 |
| 安全性 | 9 | 逐份核查安装单元内容，纯 Markdown 指导 + 少量示例脚本，明确要求密钥走环境变量/服务账号、禁止把 token 粘贴进 prompt 或技能文件；MIT 许可证明确；未发现可疑指令或混淆代码 |
| 综合 | 8.3 | 三项均值 |
安全检查清单：①按任务需要执行 SQL/脚本，范围与用途在文档中逐一说明 ②仅在用户要求连接 MotherDuck 时联网，目标透明 ③要求 MotherDuck 账号 token，文档明确要求经环境变量/服务账号管理、不得写入 prompt 或文件 ④未发现可疑指令或隐蔽外发 ⑤MotherDuck Corporation 官方账号发布，无造假迹象 ⑥License 明确（MIT） ⑦最近一次发布 2026-07-31，持续维护中
7. 跟同类 Skills 相比的优势
| Skill | 定位 | 与本技能的差异 |
|---|---|---|
| duckdb-skills | DuckDB 官方技能，面向本地/开源 DuckDB 本身的语法与使用指南 | 不覆盖 MotherDuck 云端专属能力（托管连接鉴权、Dive 仪表盘、跨账号数据共享、迁移路径规划等），两者可配合使用：本地开发用 duckdb-skills，上云后切换到本技能 |
| Snowflake-Labs/ai-ready-data | Snowflake 官方“AI 就绪数据”框架，产出物是数据集结构/元数据的评估检查项 | 关注点是“数据本身是否适合被 AI 消费”，而非“agent 该如何在平台上完成具体任务”；本技能是按任务场景组织的操作指南而非数据评估框架 |
| ClickHouse/agent-skills | ClickHouse 官方技能集合，同样按功能拆成多个独立子技能 | 子技能之间相对独立、各自聚焦查询优化与基础设施运维等单点场景；本技能采用“utility→workflow→use-case”三层显式依赖编排，上层用例技能会主动调用下层技能组合完成端到端任务 |
8. 用户评价
MotherDuck 官方博客文章《From MCP to Agent Skills: Teaching Your AI Agents to Actually Do Analytics》说明了发布背景与设计理念，但除官方渠道外，该技能目前尚无第三方平台的具名用户评价。
9. 其他补充
- 每个技能目录下配有
references/（更长的实施指南）与artifacts/（Python 与 TypeScript 双语言可运行示例代码） - 提供机器可读的
skills/catalog.json索引，记录每个技能的依赖关系与官方文档来源链接，便于二次开发或审计
10. 安装使用方式
Claude Code
/plugin marketplace add motherduckdb/agent-skills
/plugin install motherduck-skills@motherduck-skillsCodex
codex plugin marketplace add motherduckdb/agent-skills安装后从 /plugins 选择 MotherDuck Skills 完成安装。
通用路径（其他 agent）
npx -y skills add motherduckdb/agent-skills --skill '*' --yes --global安装完成后无需重启即可通过在对话中提及“MotherDuck”触发技能路由；如需实时探查工作区（如列出真实数据库/表），需额外配置 MOTHERDUCK_TOKEN 或已连接的 MotherDuck MCP，安装本身不要求任何付费配置。
11. 注意事项
- 20 个技能之间存在显式依赖关系（如“搭建仪表盘”依赖“连接”“查询”“创建 Dive”等基础技能），单独复制某一个上层技能而不带其依赖项可能导致指导不完整，建议整体安装
- 实时工作区探查功能依赖用户已具备 MotherDuck 账号与有效 token 或已配置 MotherDuck MCP，技能本身不提供账号或连接能力
- OpenClaw、Hermes Agent 官方未点名支持，安装前建议自行验证 SKILL.md 格式在对应 agent 中的加载行为