1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | nutrient-agent-skill |
| 作者/维护者 | Nutrient(原 PSPDFKit,文档处理 SDK 厂商),GitHub 组织账号 PSPDFKit-labs |
| 来源链接 | https://github.com/PSPDFKit-labs/nutrient-agent-skill |
| 许可证 | Apache-2.0(仓库内 nutrient-document-processing/LICENSE.txt,README 显式标注,GitHub API 交叉确认) |
| GitHub Stars | 15(GitHub API 数据) |
| Forks | 0(GitHub API 数据) |
| 最新版本 | SKILL.md 元数据标注 version 1.0;最近一次实质性提交 2026-03-23(新增「Security Hardening Addendum」章节,GitHub API 提交记录) |
| 安装方式 | npx skills add PSPDFKit-labs/nutrient-agent-skill,或手动复制 nutrient-document-processing/ 目录到对应 agent 的 skills 目录 |
2. 功能介绍与亮点
nutrient-agent-skill 让 agent 通过 Nutrient 的文档处理云 API(DWS)完成一整条文档处理流水线,覆盖生成、格式转换、拼装、抽取、识别、脱敏、签署、合规输出等环节:
- 生成与转换:从 HTML 模板/远程 URL 生成 PDF;PDF 与 DOCX/XLSX/PPTX、图片互转
- 拼装:合并、拆分、重排、旋转、展平 PDF 页面
- 抽取与 OCR:提取文本、表格、键值对;支持多语言扫描件 OCR
- 脱敏与水印:正则/预设规则脱敏与 AI 语义脱敏(识别身份证号、邮箱、信用卡号等敏感信息)双模式;文字/图片水印
- 签署与表单:程序化填写 PDF 表单;CMS/CAdES 标准数字签名
- 合规与优化:转换为 PDF/A、PDF/UA 等归档/无障碍合规格式;PDF 线性化优化以加快网页加载
- SKILL.md 正文附带专门的「Security Hardening Addendum」章节,明确要求 API Key 走进程环境变量注入、禁止提交进配置文件、校验 MCP 包来源版本等安全实践,在同类技能中较为少见
- 单一操作对应独立脚本(
convert.py、ocr.py、redact-ai.py等),多步骤工作流则通过复制模板临时脚本执行,避免向仓库固化一次性管线代码
3. 适用场景
所属分类:文档与办公自动化。
适合需要在 agent 对话中直接完成文档批处理的用户:法务/合规人员批量脱敏后对外分享合同、行政人员填写并签署入职表单、内容团队把扫描件 OCR 成可检索文本、需要产出 PDF/A 或 PDF/UA 等归档合规格式的机构用户,以及需要把生成的 PDF 做线性化优化以加快网页下载体验的开发者。
4. 跨 Agent 兼容性
- Claude Code:✅ 原生支持——README「Supported Agents」章节明确列出,且给出
.claude/skills/(项目级)与~/.claude/skills/(全局)两种安装路径 - Codex:✅ 原生支持——README 明确列出 Codex CLI,安装路径
.codex/skills/ - OpenClaw:✅ 原生支持——README 明确列出 OpenClaw,安装路径
skills/(项目级)与~/.moltbot/skills/(全局) - Hermes Agent:❓ 未验证——已抓取材料未点名,仅笼统标注「40+ agents,遵循 Agent Skills 标准者均可自动兼容」
5. 推荐理由
多数文档技能靠本地库(如 pypdf、python-docx)在 agent 本机拼凑操作,遇到扫描件 OCR、AI 语义脱敏、正式数字签名、PDF/A・PDF/UA 合规转换这类需要专业文档引擎的任务时往往力不从心或结果不稳定。nutrient-agent-skill 把这些操作都转交给 Nutrient 自家的文档处理云服务完成,用一个免费额度起步的 API Key 换来生成、转换、拼装、OCR、脱敏、签署、合规、优化的完整覆盖,且明确写清楚了数据流向与凭据存储的安全实践,适合需要交付正式、合规文档而不只是“能跑就行”的场景。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 发布方 Nutrient(原 PSPDFKit)即该技能所服务的 Nutrient DWS API 的所有者,属第一方官方出品;GitHub 星数(15★)本身不足以单独支撑评分,暂未发现独立第三方评测或规模化讨论 |
| 可用性 | 8 | npx skills add 一条命令即可安装并自动适配已检测到的 agent;SKILL.md 正文清晰,按操作类型拆分为多份 references/ 参考文档;需配置一枚 Nutrient API Key(有免费额度,非强制付费);最近一次实质性提交为 2026-03-23,距今约四个半月,未见弃置迹象 |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单:
① Shell 命令:脚本均为 uv run 执行的单一文档操作 Python 脚本,范围明确,不涉及任意 shell 命令执行
② 联网外发:是——文档会上传至 Nutrient 自有云端 API 处理,README 与 SKILL.md 均清楚说明该数据流向,外联目标透明
③ API Key:需要,SKILL.md 明确要求通过进程环境变量注入、禁止提交进已提交的 JSON 配置文件
④ 可疑指令:通读 SKILL.md 与脚本说明未发现 prompt injection 或隐蔽指令迹象;反而专设「Security Hardening Addendum」章节指导凭据存储与包来源校验
⑤ 作者信誉:发布方为 Nutrient 官方组织账号(GitHub: PSPDFKit-labs),无刷星或 SEO 操纵措辞迹象
⑥ License:Apache-2.0,明确
⑦ 最近维护:2026-03-23 有实质性提交,未见弃置迹象
综合评分(三项均值)= 7.67
7. 跟同类 Skills 相比的优势
| Skill | 定位 | 与 nutrient-agent-skill 的差异 |
|---|---|---|
| pdf-anthropics-skills(Anthropic 官方) | 本地执行,用脚本提取字段结构与坐标再交模型填充,覆盖文本/表格抽取、OCR、表单核验、合并拆分加水印 | 纯本地运行、无需 API Key 与联网,但不含 AI 语义脱敏、数字签名、PDF/A・PDF/UA 合规输出等能力 |
| adobe-create-pdfs-from-data-adobe-skills(Adobe 官方) | 把 CSV 数据与 InDesign 模板批量合并,自动生成个性化 PDF(如证书、邀请函) | 专注“数据 + 模板 → 批量个性化 PDF”这一细分场景,不覆盖 OCR、脱敏、签署、格式互转等通用文档处理链路 |
| minimax-pdf-minimax-ai-skills(MiniMax 官方) | token 化设计系统,把 PDF 生成、填表、改版三合一,追求出版级排版观感 | 侧重生成阶段的视觉设计质量,不涉及扫描件 OCR、PII 脱敏、数字签名或归档合规转换 |
| nutrient-agent-skill(本技能) | 云端 API 驱动的全流程文档处理:生成、转换、拼装、OCR、AI 脱敏、签署、合规、优化 | 覆盖面最完整,尤其在 AI 语义脱敏、CMS/CAdES 数字签名、PDF/A・PDF/UA 合规转换上是其余三者都未覆盖的能力;代价是依赖云端 API 与网络连接,而非纯本地执行 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价;已找到的第三方页面均为技能市场/目录的收录条目展示,不构成独立评价。
9. 其他补充
- README 附带三段真实工作流演示(GIF 动图):OCR 扫描合同并抽取文本、填写入职表单并数字签名、脱敏患者记录中的 PII 后再分享,直观展示典型用法
- 技能内含用量查询能力,可直接询问 agent“还剩多少 API 额度”来监控 Nutrient 云端调用消耗
- 除 40+ agent 通用安装方式外,README 单列了 Claude Code / Codex CLI / Gemini CLI / Cursor / GitHub Copilot / OpenCode / Windsurf / Amp / OpenClaw / Roo Code 十个平台各自的项目级与全局安装路径
10. 安装使用方式
命令行工具方式(推荐,自动适配已检测到的 agent):
npx skills add PSPDFKit-labs/nutrient-agent-skill
仅安装到指定 agent:
npx skills add PSPDFKit-labs/nutrient-agent-skill -a claude-code -a codex
手动方式(以 Claude Code 为例):
git clone https://github.com/PSPDFKit-labs/nutrient-agent-skill.git
cp -R nutrient-agent-skill/nutrient-document-processing .claude/skills/
安装后需在 https://dashboard.nutrient.io/sign_up/?product=processor 注册获取免费 API Key,并设置环境变量:
export NUTRIENT_API_KEY="nutr_sk_..."
配置完成后无需重启,可直接向 agent 提出“把这份扫描合同 OCR 成可搜索文本”“帮我给这份 PDF 脱敏所有身份证号和邮箱”“把这份报告转成 PDF/A 格式归档”等需求。
11. 注意事项
- 核心处理逻辑运行在 Nutrient 云端,文档内容会经网络上传至其服务器处理,涉及敏感文档前应先了解 Nutrient 的数据处理政策
- 免费额度用尽后需升级付费方案才能继续大批量处理,可通过技能内置的用量查询能力提前监控
- Hermes Agent 上的兼容性未经验证;仓库对该平台没有点名说明