企业官网建设流程全解析

Docling 如何用 library-skills 给 AI 编码代理安装 Docling usage skill？

【免费下载链接】doclingGet your documents ready for gen AI项目地址: https://gitcode.com/GitHub_Trending/do/docling

Docling 在其 Python 包内部自带了一个usage skill（位于docling/.agents/skills/docling/），教会 AI 编码代理如何正确地转换、抽取和切分文档。这篇文章的任务是：用library-skills这个命令行工具，把该 skill 安装到你自己的项目里，让 Codex、Cursor、Copilot、Claude Code 等代理能自动发现它。完成后，skill 会以符号链接的形式出现在项目的.agents/skills/docling（或 Claude Code 的.claude/skills/docling）目录下，且以后每次升级 Docling，skill 内容都会自动同步更新。

准备条件：先确认 docling 已是项目依赖

library-skills的工作方式是读取你项目的pyproject.toml、扫描项目环境中已安装的包，然后找到其中捆绑的 skill。因此前提是docling已经是项目依赖——如果项目里还没有 Docling，library-skills不会自动发现它。

如果尚未安装，先执行以下任一命令（按你项目的包管理器选择）：

uv add docling

或

pip install docling

注意：Docling 的 usage skill 在其元数据中声明了compatibility: Requires Python 3.10+（见 SKILL.md），Python 环境需满足该版本要求。

执行步骤：用 library-skills 安装 skill

根据你使用的代理选择命令。

大多数代理（Codex、Cursor、Copilot 等）：

uvx library-skills

Claude Code：它使用.claude/目录而不是.agents/，需要传--claude参数，使 skill 安装到.claude/skills：

uvx library-skills --claude

执行后library-skills会创建指向 Docling 包内 skill 的符号链接，落到.agents/skills/docling（或.claude/skills/docling）。由于用的是符号链接，升级 Docling 后 skill 内容自动跟随更新，无需重新安装。

结果验证

安装完成后，检查项目根目录下是否出现了对应目录的符号链接：

• 常规代理：.agents/skills/docling
• Claude Code：.claude/skills/docling

链接指向的内容应包含 skill 的入口文件和按需加载的参考文档，结构如下（来自 docs/usage/agent_skills.md）：

docling/.agents/skills/docling/ ├── SKILL.md # 入口：Docling 是什么 + 何时走哪条路径 └── references/ ├── cli.md # 命令行转换任意格式 ├── python-sdk.md # DocumentConverter + PipelineOptions，批量、ASR、图片/表格导出 ├── extraction.md # DocumentExtractor —— 从文档提取类型化字段（beta） ├── rag.md # 切分 + LangChain / LlamaIndex / Haystack loaders ├── service-client.md # 通过 docling-serve 远程转换（自建或托管） └── slim-packaging.md # docling-slim 安装 extras

其中SKILL.md是一个短小的"路由器"，references/*.md由代理按需加载，代理只读取当前任务需要的部分。代理按任务类型被引导到对应入口：

如果符号链接存在且指向包内路径，安装即成功，代理下次运行时就能发现并加载该 skill。

替代路径：手动注册 skill 路径

如果你的代理运行时还不支持.agents/目录约定，可以手动定位 skill 目录并注册。运行以下命令：

python -c "import importlib.util, pathlib; \ print(pathlib.Path(importlib.util.find_spec('docling').origin).parent / '.agents/skills/docling')"

命令会打印出已安装docling包内的 skill 目录路径（前提是docling已在当前 Python 环境中安装），然后把你的代理指向打印出的路径，或者指向该目录内的SKILL.md文件即可。

边界与限制

• docling 未安装时找不到 skill：library-skills只扫描已安装的依赖，docling不在项目中时它不会自动发现，必须先按"准备条件"一节安装。
• usage skill 与 development skill 是两套东西：本文安装的是usageskill，帮助代理使用Docling。贡献者开发Docling 所用的developmentskills 保存在仓库自身的.agents/skills/目录（如 dignified-python），不随 Python 包分发，library-skills也不会安装它们。这一点在 AGENTS.md 中有明确说明。
• skill 随包升级自动更新：正因为是符号链接而非拷贝，升级 Docling 后无需重新执行uvx library-skills。

完整说明可继续查阅 docs/usage/agent_skills.md，skill 本体见 docling/.agents/skills/docling/SKILL.md。

【免费下载链接】doclingGet your documents ready for gen AI项目地址: https://gitcode.com/GitHub_Trending/do/docling