Anthropic 官方 Agent Skills 标准:把规范、方法论和示例打包成一个可自动触发的 Skill

前言

给 agent 扩展能力,最终都落到一件事上:写一个 SKILL.md,告诉它某个任务该怎么做。难的不在写文件,而在知道规范长什么样、frontmatter 该放什么字段、description 怎么写才容易被触发、目录结构怎么组织、有哪些官方示例可以参考。每次都要从仓库里翻规范、翻模板、翻示例,既慢又容易漏掉关键约定。

下面介绍的这个 Skill,把这些知识预先打包好,放到 agent 的上下文里,任务匹配时自动激活。它是 Anthropic 官方 Agent Skills 仓库的 Marvis 适配版,由社区在 SkillHub 上发布。

这是什么

一句话定位:这是一个「关于 Skill 的 Skill」,用来在创建、审查、改进或评估 Agent Skill 时,给 agent 提供完整的规范、设计方法论和官方示例速查。

来源与维护:

  • 上游:Anthropic 官方仓库 github.com/anthropics/skills,以及开放标准站点 agentskills.io。
  • 本 Skill:Marvis 适配版,在 SkillHub 上以 @user_1a99cb00/anthropics-skills 坐标发布,版本 1.0.0,来源标记为 community,分类 ai-agent,标签 requires_api_key=false。

它解决的问题是:让 agent 在需要写 SKILL.md、定 skill 规范、设计触发词、组织目录结构、写 YAML frontmatter、做 skill 验证或发布到 marketplace 时,有一个可直接调用的权威参照,而不是临时去查文档。

覆盖范围

这个 Skill 的内容分四块,都能在上游资料里核对到。

1、Agent Skills 规范。对应 agentskills.io 上的 Specification。一个 Skill 本质上是一个文件夹,核心是其中的 SKILL.md,里面包含元数据(至少 name 和 description)以及给 agent 的指令;文件夹里还可以附带 scripts/、references/、assets/ 等资源。

2、设计方法论。核心是渐进式披露(progressive disclosure),按三层加载:

  • 发现(Discovery):启动时只加载每个 Skill 的 name 和 description,够判断是否相关。
  • 激活(Activation):任务匹配到某个 Skill 的描述时,才把完整的 SKILL.md 指令读入上下文。
  • 执行(Execution):agent 按指令执行,按需运行附带脚本或加载引用文件。

此外还覆盖领域变体模式等组织方式。

3、17 个官方示例技能速查。来自上游仓库的示例集,方向包括算法艺术、MCP 构建、前端设计、文档处理、品牌规范、skill 创建器等。上游仓库把这些示例归为 Creative & Design、Development & Technical、Enterprise & Communication、Document Skills 几类,其中 docx、pdf、pptx、xlsx 是 Claude 文档能力的底层实现,属 source-available 而非开源。

4、从零创建 + 发布 Skill 的完整工作流。涵盖创建、验证、发布到 marketplace 的步骤,配合上游的 /template 模板和 /spec 规范使用。

自动激活范围

这个 Skill 声明的触发场景是:设计、评估、创建、改进、审查 Agent Skill;写 SKILL.md;制定 skill 规范;skill 触发词设计;skill 目录结构;YAML frontmatter;渐进式披露;skill marketplace;agent 能力扩展;skill 模板;skill 验证;文档处理(Word/PPT/PDF/Excel)。

换句话说,凡是围绕「造 Skill」本身展开的任务,都命中它的激活条件。

安装与启用

这个 Skill 是社区在 SkillHub 上发布的适配版,安装入口在其 SkillHub 页面 https://www.skillhub.cn/skills/user_1a99cb00/anthropics-skills,以及对应的 API 地址 https://api.skillhub.cn/user_1a99cb00/anthropics-skills。具体的安装命令在本次抓取中未能从页面正文核实到,这里不臆造。

作为参照,上游官方仓库在 Claude Code 里的安装方式是把仓库注册为 Plugin marketplace,已从 GitHub 页面核实:

/plugin marketplace add anthropics/skills

然后安装对应插件:

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

这是上游仓库的方法,不是本 Skill 的安装方式,仅作对照。本 Skill 是否需要 API Key:不需要(requires_api_key=false)。

典型用法

来自上游资料的可复现示例:创建一个基础 Skill,只需一个文件夹加一个 SKILL.md,frontmatter 至少包含 name 和 description 两个字段,后面跟指令。上游 /template 给出的骨架是:

---
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

name 是 Skill 的唯一标识(小写、空格用连字符),description 要完整说明这个 Skill 做什么、什么时候用。这段骨架与本 Skill 覆盖的「YAML frontmatter + 目录结构 + 渐进式披露」知识点是对应的。

另一个可复现的用法:在 Claude Code 里装了上游插件后,直接用自然语言点名某个 Skill,例如「用 PDF skill 提取 path/to/some-file.pdf 的表单字段」。

适用场景与注意

适合谁:需要给 agent 扩展能力、要批量产出或审查 SKILL.md 的团队和个人;想把 Skill 规范和示例集中到一处、减少重复查文档的人。

需要注意的几点:

  • 本 Skill 是社区发布的 Marvis 适配版,不是 Anthropic 官方直接分发的包。上游官方仓库的示例 Skill 仅供演示和教育用途,实际行为可能与仓库所示不同,关键任务前要在自己环境里充分测试。
  • 它针对的是「造 Skill」这个元任务,不是用来直接完成文档编辑、前端开发等具体业务的 Skill。具体业务能力要看它速查的那 17 个官方示例。
  • 评分与下载量是动态数据,本次抓取到的是评分 100000、下载 1834、安装 0,与早期线索里的数值有出入,以 SkillHub 页面实时数据为准。
  • Skill 内容会随上游规范更新而变化,引用时以 agentskills.io 和 github.com/anthropics/skills 的当前版本为准。

结尾

这个 Skill 的价值在于把 Agent Skills 的规范、设计方法论、17 个官方示例和创建发布工作流收敛成一个可自动触发的参照,省去每次造 Skill 时重新查文档的成本。如果你正打算给 agent 写 SKILL.md 或制定团队的 skill 规范,可以从它入手。

官方地址:https://api.skillhub.cn/user_1a99cb00/anthropics-skills

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜