anthropics/skills · 上手攻略

是什么

anthropics/skills 是 Anthropic 官方维护的 Agent Skills 示例与规范仓库。所谓 "Skill"(在 Anthropic 体系里),是一个带 YAML frontmatter 的 Markdown 指令包:一个文件夹 + 一份 SKILL.md + 一组可选脚本/资源,Claude 在识别到任务匹配时会动态加载并执行它。

它对应着 agentskills.io 标准(README 顶部明确指出"这是 Anthropic 对 Agent Skills 标准的实现"),核心价值是:

  1. 演示:展示 Skills 系统能干什么——从艺术创作、UI 设计、企业品牌文档、文档生成(PDF/PPTX/DOCX/XLSX),到技术任务(MCP server 生成、Web 应用测试)。
  2. 规范:spec/agent-skills-spec.md 是 Agent Skills 标准的可执行定义。
  3. 模板:template/ 给出创建自定义 skill 的最小骨架。
  4. 插件市场:作为 Claude Code Plugin Marketplace 直接被消费。

仓库大部分内容 Apache 2.0,但 skills/docx、skills/pdf、skills/pptx、skills/xlsx 四个"驱动 Claude 文档能力"的 skill 是 source-available(仅作参考,不视为开源)——这是 Anthropic 生产环境在用的核心实现,值得看但要注意 license。

解决什么问题

模型在"通用对话"很强,但在公司内部流程 / 特定工具调用 / 品牌合规上经常翻车:同样的报表每次格式都不一样、生成的 PPT 跟品牌指南对不上、调企业内部 API 时拼错 schema……这些都不是"调更大模型"能解决的,而是指令可复现、工具可组合、知识可注入的问题。

Skills 解决的是:

  • 可复现:同一个 skill 在同一类任务上跑出来的结果高度一致。
  • 可分享:把"我们公司做季报"的流程打包成 skill,团队成员一键调用,无需每人重写 prompt。
  • 可注入上下文:Skill 加载时会把 SKILL.md + 关联资源注入到 Claude 的上下文,既不需要把整个公司手册塞 system prompt,也不需要 fine-tune。
  • 插件化:在 Claude Code 里以 /skill-name 或自然语言提及触发,可注册为 Plugin Marketplace。

快速安装

"安装"分两层:(a) 在 Claude Code 里把仓库注册为 Plugin Marketplace;(b) 在 Claude API 里通过 Skills API 上传自定义 skill。本文聚焦 (a),因为这是 README 主线。

最小可跑命令(Claude Code Plugin Marketplace)

# 0) 前置:已安装 Claude Code
#    curl -fsSL https://claude.ai/install.sh | bash        # macOS/Linux
#    irm https://claude.ai/install.ps1 | iex               # Windows PowerShell

# 1) 在 Claude Code 里执行,把这个仓库注册为 marketplace
/plugin marketplace add anthropics/skills

# 2) 进入 "Browse and install plugins" -> "anthropic-agent-skills"
#    选择 document-skills 或 example-skills,Install now

# 3) 或者直接装某个 plugin
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

# 4) 触发:在 Claude Code 会话里直接说
"Use the PDF skill to extract the form fields from path/to/some-file.pdf"

通过 Claude API 上传自定义 skill

参见官方文档 https://docs.claude.com/en/api/skills-guide#creating-a-skill。基本流程:POST /v1/skills 上传 skill zip(包含 SKILL.md + 资源),然后在 Messages 请求里 tools 引用。

创建一个最小自定义 skill(模板)

mkdir my-skill && cd my-skill
# 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 两个字段是必须的——name 用小写连字符,description 必须完整描述何时使用。

硬件 / 依赖:零本地依赖;跑通只需要 Claude Code 或可访问 Anthropic API 的环境。无 GPU 要求、无 Python/Node 版本要求。

核心用法

1) 浏览示例 skill 的组织方式

仓库 skills/ 下按四大类组织:

  • Creative & Design:艺术/音乐/品牌相关
  • Development & Technical:Web app 测试、MCP server 生成、frontend-design skill
  • Enterprise & Communication:沟通、品牌内部模板
  • Document Skills(docx / pdf / pptx / xlsx,source-available):文档生成与编辑的核心实现

每个 skill 自包含一个文件夹,带 SKILL.md + 可选 scripts/ / references/ / assets/。这是社区写 skill 的标准结构。

2) 在 Claude Code 里查看已加载的 skill

会话里直接 /skills 或问 Claude "what skills do you have?",Claude 会列出当前可用的 skill。

3) 触发 skill

两种方式:

  • 显式:Use the PDF skill to extract the form fields from path/to/some-file.pdf
  • 隐式:Claude 识别到任务匹配 description 时,会自动加载。

4) Skills vs CLAUDE.md / Hooks / Sub-agents(选型)

机制 何时加载 适合场景
Skill 按任务动态 一次性、可参数化的工作流(读 PDF、改 PPT、跑 MCP 生成)
CLAUDE.md 每会话开头 项目级长期规范(代码风格、架构决策)
Hook 事件触发(Pre/PostToolUse) 工具调用前后的强制动作(格式化、安全扫描)
Sub-agent 显式 spawn 复杂多步任务、需要独立上下文的并行工作

不要把"长期规则"塞进 skill——那是 CLAUDE.md 的活;也不要让 skill 变成"运行一次脚本"——那是 hook 的活。

5) Skills API(API 用户)

对 API 用户而言,skills 是 zip 包,经 POST /v1/skills 上传后,在 Messages 请求里通过 tools 字段引用。具体字段定义见 Skills API Quickstart,本文不复述。

典型适用场景

  • 企业内部流程模板:HR 入职、IT 工单、销售报价——把现有 SOP 改写成 skill,新员工上手直接"调用"。
  • 品牌一致的产出:PPT/Word/PDF 模板做成 skill,Claude 生成的文档自动套品牌指南。
  • 文档解析与改造:从 PDF 提取表单字段、按模板生成 xlsx 报表——尤其适合 pdf / xlsx 这种 source-available skill(直接在 Claude.ai 付费计划里也能用)。
  • MCP server 脚手架:Development & Technical 类里有现成的"生成 MCP server"skill,可作为快速起手点。
  • 前端设计与代码生成:frontend-design skill 强调"避开通用 AI 美学",做有设计感的 UI。
  • 自定义 Agent Skills 的教学示范:对想自己设计 skill 的团队,这是公开可读的范本库。

坑与注意

  1. 示例 skill 的"演示"性质:README 明说"These skills are provided for demonstration and educational purposes only... the implementations and behaviors you receive from Claude may differ"。生产前必须在自己的环境里完整测试,别直接当 SLA。
  2. Document Skills 是 source-available,非开源:Apache 2.0 不覆盖 docx/pdf/pptx/xlsx。要 fork / 商用嵌入这些实现,先看 license。
  3. name / description 是双闸门:description 写得模糊会导致 Claude 该用不用;写得宽泛会导致误触发。社区共识是 description 既要"做什么"也要"何时用"。
  4. Skill 不等于 fine-tuning:Skill 改变的是 Claude 的行为上下文,不改变模型权重。要"模型本身更擅长某任务",得 fine-tune 或 prompting 内化。
  5. Plugin Marketplace 命令依赖 Claude Code:/plugin marketplace add 是 Claude Code 的斜杠命令,不是 npm/yarn 子命令——README 里没强调,容易踩坑。
  6. Skills 与 MCP 的边界:MCP 是"工具协议",Skill 是"指令 + 可选工具"。很多 skill 自己也会调用 MCP server,但 skill 是更上层的封装。混用时,先想清楚"我需要的是工具调用,还是带上下文指令的工作流"。
  7. 没有 benchmark 数据:跟所有 prompt 工具一样,效果高度依赖任务与 description 写法;README 没给"使用 skill 比裸 prompt 提升多少 X%",本文不杜撰。

与同类对比

项目 形态 主要宿主 License
anthropics/skills Skills 示例 + 规范 + Marketplace Claude Code / Claude.ai / Claude API Apache 2.0(文档类 source-available)
HuggingGPT / AutoGPT Agent 框架(代码级) 自部署 多为 MIT
LangChain Hub Prompt Template Hub LangChain 生态 MIT
PromptLayer / Helicone Prompt 管理 + 观测 SaaS / 自部署 视层级而定

差异化:Skills 是"提示 + 资源 + 工具"的轻量封装单位,不绑死某个 agent 框架,跨 Claude Code / Claude.ai / API 一致;而且是 Anthropic 官方维护,SKILL 格式很可能成为跨厂商标准(agentskills.io 已经存在)。其它项目大多是"框架内的私有概念"。

一句话推荐结论

"Claude 时代的 Prompt Template Hub,但比 template 多一步:能附带脚本与资源并动态加载"——做企业内部流程、品牌一致产出、文档改造时强烈建议先翻这个仓库;要拿来当生产 SLA 直接用,务必先本地化测试。

源链接 / 引用