前言¶
日常开发里，PDF 往往卡在「要读正文、要抠表格、要合并拆分、要填表单」这几类操作上。手写脚本可以，但每次换库、换字段、换版式都要重新对齐依赖和 API。把流程交给带工具的 Coding Agent 时，若没有统一的操作指引，模型也容易在格式细节上反复试错。
下面介绍 SkillHub 上的 pdf-hyl（坐标 @user_3b701cc1/pdf-hyl）。它把 PDF 相关的常见操作收敛成一套 Skill 说明，供 Claude 等 Agent 在需要填写表单、批量处理或分析 PDF 时按文档执行。标签标明 requires_api_key=false，不依赖额外 API Key。
这是什么¶
pdf-hyl 是社区来源（community）的办公效率类 Skill，当前版本 1.0.0，由发布者 user_3b701cc1 维护，分类为 office-efficiency。
官方简介将其定位为「全面的 PDF 操作工具集」：提取文本与表格、创建新 PDF、合并与拆分文档、处理表单；并写明适用时机——当 Claude 需要填写 PDF 表单，或以程序方式大规模处理、生成或分析 PDF 时。
SkillHub 页面：https://www.skillhub.cn/skills/user_3b701cc1/pdf-hyl
API 坐标入口：https://api.skillhub.cn/user_3b701cc1/pdf-hyl
核心功能¶
以下能力均来自 SkillHub 页面与抓取元数据中的简介，未在资料中出现的细节不作延伸。
- 文本与表格提取：从既有 PDF 中抽取可读文本与表格结构，便于后续检索、汇总或入库。
- 创建 PDF：在 Agent 工作流中生成新的 PDF 文档。
- 合并与拆分：对多份文档做合并，或按需求拆分页面。
- 表单处理：支持 PDF 表单的识别与填写场景（简介中单独强调「fill in a PDF form」）。
安装与启用¶
安装方式以 SkillHub 官方说明为准。先做 CLI 检查，再把 Skill 装进当前 Agent 能识别的 skills 目录。
1. 检查或安装 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安装，可按 SkillHub 安装文档执行完整安装（文档地址：https://skillhub.cn/install/skillhub.md）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安装 pdf-hyl¶
安装时必须用 --dir 指向当前环境的 skills 目录，否则默认落在 ./skills/，Agent 可能无法加载。
skillhub install @user_3b701cc1/pdf-hyl --dir <你的 skills 目录>
常见客户端的 skills 路径（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可将下列提示词发给已接入 Skill 安装的 AI，让其按文档完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_3b701cc1/pdf-hyl`。
经过上面的步骤后，重启或刷新 Agent 对 skills 的加载（各客户端行为以自身文档为准），即可在对话中触发该 Skill。
典型用法¶
公开页面未附带逐条命令行示例；用法以「安装 Skill + 用自然语言描述 PDF 任务」为主，任务类型与官方简介一致。下面是可以直接复现的安装提示，以及与之对应的任务表述方式。
安装（复现 SkillHub 页面文案）
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_3b701cc1/pdf-hyl`。
任务示例（与简介能力对齐，由 Agent 按 Skill 内指引选工具与脚本）
- 指定本地 PDF 路径，要求提取全文或某一页的表格，并输出为 Markdown 或 CSV。
- 给出多份 PDF 路径，要求合并为一份，或按页码范围拆成多个文件。
- 提供带 AcroForm 的 PDF 与字段取值（如姓名、日期），要求生成已填写的新 PDF。
- 根据结构化数据（如 JSON 或表格）要求生成一份新的 PDF 报告。
具体依赖、命令与边界以安装后 Skill 包内的 SKILL.md 为准；本文不臆造未公开的脚本名或配置项。
适用场景与注意¶
适合谁
- 已在 Cursor、Claude Code、Codex 等环境使用 Skills，且经常处理合同、报表、扫描件、可填写表单等 PDF 的开发者或运营同学。
- 希望把「读 PDF → 改 PDF → 交付文件」放在同一次 Agent 会话里完成，而不是每次单独写一次性脚本的人。
使用上需注意
- 社区 Skill，行为与依赖以安装包内容为准；升级前可用
skillhub查看版本（当前 listing 为 1.0.0）。 - 扫描版 PDF、复杂版式或加密文档是否支持，取决于 Skill 内实现；资料未说明的限制处，应在实际文件上先试小样本。
- SkillHub 统计（抓取时）：评分 100000，下载 856，安装 7；数据随平台更新可能变化，以页面为准。
结尾¶
pdf-hyl 把 PDF 的提取、生成、合并拆分和表单处理收进一个 Skill，让 Agent 在接到文档类任务时有固定操作面，且无需配置 API Key。若你正在 SkillHub 上找办公效率方向的 PDF 能力，可从官方页面入手：
- https://www.skillhub.cn/skills/user_3b701cc1/pdf-hyl
- https://api.skillhub.cn/user_3b701cc1/pdf-hyl
