Anthropic PDF Skill 安装
安装官方 PDF Skill,在 Claude Code / Cursor / OpenCode 等环境中处理 PDF 提取与相关开发任务。
概述
Agent Skills 是可复用的说明包(目录 + SKILL.md)。Anthropic 公开的 anthropics/skills 含 PDF 等示例技能:需要时再加载完整说明,避免占满每次会话上下文。
前置条件
- 已安装支持 Skills 的客户端(Claude Code、Cursor、OpenCode 等)
- 能访问 GitHub(克隆或
npx skills add) - PDF 相关系统依赖若 skill 有要求(如部分环境需要 poppler 等),按该 skill 说明安装
安装与获取
方式 A:skills CLI(推荐,可装到多工具)
npx skills add https://github.com/anthropics/skills --skill pdf
具体 skill 名以仓库目录为准(常见为 pdf / pdf-processing 等,安装前先看仓库 README)。
方式 B:手动
- 从 anthropics/skills 获取 PDF skill 目录
- 放到客户端扫描路径,例如:
- Claude Code:
.claude/skills/<name>/或~/.claude/skills/<name>/ - OpenCode:
.opencode/skills/<name>/或兼容的.claude/skills/ - Cursor:按当前版本 Rules / Skills /
.agents/skills/约定放置 - 重启 Agent 会话
首次配置
- 确认
SKILL.md含合法 frontmatter(name、description) - 目录名与
name字段一致 - 在会话中列出可用 skills,或直接说:「用 PDF skill 提取这份文件的标题与目录」
核心用法
典型任务:
- 从 PDF 提取文本 / 表格摘要
- 按页定位章节再改业务代码(例如根据规格文档实现校验)
- 批量文档的结构化输出(JSON / Markdown)
示例提示:
使用 PDF skill 阅读
./docs/spec.pdf,列出必须实现的验收标准,再在本仓库补对应测试(先不要改生产代码)。
开发实践
- 规格进仓库:把 PDF 或导出的 Markdown 纳入版本管理(注意体积与版权)
- 先提取再编码:让 Agent 先产出结构化需求,再实现
- Skill 保持精炼:流程类说明放在 skill;项目宪法放 Rules / CLAUDE.md
- 验证:对提取结果抽检;自动化测试覆盖解析后的关键字段
常见问题
- Skill 未被选用:把
description写得更具体(何时使用、处理什么文件) - 依赖缺失:阅读 skill 内说明安装系统包
- 路径不对:确认客户端正在扫描的 skills 根目录