官方 Skill 逐项阅读示例：从 template-skill 开始

这页用一个最小模板练“怎么读 Skill”，不是教你安装。模板越小，越适合新手看清楚 Skill 的基本骨架。

这份模板有什么

Anthropic skills/template 目录里只有一个 SKILL.md。它展示了最小入口：一个名称、一个描述，以及正文说明区域。

可以把它当作“空表格”来读：它告诉你 Skill 至少需要表达什么，但还没有真正的任务流程、示例、风险边界和验证方法。

逐项阅读

1. name

模板里的名称是 template-skill。

你要判断：

• 名称是否小写、清楚、能表达用途。
• 名称是否太泛，例如 helper、tool、agent。
• 名称是否和目录、说明一致。

2. description

模板提示这里要写清楚 Skill 的作用，以及什么时候应该使用它。

你要判断：

• 它是否说明“适合什么场景”。
• 它是否说明“不适合什么场景”。
• 它是否太像广告语，无法指导模型触发。

好的 description 应该让模型知道何时加载这个 Skill。写得太宽，容易误触发；写得太窄，可能不会触发。

3. 正文说明区

模板正文只有“在这里插入说明”的占位含义。真正的 Skill 需要把任务拆成步骤、输入、输出、风险和验证。

你要补齐：

• 这个 Skill 要解决的具体任务。
• 使用前需要什么输入。
• 执行时分哪些步骤。
• 输出应该长什么样。
• 什么时候应该停止。
• 完成后怎么验证。

4. 缺失信息

最小模板没有 scripts、references、assets、测试、示例和风险说明。这不是问题，因为它只是模板；但真实 Skill 如果也缺这些信息，就要谨慎。

可复制阅读提示词

请帮我只读分析这个最小 Skill 模板。不要安装，不要运行命令。

模板链接：https://github.com/anthropics/skills/tree/main/template
访问日期：2026-06-16

请输出：
1. name 字段表达了什么
2. description 字段应该补什么，才能让模型知道何时使用
3. 正文说明区至少应该包含哪些部分
4. 如果我要把它改成“代码审查 Skill”，应该补哪些输入、步骤、输出和停止信号
5. 这个模板没有 scripts、references、assets，分别意味着什么
6. 新手不能从这个模板直接得出哪些结论

新手不能得出的结论

• 不能说“所有 Skill 都只有一个文件”。
• 不能说“有 SKILL.md 就安全”。
• 不能说“官方模板可以直接用于真实项目”。
• 不能说“description 随便写也能触发”。

成功标志

• 你能说出 name 和 description 分别负责什么。
• 你知道正文不是摘要，而是操作说明。
• 你知道模板缺少脚本，不代表真实 Skill 都没有脚本。
• 你能提出一个更完整 Skill 应该补哪些信息。

下一步

读完模板后，再看 官方 Skill 结构拆解。如果要看社区仓库，先用 Agent Skills 候选仓库筛选。

来源与日期

• 来源：anthropics/skills template、template SKILL.md。
• 分享日期：2026-06-16。
• 复测日期：2026-06-16。