duckdb-docs
作者 duckdbduckdb-docs 可帮助你在本地 DuckDB 缓存中搜索 DuckDB 和 DuckLake 文档、博客文章，以及已索引的参考片段。适合需要可追溯来源的答案、精确术语，以及 Technical Writing 工作流中需要准确章节引用的 duckdb-docs 场景。
该技能得分 74/100，说明它值得在目录中展示：它确实提供了一个可触发的 DuckDB 和 DuckLake 文档搜索工作流，但描述较简略，且缺少安装命令和配套参考文件，因此上手门槛仍有一定摩擦。更适合把它当作实用的文档检索技能，而不是一个已经打磨完善的完整包。
- 触发条件和输入形式明确：描述中说明它用于搜索 DuckDB/DuckLake 文档，并接受问题或关键词。
- 工作流足够具体：会检查 DuckDB、安装所需扩展、在两个已记录索引之间选择，并执行搜索查询。
- 对 agent 很有帮助：它返回的是本地缓存全文索引中的相关文档片段，相比通用网页搜索提示更能减少猜测。
- 元数据较少：description 长度只有 1，且没有 install command，这会让目录评估和新用户上手不够直接。
- 没有附带支持文件或参考资料，因此用户理解边界情况和行为时主要还是要依赖 SKILL.md。
duckdb-docs 技能概览
duckdb-docs 的作用
duckdb-docs 技能可以帮助你从本地 DuckDB 缓存中检索 DuckDB 和 DuckLake 的文档、博客文章，以及已索引的参考片段。它特别适合回答“这个是在哪里写的？”或者“文档里对这个功能是怎么说的？”这类问题，而且通常比手动翻网站快得多。
适合谁用
如果你在写技术内容、支持用户，或者需要基于原始来源给出 DuckDB 或 DuckLake 的准确答案，就适合使用 duckdb-docs 技能。它尤其适合 duckdb-docs for Technical Writing 这类工作流，因为你需要的是准确术语、章节引用和相关文档摘录，而不是泛泛的总结。
它为什么不一样
这不是一个通用聊天提示词。duckdb-docs 技能期望你输入一个简短问题或关键词，先检查 DuckDB 和必需扩展是否存在，然后再去搜索缓存的全文索引。这样做的优势是检索快、定位准，但也意味着你的输入必须足够具体，搜索索引才能发挥作用。
如何使用 duckdb-docs 技能
安装 duckdb-docs 技能
先通过 GitHub 的技能安装流程安装 duckdb-docs，然后确认这个技能已经在你的 agent 环境中可用。duckdb-docs install 这一步本身并不难，真正的前提是你本地要有可用的 DuckDB CLI，因为这个技能会直接调用它。
给它一个“像搜索”的提示词
duckdb-docs usage 的输入方式应该是问题、关键词或简短主题，而不是长篇说明。比较好的输入例如：
How does DuckDB handle list aggregation?DuckLake catalogsHTTPFS extension install errorcurrent docs for COPY INTO
如果你已经知道文档所属的主题范围，就把它带上。比起“explain DuckDB”这种宽泛请求，更紧的查询通常能返回更有用的片段。
按工作流执行，并检查正确的文件
先看 SKILL.md，因为这里写着执行顺序和搜索索引的选择逻辑。在这个仓库里，没有需要优先阅读的辅助脚本或参考目录，所以主要价值在于理解 DuckDB CLI 检查、扩展安装，以及两个索引选项：DuckDB docs/blog 和 DuckLake docs。
提高检索效果的实用技巧
要根据目标来选索引：一般问题默认用 DuckDB docs + blog；如果主题涉及 catalogs、preview/stable 行为，或者 DuckLake 专属功能，就明确提到 DuckLake。若你需要的是精确措辞，就直接要求某个 section 或 chunk，而不是宽泛总结。对于 duckdb-docs guide 这类任务，尽量一次只聚焦一个概念和一个版本目标。
duckdb-docs 技能 FAQ
duckdb-docs 只用于 DuckDB 文档吗？
不是。这个技能同时覆盖 DuckDB docs/blog 内容和 DuckLake 文档，具体会根据你的查询来选择索引。如果你的请求提到了 DuckLake，它应该会路由到 DuckLake 的搜索缓存，而不是默认的 DuckDB 索引。
安装前我需要知道什么？
主要的依赖风险在环境配置，而不在文档索引本身。这个技能会检查 duckdb 命令，并且要求 httpfs 和 fts 扩展都能成功安装。如果其中任何一个缺失，搜索流程就会提前停止。
它比普通提示词更好吗？
当你需要有来源依据的检索时，是的。普通提示词可以解释概念，但 duckdb-docs 是为了快速找到最相关的文档片段而设计的。这让它更适合查找引用、核对术语，以及把模糊问题收窄到具体页面或章节。
什么时候不该用它？
如果你需要代码执行、数据分析，或者不依赖文档就能回答的宽泛概念解释，就不要用 duckdb-docs。它是一个搜索和检索技能，所以只有在用户已经知道主题，或者能明确说出关键词时，效果最好。
如何改进 duckdb-docs 技能
先把第一轮查询收窄
提升效果最大的办法，是把输入写得更清楚。不要问 How do I load files?，可以改成 DuckDB read CSV with read_csv_auto 或 DuckLake authentication docs。这样搜索步骤更容易返回相关片段，而不是位置接近但没用的页面。
明确你想要的输出
如果你是为了写文档、支持材料或培训内容而查资料，请直接说明。duckdb-docs for Technical Writing 在你要求精确章节名、简短原文引用，或者最能解释某个功能行为的页面时，效果会更好。这样可以减少改写，也让结果更容易核对。
注意环境失败
常见失败模式包括 DuckDB 缺失、扩展安装失败，或者你问的主题落到了错误的索引里。如果技能报告的是扩展或 CLI 错误，先修复环境；如果结果集看起来不对，就用更精确的术语重试，或者明确写出 DuckDB 还是 DuckLake。
从关键词迭代到问题
一个好的 duckdb-docs 工作流是：先用关键词起步，查看返回的片段，再用第二轮查询把目标收窄到具体功能、错误或版本。通常这种迭代方式，比试图用一个宽泛提示词一次解决所有问题更快，也更准确。