Skill 配置指南：给 Agent 装上专业能力包

打个比方：一个刚从医学院毕业的医生是"通用 AI"——什么病都能看一点，但都不精。如果让他去皮肤科进修三个月，他就成了"皮肤科专家"。Skill 就是 Agent 的"专科进修课程"——装上它，Agent 就从"通用助手"变成"某领域的专家"。

Skill 是一段结构化的指令和知识，告诉 Agent 在处理特定任务时应该遵循什么规则、使用什么工具、参考哪些知识。它像给 Agent 装了一个"专业能力包"——装上 PDF 处理 Skill 后，Agent 就知道怎么合并 PDF、怎么提取文字、怎么加水印。

怎么给 Agent 装 Skill

不同 Agent 工具安装 Skill 的方式不同，但都遵循类似模式：

Claude Code：在项目根目录的 .claude/skills/ 文件夹下放一个 SKILL.md 文件即为安装了 Skill。也可以用 npx skills add <github-repo> --skill <skill-name> -g -y 命令一键安装。
Codex CLI：Skill 文件放在 .codex/skills/ 目录下。Codex 在启动时会自动加载目录内的所有 Skill。
OpenCode / Cursor：通常通过项目根目录的 .cursor/rules/ 或类似配置目录加载 Skill 规则。

Skill 文件本质上就是 Markdown 文档，包含角色定义、任务规则、示例参考。你可以自己写，也可以从社区下载现成的。

Skill 去哪里找 (重点)

来源	内容	获取方式
skill.sh	在线 Skill 目录网站，可搜索、浏览、一键安装	skill.sh 网站直接使用
VoltAgent/awesome-agent-skills	1000+ 官方和社区 Skill，覆盖编程、设计、科研、办公等	GitHub 浏览 `npx skills add`
sickn33/antigravity-awesome-skills	1500+ Skill，含安装器 CLI 和工作流包	GitHub 浏览 `npx skills add`
openai/skills	OpenAI 官方 Skill 目录，专为 Codex 设计	GitHub 直接下载
harbor-framework/skills	Harbor 框架的公共 Skill 目录	GitHub 浏览
stark-ai-de/agent-skills	面向 Codex 运维、工程工作流的 Skill 集合	GitHub 浏览
自写 SKILL.md	根据自己项目需求编写的定制 Skill	放在 `.claude/skills/` 或 `.codex/skills/`

Skill 文件内部长什么样

一个典型的 SKILL.md 文件包含以下部分：

---
name: pdf
description: PDF processing - merge, split, extract, watermark
---

# PDF Processing Skill

## When to use
- User mentions .pdf files
- User wants to combine/merge/split PDFs
- User asks about extracting text from PDFs

## Rules
- Always use pypdf or pdfplumber, never pdfkit
- Validate output page count after merge
- Preserve original file metadata when possible

## Examples
### Merge two PDFs
Input: "merge report.pdf and appendix.pdf"
Use: pypdf.PdfWriter to combine pages
Output: merged_report.pdf

你自己装过哪些 Skill

如果你是 Claude Code 用户，你当前项目中就已经有安装的 Skill —— 比如刚才安装的 ui-ux-pro-max 就是一个 Skill。去 .claude/skills/ 目录下看看，里面每一个文件夹都是一个 Skill。打开任意一个 SKILL.md 看看它的结构，你就能理解 Skill 的本质：一段告诉 Agent "遇到这类问题时该怎么想、怎么做、用什么工具"的结构化指南。