一、这是什么
Agent Skills 是 Anthropic 开源的一套「技能」机制：技能就是一个文件夹，里面装着指令、脚本和参考资料，Claude 会在需要的时候动态加载它，按里面写好的固定流程帮你完成某一类具体任务。有了技能，Claude 不再是每次都凭感觉发挥，而是按你给的规矩、用你定的方法，一遍遍稳定地把活干好。
2026 年 11 月 10 日，Anthropic 的官方技能仓库 anthropics/skills 登上 GitHub 当日热门榜第 1 名，核实时已有约 19.1 万个 star，当日新增约 1,038 个，fork 约 2.24 万个。仓库创建于 2025 年 9 月 22 日，里面多数技能采用 Apache 2.0 开源协议。
这个仓库就是一套现成的技能示例，覆盖创意与设计、开发与技术、企业与沟通、文档处理四大类，共 19 个技能：做文档的有 docx、pdf、pptx、xlsx 四个技能（就是 Claude 官方文档功能背后用的那套）；搞开发的有前端设计（frontend-design）、网页应用测试（webapp-testing）、MCP 服务器生成（mcp-builder）；做创意的算法艺术（algorithmic-art）、画布设计（canvas-design）、主题工厂（theme-factory）；还有品牌规范（brand-guidelines）、内部沟通（internal-comms）、Slack 动图制作（slack-gif-creator）等。每个技能都自成一个文件夹，核心是一份 SKILL.md，开头是 YAML 元数据（名字和描述），下面是指令、示例和注意事项。
它适合这些人：每天用 Claude Code 写代码、写文档，想让它按固定流程出活的人；想把团队的工作规范（比如品牌要求、发版检查清单）变成 Claude 能直接执行的技能的人；以及对 AI 智能体扩展方式感兴趣、想亲手装一个技能、再自己写一个的人。
二、开始前先确认
- 先装好 Claude Code：技能是在 Claude Code 里用的，先按官方快速上手文档把 Claude Code 装好，装完执行
claude --version，能印出版本号就说明装好了。macOS 或 Linux 用户也可以用 Homebrew 安装，官方提供了claude-code与claude-code@latest两个 cask。 - 需要一个 Claude 账号：第一次启动 Claude Code 时会提示登录，可以用 Claude 订阅（Pro、Max、Team 或 Enterprise）、Claude Console 账号，或者支持的云厂商账号登录。技能本身是开源免费的，但运行 Claude Code 要按 Claude 的正常方式计费。
- 技能不是插件市场里的随便一个扩展：官方仓库本身就是一个 Claude Code 插件市场，装好市场里的
document-skills与example-skills两个插件，就能直接用仓库里的全部示例技能。 - Claude.ai 用户不用装：如果你用的是网页版 Claude.ai，付费计划里已经内置了这些示例技能，自定义技能也可以按官方支持文档上传，不用走下面的命令行步骤。
- 先看一眼再装：技能会让 Claude 按里面的指令和脚本执行，装第三方技能之前，先打开它的
SKILL.md看一眼内容，只装来源可信的技能。官方也在仓库说明里提醒：正式依赖某个技能之前，先在自己的环境里充分测试。
三、操作步骤
步骤 1：安装 Claude Code 并登录
按官方快速上手文档完成安装。macOS 或 Linux 用户用 Homebrew 安装时，执行：
brew install --cask claude-code装好后验证一下，执行：
claude --version能印出版本号，就说明安装成功。接着在终端输入 claude 启动 Claude Code，第一次使用时会提示在浏览器里完成登录，按提示操作即可。登录一次之后，以后就不用重复登录了；以后想换账号或重新登录，在会话里输入 /login。
图 1：在终端安装 Claude Code 并验证版本。图片为 AI 生成的操作示意图，实际界面以终端输出为准。
步骤 2：添加官方技能市场，安装两个技能插件
在 Claude Code 的会话里，先把官方技能仓库注册为插件市场，输入：
/plugin marketplace add anthropics/skills然后安装技能插件，有两种办法，任选一种：
办法一（菜单安装）：依次选择 Browse and install plugins → anthropic-agent-skills → document-skills 或 example-skills → Install now。
办法二（命令安装）：直接在会话里输入下面两条命令：
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills装好之后，document-skills 提供 docx、pdf、pptx、xlsx 四个文档技能，example-skills 提供其余的示例技能。安装完成后不用重启，回到会话里直接提需求就能用。
图 2：在 Claude Code 里添加技能市场并安装技能插件。图片为 AI 生成的操作示意图，实际界面以会话输出为准。
步骤 3：第一次使用技能——让 Claude 按技能流程干活
装好插件后，使用技能不需要记专门的命令，只要在需求里提到技能就行。比如想从一份 PDF 里提取表单字段，直接对 Claude Code 说：
Use the PDF skill to extract the form fields from path/to/some-file.pdf把 path/to/some-file.pdf 换成你自己的文件路径。Claude 收到后会自动加载 PDF 技能，按技能里写好的流程读取文件、提取表单字段，再把结果交给你。
同样的句式可以套到别的技能上：想让 Claude 按品牌规范出图，就提 brand-guidelines 技能；想让它测一遍网页应用，就提 webapp-testing 技能。描述越具体，技能触发得越准——在需求里写清楚你要处理的文件、想要的结果格式，Claude 就知道该加载哪个技能、按什么步骤做。
如果 Claude 没有按你预期的那样用技能，可以直接点名：「用 PDF 技能处理这个文件」，或者把需求里的触发词写得更明确。技能的描述（description）就是 Claude 判断「该不该用这个技能」的依据，描述写得越清楚，触发越可靠。
图 3：直接点名 PDF 技能，让 Claude 提取表单字段。图片为 AI 生成的操作示意图，实际界面以会话输出为准。
步骤 4：照着模板，写出属于你自己的第一个技能
会用之后，就可以自己写技能了。技能的写法很简单：一个文件夹，加一份 SKILL.md。仓库里自带了一份模板（template-skill），可以直接拿来当起点。
先把模板复制一份，改成你自己的技能名，比如 my-skill-name。然后打开里面的 SKILL.md，按下面的格式填写：
---
name: my-skill-name
description: A clear description of what this skill does and when to use it
---
# My Skill Name
[Add your instructions here that Claude will follow when this skill is active]
## Examples
- Example usage 1
- Example usage 2
## Guidelines
- Guideline 1
- Guideline 2开头 frontmatter 里只有两个必填字段：name（技能的唯一标识，用小写字母加连字符）和 description（写清这个技能是干什么的、什么时候该用它）。正文是指令部分：写清楚 Claude 启用这个技能后要按什么步骤做，配上两三个示例，再列出注意事项。
内容太多、一个文件装不下时，可以在技能文件夹里再加参考文件（比如 REFERENCE.md），在 SKILL.md 里引用它；需要跑代码的，还可以附上可执行脚本——官方的文档技能就是这么做的。
写好后测试一下：先自己检查描述是否准确反映了技能的用途、引用的文件是否都在文件夹里；再用几个应该触发它的需求试一遍，看 Claude 是否正确加载了技能；如果 Claude 该用的时候没用，就回头把 description 改得更具体，直到触发稳定为止。技能写得越聚焦越好：一个技能只管一类工作，多个小技能组合起来，比一个大而全的技能更好用。
如果你还想在 Claude.ai 或 API 里用技能：Claude.ai 付费计划已内置这些示例技能，自定义技能按官方支持文档上传；API 用户可以参考官方的 Skills API 快速上手文档，使用预置技能或上传自定义技能。
四、恢复办法
- 执行
claude提示找不到命令：Claude Code 没装好或安装目录不在 PATH 里。按官方快速上手文档重装一次；用 Homebrew 安装时确认装的是claude-code这个 cask；装完新开一个终端窗口再执行claude --version验证。 - 登录失败或提示没有权限：确认用的是 Claude 订阅、Console 账号或支持的云厂商账号；在会话里输入
/login重新登录一次。 /plugin marketplace add anthropics/skills报错：先确认 Claude Code 已登录且能正常联网；退出重进一次会话再试；也可以改用菜单方式（Browse and install plugins）添加。- 装了插件，Claude 却不用技能：先确认插件确实装上了（
document-skills或example-skills已在已安装列表里）；再直接在需求里点名技能，比如「用 PDF 技能处理这个文件」；如果还是不触发，检查技能的描述是否写清了触发场景，必要时改得更具体。 - 自己写的技能不生效：检查
SKILL.md开头的 frontmatter 是否有name和description两个必填字段，名字是不是小写加连字符；确认引用的参考文件和脚本都在技能文件夹里；用几个不同的需求多试几次。 - 不想用了：在 Claude Code 的插件管理里移除
document-skills或example-skills插件即可；自己写的技能文件夹直接删除，Claude 就不会再加载它。 - 想从头再来：卸载插件、删掉自己写的技能文件夹，再按步骤 2、步骤 4 重新装一遍，不留任何残留。
五、注意事项（必读）
- 技能本身免费，跑 Claude Code 要账号：仓库里的技能是开源免费的，但 Claude Code 需要 Claude 订阅、Console 账号或云厂商账号才能登录使用，按 Claude 的正常方式计费。
- 只装可信来源的技能：技能会让 Claude 按里面的指令和脚本执行，装之前先看一眼
SKILL.md的内容。官方也明确提醒：正式依赖某个技能之前，先在自己的环境里充分测试。 - 描述决定触发：Claude 靠技能的
description判断什么时候该用它。描述写得含糊，技能就时灵时不灵；写清「这个技能是干什么的、什么时候用」，触发才稳定。 - 一个技能只管一类事：技能越聚焦越好用。不要把十几件不相关的事塞进一个技能，拆成多个小技能，让 Claude 按需组合。
- 版本会变，以官方文档为准：技能仓库还在持续更新，个别技能的内容、安装方式可能调整。遇到与本教程不一致的地方，以仓库 README 与官方文档为准。
- 你的技能、你的规矩：技能最大的用处是把「你希望 Claude 怎么做事」写下来——团队的品牌规范、发版检查清单、写文档的固定格式，都可以变成技能，换台电脑、换个项目一样能用。
- Claude.ai 与 API 是另一条路：本教程以 Claude Code 为主；如果你主要用网页版或 API，技能同样能用，只是入口不同，见官方支持文档与 Skills API 快速上手文档。
六、官方资源链接
七、常见问题
Agent Skills 是免费的吗？
仓库里的技能是开源免费的，多数采用 Apache 2.0 协议。但在 Claude Code 里使用它们，需要先登录 Claude（订阅、Console 账号或云厂商账号），按 Claude 的正常方式计费。
一定要装 Claude Code 才能用技能吗？
不一定。Claude.ai 付费计划已经内置了这些示例技能，自定义技能也可以上传使用；API 用户可以通过 Skills API 使用预置技能或上传自定义技能。本教程讲的是 Claude Code 里的用法。
技能和平时给 Claude 的提示词有什么不同？
提示词是一次性的，换个会话就没了；技能是写下来的固定流程，放在文件夹里反复用。技能里除了指令，还可以带参考文件和可执行脚本，Claude 需要时才动态加载，不占每次对话的上下文。
仓库里一共有多少个技能？
核实时共 19 个，分为创意与设计、开发与技术、企业与沟通、文档处理四类，其中 docx、pdf、pptx、xlsx 四个文档技能就是 Claude 官方文档功能背后用的那套。
我自己写的技能能分享给别人吗？
能。技能就是一个文件夹，别人拿去就能用；如果按 agentskills.io 的开放标准来写，还能在支持这个标准的其他平台上通用。
装了插件但 Claude 不用技能怎么办？
先确认插件已安装，再直接在需求里点名技能；如果还是不触发，检查技能的描述是否写清了触发场景，改得更具体，或者查看 Claude 的思考过程确认它是否加载了技能。
技能会不会访问我的文件、替我执行操作？
会的——技能里可以带脚本，Claude 按技能指令运行时可能读取文件、执行命令。这正是装技能前要先看一眼 SKILL.md 内容、只装可信来源技能的原因；重要操作前，先在自己的环境里测试。
