Anthropic Skills 实测:打包检查与 PDF 回填

固定源码验证十九个技能入口、打包过滤与 PDF 表单回填。文本和复选框成功,下拉框合法值被拒绝,说明格式校验不能替代任务验收。

AgentIndex · 发布于 2026-11-07 · 更新于 2026-11-07

Anthropic Skills 值得参考的地方,是把任务说明、脚本和资源放在同一技能目录。采用时要回答的实际问题则是:目录能通过检查,是否就能安全地打包、正确地处理输入文件?本篇用上游原脚本处理人工技能目录与真实 PDF 表单文件,把这几件事分开验证。

结果并不全是通过。文本与复选框成功回填,重新打开文件后逻辑值与页面控件一致;但一个合法的下拉框选项被拒绝。同一个选项直接交给本次安装的 pypdf 可以写入。技能最小校验器还接受空名称与空描述,打包器会收入普通的 .env 文件。这些结果支持复用具体脚本,也说明接入前需要检查输入形式、包内文件和输出。

版本与方法

2026 年 11 月 7 日,我们固定仓库提交 2c5958ecac7cee2b583967a2c4981d0f4a75c579。在 macOS 26.6.2 上使用 CPython 3.12.13(x86_64)、pypdf 7.0.0、ReportLab 5.1.0 与 PyYAML 6.0.3。技能和表单只放在独立临时目录,没有安装进真实 Claude 客户端,没有调用模型,也没有读取个人文档。

复现脚本与原始结果 保存提交、相关文件 SHA-256、Python 依赖和命令。外部 SKILL.md 在本次是被检查的数据;我们没有让它们接管评测流程。固定版本项目说明

实际检查结果
skills/*/SKILL.md19 个入口;市场中的 5 个插件共引用 19 个有效路径
上游最小校验器检查全部入口18 个通过;claude-api 描述 1068 字符,超过脚本的 1024 字符限制
人工正常/异常元数据正常通过;大写及下划线名称、未知字段被拒绝;空名称和空描述通过
打包内容保留脚本和普通资源;排除根目录 evals、node_modules、缓存及指定系统文件
PDF 文本和复选框写入、重新打开与控件值检查通过;页面渲染正常
合法下拉框选项上游脚本拒绝完整值;直接 pypdf 对照成功

19 个入口是这个提交的目录数量,不是任务能力评分。5 个插件也不能解释为五种互不重叠的功能。

校验脚本检查到哪里

我们创建了只含本地摘要说明的人工技能。正常元数据通过;把名称改为带大写和下划线的值,或加入未知顶层字段,均返回退出码 1。它能够发现一部分提交前格式问题。

把名称和描述都写成空字符串时,脚本却返回退出码 0。源码先检查键是否存在和类型,再只对非空内容检查命名和长度。因此,“校验通过”不能推出技能有可用的发现信息。最小校验器

对仓库自身的扫描还发现 claude-api 描述超出这个脚本的限制。这是两个上游资源之间的可复现不一致,不能据此声称该技能无法在 Claude 中加载,因为本篇没有做客户端加载测试。

打包前需要看归档清单

上游打包器生成了一个可由 ZIP 工具重新打开的 .skill 文件。人工脚本、技能入口和普通说明均保留,根目录的 evals、node_modules、__pycache__、.pyc 与 .DS_Store 按代码里的规则过滤。

我们还放入一个只有假标记的 .env。它出现在最终归档中,没有被过滤。没有真实凭据参与测试,也没有把这个包上传到任何服务。结果只是说明该打包器的排除清单不包含所有可能的本地配置文件,不能把它当成保密信息扫描器。团队分发技能时,应明确列出应交付的文件,再检查最终包清单。打包实现

许可证也应按目录确认:这个快照中有 18 个技能目录附带 Apache-2.0 文本,doc-coauthoring 没有同目录许可证文件。本篇不把这点解释为整仓每项资源都具有统一授权。

PDF 成功结果同时检查数据和显示

我们用 ReportLab 创建一页包含文本、复选框和下拉框的 AcroForm。提取脚本识别出三个字段及页码;填充脚本成功写入文本 Review User 和复选框选中值。

随后重新打开输出 PDF,同时检查 get_fields() 中的 /V、页面 /Widget 的有效值,以及非空外观数据。两项更新都一致。Poppler 渲染后,文本与勾选状态也可见。渲染过程报告了一条 ZaDb 字体标签警告,但本次可视结果正常;这不是对所有 PDF 阅读器的兼容性承诺。

异常输入方面,不存在的字段、错误页码、非法复选框值和非法下拉选项均被拒绝,没有写出对应输出文件。这个行为对批量回填有价值:调用方可以把非零退出码当作需要人工检查的信号。

下拉框失败有直接对照

人工表单的选项是完整字符串 Standard 与 Priority。提取结果把它们报告成 S、P;填充脚本随后以“不在允许值里”为由拒绝 Priority。源码把每个选项当成二元数组访问,在这个字符串选项样本上取到了字符。字段提取、回填校验

为避免只凭失败推测原因,我们绕过该上游包装脚本,用相同 pypdf 版本对同一输入填写完整值。输出重新打开后保留 Priority。这缩小了问题范围,但不代表已覆盖所有下拉框编码、PDF 生成器或 pypdf 版本。我们没有修改上游代码来制造成功。

采用建议

把这个仓库当作可审查、可复用的技能实现参考更合适。先选一个真实任务,列出它依赖的脚本、工具和输入格式,再同时验收文件内容与显示结果。需要批量填表时,应先检查自己的表单是否使用了本篇出问题的字符串选项形式。

本篇没有测试技能自动触发、Claude 插件安装、模型输出质量、Office 转换、OCR 或 API 托管执行,因此不给成功率、token 节省或跨客户端兼容性结论。想对比其他资源库的结构验收,可看 Awesome Copilot 评测;想了解配置安装的实际副作用,可看 Claude Code Templates 实测。