1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | duckdb-skills |
| 作者/维护者 | DuckDB 官方团队（GitHub 组织 duckdb；核心贡献者 carlopi、guillesd 为 DuckDB 核心开发者，GitHub API 实测） |
| 来源链接 | https://github.com/duckdb/duckdb-skills |
| 许可证 | MIT（GitHub API 实测） |
| GitHub Stars | 516（GitHub API 实测，2026-07-17） |
| Forks | 25（GitHub API 实测） |
| 最新版本 | 0.2.4（插件 manifest 声明；仓库未打 Git Release/Tag，采用滚动发布） |
| 安装方式 | Claude Code 插件市场，一条命令安装 |
2. 功能介绍与亮点
duckdb-skills 是 DuckDB 官方发布的 Claude Code 插件，包含 6 个协同工作的子技能：
- attach-db：挂载 DuckDB 数据库文件，自动探索表结构并写入会话状态文件
- query：对已挂载数据库或任意文件执行 SQL，支持自然语言转 SQL（DuckDB Friendly SQL 方言）
- read-file：读取 CSV / JSON / Parquet / Avro / Excel / SQLite / Jupyter Notebook 等格式，支持本地与 S3/GCS/HTTPS 远程文件，按扩展名自动识别
- duckdb-docs：全文检索 DuckDB 官方文档与博客，排障时自动调用
- read-memories：检索历史 Claude Code 会话日志，找回过往决策与待办
- install-duckdb：安装/更新 DuckDB 扩展
亮点：① 官方 DuckDB 团队出品并持续维护；② 查询执行内置沙箱——ad-hoc 模式下设置 allowed_paths、enable_external_access=false 等限制，先估算结果行数再执行大查询，避免意外消耗；③ 六个技能共享同一 state.sql 会话状态，协同顺畅；④ 完全免费、无需注册账号或 API Key。
3. 适用场景
固定分类：数据分析与可视化
适合本地数据探索场景：临时分析一份 CSV/Parquet 文件、无需搭建数据库或云账号即可用自然语言/SQL 查询数据、排查数据质量问题。受益人群为初中级开发者、数据分析新手，以及需要在编码过程中顺手查一眼本地文件的工程师。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——专为 Claude Code 插件市场设计，含
.claude-plugin清单与/duckdb-skills:*slash command - Codex：❓ 未验证——各技能采用通用 SKILL.md 格式，但 README 与插件清单只描述了 Claude Code 的安装路径，未提及 Codex 适配
- OpenClaw：❓ 未验证——公开材料中未提及
- Hermes Agent：❓ 未验证——公开材料中未提及
5. 推荐理由
DuckDB 官方团队维护，一条命令即可让 Claude 具备本地任意数据文件的查询能力；查询沙箱设计成熟、完全免费，尤其适合初中级用户快速上手本地数据分析。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | GitHub 516 stars、25 forks（GitHub API 实测，2026-07-17）；DuckDB 官方团队出品（GitHub 组织账号 duckdb，核心贡献者 carlopi、guillesd 为可验证的 DuckDB 核心开发者），仓库 2026-03-10 创建，上线约 4 个月；社区层面暂未发现已验证的独立第三方讨论来源 |
| 可用性 | 9 | Claude Code 插件市场一条命令安装（/plugin marketplace add + /plugin install），安装后无需重启当前会话即可用；最近提交 2026-04-23，距今约 3 个月，维护活跃；完全免费、无需注册账号或 API Key；因未上架官方插件市场 Discover 标签（需手动通过 GitHub 添加）且 Windows 支持尚不完整，未给满分 |
| 安全性 | 9 | 见下方安全检查清单 |
| 综合 | 8.7 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行范围 | 仅本地调用 duckdb CLI；ad-hoc 模式显式限制 allowed_paths、禁止外部网络访问 |
| ② 运行时联网外发数据 | duckdb-docs 会请求 DuckDB 官方文档搜索索引（用途透明）；read-file 可读取用户显式指定的远程 URL，属预期功能而非隐蔽外发 |
| ③ API Key/凭据 | 核心功能无需任何凭据；云存储访问凭据交由 DuckDB 自身的 secret 机制管理 |
| ④ 可疑指令 | 逐一审阅 query、install-duckdb 等技能的 SKILL.md 及脚本，未发现 prompt injection 或异常指令 |
| ⑤ 作者/组织信誉 | 官方 DuckDB 组织账号，核心贡献者为可验证的 DuckDB 团队成员 |
| ⑥ License | MIT，明确 |
| ⑦ 最近维护时间 | 最近提交 2026-04-23，距今约 3 个月，活跃维护 |
7. 跟同类 Skills 相比的优势
同为“数据分析与可视化”类目的其他官方出品技能与本技能的定位差异：
| 名称 | 出品方 | 是否免费 | 安装复杂度 | 代表能力 |
|---|---|---|---|---|
| duckdb-skills（本推荐） | DuckDB 官方 | 完全免费 | 一条命令 | 本地任意文件秒查，无需账号 |
| databricks-agent-skills | Databricks 官方 | 需付费工作区 | 需装 CLI + 选认证 Profile | 企业级 Lakehouse 全家桶（28 个子技能） |
| astronomer/agents（Airflow） | Astronomer 官方 | 可自建免费/云端付费 | 需已有 Airflow 环境 | 编写与调试 Airflow DAG |
| metabase/agent-skills | Metabase 官方 | 免费 | 未深入验证 | BI 看板与数据模型探索 |
| motherduckdb/agent-skills | MotherDuck 官方 | 需 MotherDuck 云账号 | 未深入验证 | 云端 DuckDB 分析 |
核心差异化：同类官方技能大多要求先具备企业级平台账号（Databricks 工作区、Airflow 部署、MotherDuck 云服务），门槛明显更高；duckdb-skills 是其中唯一“零账号、零服务端、装完即用”的选择，与初中级用户的实际起点最匹配。
8. 用户评价
该插件目前在第三方平台尚无具名的独立用户评价：DuckDB 官方账号在发布时曾对外公告，但该链接需登录才能查看，无法作为公开可验证来源；公开渠道也未见独立的第三方评测文章。可参考的客观数据见第一章的 stars/forks 与维护记录。
9. 其他补充
该插件尚未上架 Anthropic 官方插件市场 Discover 标签（README 注明“submitting to the official marketplace”，目前需通过 GitHub 手动添加）；仓库未使用正式版本 Release/Tag，版本号仅见于插件 manifest（当前 0.2.4），更新前建议关注提交记录。
10. 安装使用方式
/plugin marketplace add duckdb/duckdb-skills
/plugin install duckdb-skills@duckdb-skills安装后无需重启，当前会话即可使用 /duckdb-skills:query、/duckdb-skills:read-file、/duckdb-skills:attach-db 等 slash command；本机需预装 DuckDB CLI，若未安装，技能会引导执行 brew install duckdb（macOS）、curl -fsSL https://install.duckdb.org | sh（Linux）或 winget install DuckDB.cli（Windows）。
11. 注意事项
- 仅在 macOS 与 Linux 上测试通过，Windows 支持尚不完整，部分 shell 命令与路径处理可能失效
- 未上架官方插件市场 Discover 标签，目前只能通过 GitHub 手动添加
- 采用滚动发布，无正式版本 Release/Tag，无法通过 Tag 追踪变更历史
- 除 Claude Code 外，与 Codex / OpenClaw / Hermes Agent 的兼容性均未经验证