Claude Code Skills 上手:安装官方示例,再把重复任务写成可复用技能

Skill 是包含说明、脚本和资源的目录。它的价值是把稳定的工作方式保存下来,让助手在合适任务中复用,而不是每次重新解释一长串要求。它也不等于额外权限:写进技能里的操作,仍须受到宿主工具、账户权限和用户授权约束。

先试官方示例

在已经可正常使用的 Claude Code 中,官方仓库给出的 marketplace 添加命令是:

1
/plugin marketplace add anthropics/skills

随后在插件浏览入口选择 anthropic-agent-skills,按需要安装示例包。仓库也给出直接安装命令:

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

如果目标是文档处理,对应的是 document-skills@anthropic-agent-skills。不要一次安装许多来路不明的包,再把输出变化都归因于模型;先用一个已知任务确认技能是否被识别。

用明确任务检验调用

安装后,在请求中点明目标与技能,例如让它按指定技能处理一份没有敏感内容的测试文档。检查输出是否真的符合约定结构;“我会使用某技能”的文字声明,不足以证明生成结果已经满足要求。

如果没有调用预期技能,先核对插件是否安装、任务是否符合技能描述,以及当前宿主是否支持该技能。Claude.ai、Claude Code 与 API 的接入方式不同,不能把一个产品的安装步骤直接套到另一个产品。

最小 SKILL.md 可以这样组织

官方说明中的基础格式是带有 name 与 description 的 Markdown。下面是一个原创的报告检查示例,可在官方模板基础上调整:

1
2
3
4
5
6
7
8
9
---
name: report-check
description: 当用户要求检查报告中的事实、来源和遗漏信息时使用。
---
# 报告检查
1. 先列出用户提供的事实与来源,不补写未核实的数据。
2. 检查日期、单位、结论与证据是否对应。
3. 输出已确认内容、需要补充的信息和具体修改建议。
4. 信息不足时明确标记未知,不把猜测写成已确认。

描述要写清楚什么时候用,正文要写清楚怎么做。与其堆砌几十条抽象形容词,不如给出一两个可判定的例子和明确输出要求。

用三组输入检查,而不是只看一个成功案例

第一组是正常输入:资料齐全,观察输出结构是否稳定。第二组故意缺少关键日期或来源,检查它是否指出缺口。第三组放入互相冲突的数据,检查它是否识别矛盾,而不是替用户编一个看似完整的答案。

涉及脚本的技能还应审查脚本来源、读取范围和写入行为。测试时使用可丢弃的文件副本,不让一个新技能直接修改唯一原件。

注意不同目录的许可证

官方仓库说明,许多示例采用 Apache-2.0;文档处理目录中的部分技能是 source-available,并不等同于开源许可。复制、改编或分发前应查看具体目录的许可证,不能把整个仓库统一称为随意可用的 Apache 项目。

Anthropic 官方 skills 仓库与安装说明