KKGABC

DuckDB Skills

4 条已验证来源

DuckDB 官方出品的 Claude Code 插件:把 DuckDB 分析能力封装成可复用技能,让 AI 直接读文件、跑 SQL、查文档并记住会话上下文

工具简介

它是什么

duckdb-skills 是 DuckDB 官方仓库(duckdb/duckdb-skills)维护的 Claude Code 插件,用一组 DuckDB 驱动的技能,让 AI 编程助手具备本地数据探查与会话记忆能力。底层引擎是 DuckDB——一款 MIT 许可的进程内分析型数据库,因此所有数据处理都在本机完成,数据无需上传云端。项目以 MIT 许可开源,版权归 Stichting DuckDB Foundation。

包含 9 个技能

  • attach-db:附加 DuckDB 数据库文件,自动探查表结构、列与行数,并写入会话状态文件。
  • query:对已附加数据库或任意文件执行 SQL,支持原生 SQL 或自然语言提问,兼容 DuckDB 的 Friendly SQL 方言。
  • read-file:读取并剖析 CSV、JSON、Parquet、Avro、Excel、空间数据、SQLite、Jupyter 等文件,支持本地及 S3/GCS/Azure/HTTPS 远程存储,按扩展名自动识别格式。
  • duckdb-docs:对 DuckDB 与 DuckLake 文档、博客做全文检索,默认走 HTTPS 托管索引,也可本地缓存离线搜索。
  • read-memories:检索过往 Claude Code 会话日志,找回历史决策、约定与未完成待办。
  • install-duckdb:安装或更新 DuckDB 扩展,支持 name@repo 社区扩展语法与 --update 检查 CLI 版本。
  • convert-file:在 CSV/Parquet/JSON/Excel/GeoJSON 等格式间互转,可产出 Agent 无法原生写入的二进制文件。
  • spatial:用 DuckDB 处理坐标、距离、包含关系与空间连接,结合 Overture Maps 的 S3 免费数据,无需 API Key。
  • s3-explore:列举并查询 S3/R2/GCS/MinIO 等对象存储上的数据,无需先下载。

核心设计:共享会话状态

所有技能共用每个项目一份 state.sql 文件(存放 ATTACH/USE/LOAD 语句、密钥与宏),追加写入且幂等;任意技能都能用 duckdb -init state.sql 恢复会话。正因如此,attach-db 探明的表结构能直接交给 query,read-file 配置的密钥能被其他技能复用,无需重复交代上下文。

安装与使用

当前通过 GitHub 作为插件市场安装:/plugin marketplace add duckdb/duckdb-skills,再 /plugin install duckdb-skills@duckdb-skills;之后技能以 /duckdb-skills:<技能名> 形式调用。官方称正在提交 Anthropic 插件市场,未来可在 /plugin 的 Discover 标签安装。前置条件是本机装有 DuckDB CLI,缺失时技能会引导通过 install-duckdb 安装。

平台与定位

已在 macOS 与 Linux 上测试通过,Windows 尚未完全支持。它不是 MCP Server,而是 Claude Code 的 Agent Skills 技能包;若使用其他 Agent,可 clone 仓库后指向 skills/*/SKILL.md 复用。适合需要让编码 Agent 直接分析本地大文件、做即席 SQL 探查、跨会话延续数据上下文的场景。

本页内容来自 KGABC 结构化知识库。带「未验证」标记的字段表示官方资料未明确说明,不等同于「不支持」。

核心功能

  • 9 个可复用数据技能:附加数据库、SQL/自然语言查询、文件剖析、文档检索、会话记忆、扩展安装、格式转换、空间分析、对象存储探查
  • 共享会话状态:每项目一份 state.sql,追加写入且幂等,跨技能自动复用表结构、密钥与宏
  • 本地优先:基于进程内 DuckDB 引擎,数据处理在本机完成,无需上传云端
  • 多格式与远程数据:CSV/JSON/Parquet/Avro/Excel/空间/SQLite/Jupyter,及 S3/GCS/Azure/HTTPS
  • Friendly SQL:支持 FROM sales LIMIT 10 等简洁写法,自然语言问题可直接映射为查询
  • 自我排障:query、read-file、read-memories 出错时可调用 duckdb-docs 检索官方文档
  • 零配置空间数据:结合 Overture Maps 的 S3 免费数据,无需 API Key

适用场景

  • 让编码 Agent 直接剖析并查询本地 CSV/Parquet/Excel 等数据文件
  • 在会话间延续数据上下文:附加一次数据库,后续查询自动复用
  • 对 S3/R2/GCS 对象存储做即席数据探查,无需先下载
  • 空间数据分析:距离计算、包含判断、空间连接与 GeoJSON 转换
  • 检索 DuckDB/DuckLake 文档与历史会话决策,快速排障与回忆

优势

  • DuckDB 官方团队维护,MIT 许可,完全开源免费
  • 技能之间互相引用形成闭环,共享 state.sql 避免重复交代上下文
  • 本地优先的进程内分析引擎,可处理远大于内存的数据集
  • 原生支持海量数据格式与云存储,Friendly SQL 降低查询门槛
  • 无需 API Key 即可用 Overture Maps 做空间分析

技术能力

APISDKMCP 支持开源可自托管云服务未验证本地运行未验证

信息来源与可信度

共 4 条 · 4 条已验证
来源类型依据状态
GitHub - duckdb/duckdb-skills

https://github.com/duckdb/duckdb-skills

官方仓库 README,确认插件定位、9 个技能、安装方式、共享 state.sql 机制与平台支持已验证
duckdb-skills LICENSE (MIT)

https://raw.githubusercontent.com/duckdb/duckdb-skills/main/LICENSE

LICENSE 文件证明 MIT 许可,版权归 Stichting DuckDB Foundation已验证
DuckDB Skills for Claude Code - DuckDB 官方博客

https://duckdb.org/2026/09/16/duckdb-skills.html

DuckDB 官方博客介绍该插件的技能构成、示例交互与会话状态设计已验证
DuckDB Skills - Setup Guide

https://www.corpusiq.io/docs/hermes/skills/catalog/duckdb-skills-setup

第三方技能目录交叉验证:9 个 SKILL.md、MIT 许可、各技能用途与安装方式,且以 Claude Code 插件/Skill 形式分发而非 MCP Server已验证
最后验证时间:Fri Nov 20来源优先级:官网 > 官方文档 > 官方 GitHub > 官方定价页 > 第三方资料