说明
Claude Skills 是什么
技能就是装着 SKILL.md 的文件夹:frontmatter 决定「做什么、什么时候用」,正文写具体步骤。本文讲清文件结构、加载条件、安装与写法。
一句话定义
技能就是一个装着 SKILL.md 的文件夹。文件分两部分:
---
name: pdf
description: 读取、拆分、合并并填写 PDF 文件。当任务涉及 PDF 时使用。
---
# PDF
代理要执行的步骤、检查项与示例…
- frontmatter(
name/description)是元信息,description就是触发条件。 - 正文是流程:做什么、按什么顺序、检查什么。
- 需要时可以放脚本和素材,在正文里按相对路径调用。
Claude Code、Codex、Cursor 等代理会在需要时才加载技能,这正是说明文必须写准的原因。
代理怎么决定加载
代理拿你的请求去匹配 description。词汇对上了就加载,对不上就留在磁盘上。
失败通常只有两种:
- 描述太虚(「一个对文档有用的技能」)→ 永远匹配不上。
- 描述准确,但相邻技能更匹配 → 加载了别的技能。
所以装完先读描述,再用它的词汇提需求。
存放在哪
| 范围 | 路径 | 用途 |
|---|---|---|
| 个人 | ~/.claude/skills/<name>/SKILL.md |
所有项目通用 |
| 项目 | <project>/.claude/skills/<name>/SKILL.md |
只在当前仓库用 |
其他代理有自己的技能目录,CLI 会写到对应位置。
安装
npx skills add <owner>/<repo> --skill <name>
例如 npx skills add anthropics/skills --skill pdf。要指定代理就加 -a claude-code(或 -a cursor、-a codex)。详见安装指南。
自己写一个
- 只做一件事。 一件事做三样,三样都不会被触发。
- 写 frontmatter。
name用短横线命名,description写清「做什么 + 什么时候用」。 - 正文写成流程。 顺序、检查项、一个实例,不要写宣传语。
- 需要才加脚本,并用相对技能目录的路径引用。
- 测触发。 一个该触发的请求、一个不该触发的请求;误触发就先改描述。
发布前可以用SKILL.md 校验器检查结构。
技能 / MCP / 子代理
| 机制 | 给代理什么 | 何时加载 |
|---|---|---|
| 技能 | 方法(步骤与检查项) | 描述匹配时 |
| MCP 服务 | 连接(工具与数据) | 会话开始时 |
| 子代理 | 隔离(独立上下文) | 被委派时 |
| 斜杠命令 | 你主动调用的提示词 | 输入时 |
需要「访问」用 MCP,需要「方法」写技能。
Next
Keep reading
Community notes
Found a broken install? Know a skill we missed?
One line is enough: the skill name, what happened, and the command you ran. We read every note and fix the index.