前言¶
日常开发或运维里，PDF 往往散落在脚本、桌面工具和一次性命令之间：合并几份合同、从扫描件里抠文字、批量转成 Word 或图片，每换一类操作就要换一套工具或查一遍参数。把能力收进一个 Agent Skill，可以在对话里按任务描述让模型按统一流程执行，减少反复切换环境。
下面介绍 SkillHub 上的社区 Skill「精简PDF处理工具包」（坐标 @user_05cc33a7/pdf-fast-handler-skill，当前版本 1.0.1），面向办公自动化、格式转换、文档整理和扫描件处理等高频场景。
这是什么¶
「精简PDF处理工具包」是一款轻量、面向 PDF 的 Agent Skill，以通用 SKILL.md 形式发布，由社区用户 user_05cc33a7 维护，在 SkillHub 分类为 office-efficiency，来源标记为 community。官方页面说明其集成文本提取、合并拆分、格式转换、页面编辑、安全与压缩、批量处理等能力，目标是在 Agent 对话中完成常见 PDF 操作，而不必为每个子任务单独找 CLI。
Skill 标签标明 requires_api_key=false，即按 SkillHub 展示信息，不依赖额外 API Key 即可安装使用（具体仍取决于 Skill 内部是否调用本机工具或第三方库，以安装后的 SKILL.md 为准）。
核心功能¶
以下能力均来自 SkillHub 官方简介，按用途归类，便于对照需求选型。
内容与识别
- 文本提取、文件信息查询
- OCR 图文识别、扫描版 PDF 转文字
- 图片提取、表格提取、书签提取、批注提取
格式转换
- PDF 转 Word、图片、HTML、TXT、Markdown
- 多张图片合成 PDF、Word 转 PDF
- 批量转 Word、批量转图片、批量 Word 转 PDF
文档编辑
- PDF 合并、拆分
- 页面旋转、删除页码、提取页面、插入页面、替换页面、页面反转
- 页眉页脚、自动页码、水印添加
安全与维护
- PDF 加密、解密
- 文件压缩、文档修复
- 批量处理（总称，与上述批量转换能力并列出现在官方说明中）
先做能力对齐，再在对话里点名具体任务，比一次性罗列全部动词更符合实际使用方式。
安装与启用¶
SkillHub 官方推荐两种方式：用 CLI 安装，或把安装提示词发给当前使用的 AI，让其按 SkillHub 安装文档操作。
1、确认 SkillHub CLI
检查本机是否已有 skillhub：
command -v skillhub && skillhub --version
若未安装，可按 SkillHub 安装文档执行完整安装（CLI + 默认 Skill）：
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、安装本 Skill 到当前 Agent 的 skills 目录
安装时必须用 --dir 指向当前 Agent 识别的 skills 目录；否则默认落在 ./skills/，Agent 可能无法加载。SkillHub 文档给出的常见路径包括：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装命令示例（将 <skills 目录> 换成上面对应路径）：
skillhub install @user_05cc33a7/pdf-fast-handler-skill --dir <skills 目录>
也可在对话中发送官方页面提供的提示词，让 AI 按文档安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_05cc33a7/pdf-fast-handler-skill`。
3、启用与刷新
安装完成后，按你所用 Client 的惯例重启或刷新 Agent，使其读取新 Skill。具体触发方式因 Client 而异，以各产品当前文档为准。
典型用法¶
本 Skill 没有在本次资料中附带可复制的独立脚本示例；用法遵循 Agent Skill 的常规模式：安装并启用后，在对话中说明输入文件、期望输出和约束，由 Agent 根据 SKILL.md 中的步骤调用相应处理方式。
可复现的「安装侧」示例即上一节的 skillhub install 与官方提示词。业务侧可按官方能力列表组织请求，例如：
- 指明本地或工作区内的 PDF 路径，以及输出目录或文件名。
- 说明单一操作（如「合并这两个 PDF」「把第 3–5 页拆成新文件」）或批量任务（如「目录下所有 PDF 转图片」）。
- 对扫描件补充是否需要 OCR 或「扫描版转文字」，避免与纯文本 PDF 的提取混淆。
经过上面的步骤，Agent 应在 Skill 规则范围内执行；若某次任务超出 Skill 声明能力，以对话中 Agent 的说明为准，必要时回到 SkillHub 页面核对版本是否为 v1.0.1。
适用场景与注意¶
适合谁
- 经常在 Cursor、Claude Code、Codex 等支持 Skills 的环境里处理 PDF 的开发者或办公用户。
- 需要合并、拆分、转格式、加水印、页码与页眉页脚等重复性操作，希望用自然语言驱动而非记忆多套命令的场景。
- 扫描件、表格、批注等需要从 PDF 中结构化取出的整理工作（以 Skill 实际实现为准）。
使用注意
- 社区来源（
community）意味着维护节奏与上游工具链以发布者更新为准；升级可用skillhub对同一坐标做更新，并关注 SkillHub 上的版本号。 - 大文件、加密 PDF、复杂版式转换的效果取决于 Skill 依赖的本机组件；资料未列出具体依赖时，应在首次使用前在小样本上试跑。
- 涉及加密、解密与批处理时，注意备份原文件，并在共享仓库或日志中避免泄露敏感路径与内容。
- SkillHub 页面统计（截至资料抓取）：评分 100000，下载 17050，安装 265；与线索中的其他数字不一致时，以 SkillHub 页面与 API 抓取字段为准。
结尾¶
「精简PDF处理工具包」把 PDF 相关的提取、转换、页面编辑、安全与批量能力收拢到一个 Skill 坐标里，适合在 Agent 工作流里用对话代替零散脚本。若你需要在本地 Client 中试用，可从 SkillHub 官方页获取安装提示与版本信息：
- Skill 页面：https://www.skillhub.cn/skills/user_05cc33a7/pdf-fast-handler-skill
- 安装说明：https://skillhub.cn/install/skillhub.md
- 坐标：
@user_05cc33a7/pdf-fast-handler-skill（v1.0.1）
