前言¶
团队手里常有成册的标准、指引、规范或手册 PDF。这些内容要进日常开发流程，常见做法是全文检索、手工摘抄，或让模型临时读一遍再即兴回答——知识难沉淀，下次还得重来。若希望把文档变成 Agent 能反复调用的 Skill（结构化说明、配套资源、可打包分发），需要一套从 PDF 到 Skill 包的固定工序。
下面介绍 SkillHub 上的社区 Skill「Skill母机-专业PDF文档转Skill技能」（坐标 @user_b818ef37/pdf2skill，版本 1.0.0），面向将专业 PDF 转为可复用的 WorkBuddy Skill。
这是什么¶
一句话定位：把专业 PDF 文档转化为 WorkBuddy 可用的 Skill，覆盖文档知识的结构化提取、资源文件编写、质量验证与打包分发。
- 发布与维护：社区来源（
community），发布者user_b818ef37 - 分类：
knowledge-management - 标签：
requires_api_key=false（页面标明无需 API Key） - 官方入口：SkillHub 技能页；线索地址 https://api.skillhub.cn/user_b818ef37/pdf2skill
核心功能¶
以下能力均来自 SkillHub 简介与技能页描述，未展开的实现细节以安装后的 SKILL.md 为准。
- 结构化提取：从标准、指引、规范、手册类 PDF 中整理可复用的文档知识，而不是一次性对话上下文。
- 资源文件编写：为生成的 Skill 编写配套资源文件（具体目录与命名规则见技能包内说明）。
- 质量验证：在打包前对产出做校验（校验项以技能内流程为准）。
- 打包分发：产出可安装的 WorkBuddy Skill 包，便于在团队或项目中复用。
安装与启用¶
SkillHub 推荐两种方式：用 CLI 安装到当前 Agent 的 skills 目录，或把官方提示词发给 AI 由其按安装文档操作。
1. 安装 SkillHub CLI（如尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时可执行完整安装（含默认 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
安装步骤与路径说明见 SkillHub 安装与优先源配置。
2. 安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 识别的 skills 目录；默认装到 ./skills/ 可能不会被加载。
skillhub install @user_b818ef37/pdf2skill --dir <skills 目录>
常用客户端 skills 路径（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/ - WorkBuddy：
~/.workbuddy/skills/
本 Skill 简介明确面向 WorkBuddy Skill；若主环境是 WorkBuddy，优先装到 ~/.workbuddy/skills/。安装后按各客户端要求重启或刷新 Agent，使技能生效。
3. 通过提示词让 AI 安装¶
技能页提供的安装提示为：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_b818ef37/pdf2skill`。
将上述内容发给当前 Agent 即可，由其按文档完成安装与目录配置。
典型用法¶
公开页面未给出单独的命令行示例子流程；可复现的步骤如下。
- 按上一节完成
skillhub install @user_b818ef37/pdf2skill --dir <skills 目录>（或发送官方安装提示词）。 - 在已启用该 Skill 的 Agent 会话中，打开技能包内的
SKILL.md，按其中步骤操作。 - 提供待转化的专业 PDF（标准、指引、规范、手册等），按技能说明完成提取、资源编写、验证与打包。
简介中的目标产物是「可复用的 WorkBuddy Skill」；具体输入格式（单文件、目录、是否需 OCR 等）以 SKILL.md 为准，本文不臆造参数或脚本名。
适用场景与注意¶
适合谁
- 需要把行业规范、内部手册、标准文档沉淀为 Agent Skill 的团队或个人。
- 已在或计划使用 WorkBuddy，并希望 Skill 可打包、可分发、可版本化管理。
使用注意
- 社区 Skill，升级与维护节奏取决于发布者；使用前可在 SkillHub 页查看版本（当前为 v1.0.0）与说明是否更新。
- 页面标注
requires_api_key=false，不依赖额外 API Key；仍须保证本机 Agent、SkillHub CLI 与网络环境满足安装文档要求。 - PDF 版式、扫描质量、表格与附图会影响提取效果；极复杂版式需在验证环节按技能指引人工核对。
- SkillHub 统计（以抓取资料为准）：评分 100000，下载 959，安装 0；数据会随时间变化，以技能页为准。
结尾¶
「Skill母机-专业PDF文档转Skill技能」把「读 PDF」和「做 Skill」连成一条可重复流水线：结构化提取、写资源、验证、打包，面向 WorkBuddy 生态。若你手头是成册规范而非零散笔记，可以把它当作从文档到 Skill 包的入口。
官方技能页：https://www.skillhub.cn/skills/user_b818ef37/pdf2skill
