anthropics/skills 保姆级部署教程：Anthropic 官方 Agent Skills 技能标准仓库

一句话定位：Anthropic 官方维护的 Agent Skills（智能体技能）公共仓库——它定义了「技能」这一让 Claude 按文件夹动态加载指令、脚本与资源来完成专项任务的标准，并随仓库附带 19 个开箱即用的示例技能、一份技能模板和完整规范，是所有想给自己的 Claude 写技能的人绕不开的起点。

slogan：Skills are folders of instructions, scripts, and resources that Claude loads dynamically to improve performance on specialized tasks.

仓库地址：https://github.com/anthropics/skills · 许可证：Apache-2.0（部分文档技能为 source-available）· ⭐ 185,863

▲ 图 1：anthropics/skills 官方 README 顶部展示的 skills.sh 仓库徽章（官方截图）

一、项目简介

Anthropic 在 2025 年推出的 Agent Skills 是一套让 Claude「学会」专项任务的机制：把一个技能做成一个普通文件夹，里面放一份 SKILL.md（YAML 元信息 + Markdown 指令），再按需配上脚本、参考资料、模板等资源。Claude 在需要时动态加载这个文件夹，就像给它临时装上了一套「公司品牌规范」「数据分析师工作流」「个人待办自动化」之类的专属技能，而不是把所有东西都塞进系统提示词。

anthropics/skills 这个仓库就是 Anthropic 官方把这套机制公开出来的样板间：它既包含面向创意设计、开发测试、企业协作、文档生成的示例技能，也包含 spec/ 下的技能规范（现已迁移到 agentskills.io）和 template/ 下的技能模板。README 明确说明：仓库里的技能是演示与教育用途，部分能力在 Claude 产品里已可用，但具体行为可能因产品版本而异；其中 docx、pdf、pptx、xlsx 这四个文档技能正是驱动 Claude.ai 文档创建能力的底层实现，以 source-available 形式公开供开发者参考更复杂的技能长什么样。

对中文用户来说，这个仓库本身不需要「编译安装」——它就是一套 markdown 与脚本资产。真正的部署是把其中的技能目录接进 Claude Code、Claude.ai 或 Claude API 三种消费端之一，下文会逐条给出命令。

二、功能特点

三、环境要求

• 消费端任选其一：Claude Code（命令行/桌面端 CLI）、Claude.ai 付费计划、或可调用 Claude API 的开发环境。仓库本身只是 markdown 与脚本资产，不挑操作系统。
• Claude Code 插件方式：需要 Claude Code 已登录可用账号，能联网访问 GitHub 拉取插件市场清单。
• 自定义技能方式：本机有任意编辑器即可；要让技能里附带的脚本跑起来，按脚本自身的运行时要求（Python、Node 等）准备环境。
• 网络：能访问 GitHub 克隆仓库、能访问 Claude 官方服务端点即可。

四、保姆级部署步骤

4.1 方式一：Claude Code 插件市场安装（推荐）

在 Claude Code 里直接输入斜杠命令，先把本仓库注册为插件市场：

/plugin marketplace add anthropics/skills

然后交互式安装：输入 /plugin 打开插件面板，依次选 Browse and install plugins → anthropic-agent-skills → 选 document-skills 或 example-skills → Install now。

也可以跳过面板，直接在 Claude Code 里一条命令装好某个插件：

/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

安装完不用重启，直接在对话里点名调用即可，例如装好 document-skills 后说：

Use the PDF skill to extract the form fields from path/to/some-file.pdf

4.2 方式二：克隆仓库，把技能目录放进技能目录

如果你想自己挑技能、改技能，或者把它作为写技能的参考素材，直接克隆仓库（仓库地址见上方 blockquote 的超链接）：

git clone 仓库地址
cd skills
ls skills/

你会看到 19 个技能目录，每个目录里都有一份 SKILL.md。把整个目录复制到你的个人技能目录（Claude Code 识别 ~/.claude/skills/ 下的技能）：

mkdir -p ~/.claude/skills
cp -r skills/skill-creator ~/.claude/skills/
cp -r skills/mcp-builder ~/.claude/skills/

也可以放到项目级技能目录，只对当前项目生效：

mkdir -p .claude/skills
cp -r skills/brand-guidelines .claude/skills/

重启 Claude Code 后，Claude 会扫描这两个位置并按 SKILL.md 里的 description 自动决定何时加载。

4.3 方式三：Claude.ai 直接使用

本仓库的示例技能在 Claude.ai 付费计划里已经预置，不需要安装；如果你想上传自己的自定义技能，按官方帮助文档 Using skills in Claude 中的「上传自定义技能」步骤操作，本质就是把一个含 SKILL.md 的文件夹打成 zip 上传。

4.4 方式四：Claude API 接入

通过 Claude Skills API 可以把预置技能或自定义技能挂到 API 调用上，参考官方 Skills API Quickstart：把技能目录按规范打包上传，拿到技能 ID 后在 /v1/messages 请求里引用即可。

五、配置说明

每个技能的全部「配置」就是它自己目录里的 SKILL.md。最小可用的技能文件长这样：

---
name: my-skill-name
description: A clear description of what this skill does and when to use it
---

# My Skill Name

[这里写 Claude 在该技能被激活时遵循的指令]

## Examples
- Example usage 1
- Example usage 2

## Guidelines
- Guideline 1
- Guideline 2

frontmatter 里 name 必须是小写、用连字符分词、全局唯一；description 一定要写清楚「做什么 + 什么时候用」，因为 Claude 是靠这段文字判断何时触发这个技能的——写得含糊，技能就永远不会被加载。

技能目录里还可以放额外资源：脚本（scripts/）、参考文档（references/）、模板文件、图片等，Claude 在加载技能时会按需读取，不会一次性塞进上下文。

六、使用方法

装好技能后，日常使用完全是自然语言对话：你不需要记命令，只要在对话里描述任务，Claude 会根据 SKILL.md 的 description 自动判断是否加载对应技能；也可以主动点名，例如「用 brand-guidelines 技能帮我写一封对外邮件」「用 mcp-builder 技能生成一个 MCP server 骨架」。

想自己造技能时，直接调用仓库自带的 skill-creator 技能，它会带你走完「定目标 → 起草 SKILL.md → 写测试 prompt → 跑评测 → 按反馈迭代 → 优化 description 触发准确率」的完整循环，比从零手搓快得多。

查看技能规范：仓库 spec/agent-skills-spec.md 里只有一行跳转，现行规范托管在 agentskills.io/specification；新手上手建议先读 How to create custom skills 这篇官方帮助文章。

七、常见问题 FAQ

问一：这个仓库要 build 吗？要装 npm 包吗？
答：都不用。它是纯 markdown + 脚本资产仓库，没有构建步骤、没有 npm 包。你要么通过 Claude Code 插件市场注册它，要么直接 git clone 后把想要的技能目录复制进 ~/.claude/skills/ 或项目的 .claude/skills/。

问二：为什么我的自定义技能 Claude 总是不加载？
答：99% 是 description 写得太笼统。Claude 是按 description 决定是否触发的，要写清楚「这个技能解决什么具体问题 + 在什么场景下该用」，含糊的描述会让模型判断不该加载。仓库自带的 skill-creator 技能里有专门优化 description 触发准确率的流程。

问三：docx/pdf/pptx/xlsx 这四个文档技能和其他技能许可证一样吗？
答：不一样。仓库多数技能是 Apache-2.0 开源；但 docx、pdf、pptx、xlsx 这四个是驱动 Claude.ai 文档能力的底层实现，以 source-available 形式公开供开发者参考，不完全等同于开源协议，商用前请仔细阅读目录内的许可证条款。

问四：Claude.ai 里还要不要手动装这些技能？
答：付费计划已经预置了本仓库的示例技能，直接对话就能用；只有你想上传自己的自定义技能时，才需要按 官方文档 把技能文件夹打成 zip 上传。

问五：技能里附带的脚本安全吗？能直接执行吗？
答：README 的 Disclaimer 明确写了：这些技能仅作演示与教育用途，行为可能和 Claude 产品里的正式实现不同，在依赖它们处理关键任务前务必在自己环境里充分测试。技能目录里的脚本是给 Claude 调用的，你也可以人工审阅后再决定是否放行。

相关链接

• 项目仓库：anthropics/skills
• Agent Skills 官方规范站：agentskills.io / Specification
• 官方博客：Equipping agents for the real world with Agent Skills
• 什么是技能：What are skills?
• 在 Claude 中使用技能：Using skills in Claude
• 创建自定义技能：How to create custom skills
• Skills API 快速上手：Claude Skills API
• 合作伙伴技能示例：Notion Skills for Claude