Skills 已经成为 Claude Code 中最常用的扩展点之一。它们灵活、易于创建，也很容易分发。

但这种灵活性也让人很难判断什么做法效果最好。什么类型的 skill 值得做？写好一个 skill 的诀窍是什么？什么时候该把它分享给别人？

我们在 Anthropic 内部已经广泛地将 skills 用在 Claude Code 上，活跃使用中的有数百个。这些就是我们在利用 skills 加速开发过程中总结出来的经验。

什么是 Skills？

如果你刚接触 skills，我建议先去读我们的文档，或者观看我们在 Skilljar 上新出的 Agent Skills 课程；这篇文章默认你已经对 skills 有一定了解。

我们经常听到一个误解：skills “只是 Markdown 文件”。但 skill 最有意思的地方在于，它们不只是文本文件，而是一个文件夹，里面可以包含脚本、资源、数据等，agent 可以发现、探索并操作这些内容。

在 Claude Code 中，skills 还具有多种配置选项，包括注册动态 hooks。

我们发现，Claude Code 里一些最有意思的 skills，都会有创造性地利用这些配置选项和文件夹结构。

Skills 的类型

在梳理完我们所有的 skills 之后，我们发现它们通常会落入几个反复出现的类别。最好的 skills 往往能清晰地归入其中一类；那些让人困惑的，通常横跨了多个类别。这不是一个最终定论式的清单，但它是一个不错的思考方式，能帮助你判断自己的组织内部是不是缺了某一类 skill。

1. 库与 API 参考

这类 skill 用来说明如何正确使用某个库、CLI 或 SDK。它们既可以面向内部库，也可以面向 Claude Code 有时难以处理好的常见库。这类 skill 通常会包含一个参考代码片段文件夹，以及一份 gotchas 清单，帮助 Claude 在写脚本时避开常见坑。

示例：

• • billing-lib —— 你的内部计费库：边界情况、易踩坑点等
• • internal-platform-cli —— 你的内部 CLI 封装器的每个子命令，以及何时使用它们的示例
• • frontend-design —— 让 Claude 更好地遵循你的设计系统

2. 产品验证

这类 skill 描述如何测试或验证你的代码是否正常工作。它们通常会与外部工具搭配使用，例如 playwright、tmux 等，用来执行验证。

验证类 skill 对于确保 Claude 的输出正确非常有用。值得让一位工程师花上一周时间，专门把你的验证类 skill 打磨到优秀水平。

可以考虑一些做法，例如让 Claude 录制自己输出结果的视频，这样你就能准确看到它测试了什么；或者在每一步对状态强制加入程序化断言。这类做法通常通过在 skill 中加入多种脚本来实现。

示例：

• • signup-flow-driver —— 在无头浏览器中跑通 signup → email verify → onboarding，并在每一步通过 hooks 断言状态
• • checkout-verifier —— 驱动结账 UI，使用 Stripe 测试卡，并验证发票最终确实进入了正确状态
• • tmux-cli-driver —— 用于交互式 CLI 测试，适合你要验证的对象需要 TTY 的场景

3. 数据获取与分析

这类 skill 会连接到你的数据与监控栈。它们可能包含带凭据的数据拉取库、特定 dashboard 的 id，以及常见工作流或数据获取方式的说明。

示例：

• • funnel-query —— “为了查看 signup → activation → paid，需要关联哪些事件”，以及实际包含规范 user_id 的那张表
• • cohort-compare —— 比较两个 cohort 的留存或转化，标记统计显著的差异，并链接到 segment 定义
• • grafana —— 数据源 UID、集群名称、问题 → dashboard 的查询映射表

4. 业务流程与团队自动化

这类 skill 会把重复性工作流自动化成一条命令。它们通常是相对简单的说明，但可能会对其他 skills 或 MCPs 有更复杂的依赖。对这类 skill 来说，把之前的结果保存在日志文件里，有助于模型保持一致性，并反思以往执行过的工作流。

示例：

• • standup-post —— 汇总你的工单跟踪器、GitHub 活动和之前的 Slack 内容，生成格式化 standup，只展示增量
• • create- -ticket  —— 强制执行 schema（合法枚举值、必填字段），以及创建后的工作流（提醒 reviewer、把链接发到 Slack）
• • weekly-recap —— 已合并 PR + 已关闭工单 + 发布记录 → 格式化周报帖

5. 代码脚手架与模板

这类 skill 会为代码库中特定功能生成框架样板。你可以把这些 skill 与可组合的脚本结合使用。它们尤其适合那种包含自然语言需求、无法只靠代码完全覆盖的脚手架场景。

示例：

• • new- -workflow  —— 为新 service/workflow/handler 生成脚手架，并带上你的注解
• • new-migration —— 你的 migration 文件模板，以及常见坑点
• • create-app —— 创建新的内部应用，并预先接好认证、日志和部署配置

6. 代码质量与评审

这类 skill 用来在组织内部落实代码质量要求并帮助做代码评审。它们可以包含确定性的脚本或工具，以获得最大的稳健性。你可能会希望把这些 skill 自动运行在 hooks 中，或者放进 GitHub Action 里。

示例：

• • adversarial-review —— 生成一个“新鲜视角”的 subagent 做挑刺评审，实施修复，并持续迭代直到问题只剩下 nitpicks
• • code-style —— 强制执行代码风格，特别是 Claude 默认做得不够好的那些风格要求
• • testing-practices —— 关于如何写测试、测试什么的说明

7. CI/CD 与部署

这类 skill 帮助你在代码库内获取、推送和部署代码。这些 skill 可能会引用其他 skill 来收集数据。

示例：

• • babysit-pr —— 监控一个 PR → 重试 flaky CI → 解决合并冲突 → 启用自动合并
• • deploy-  —— build → smoke test → 渐进式流量发布，并比较错误率 → 出现回归则自动回滚
• • cherry-pick-prod —— 独立 worktree → cherry-pick → 冲突解决 → 用模板创建 PR

8. Runbooks

这类 skill 以某个症状为输入（例如 Slack 线程、告警或错误签名），沿着多工具调查流程执行，并产出结构化报告。

示例：

• •  -debugging  —— 把症状映射到工具和查询模式，覆盖你最高流量的服务
• • oncall-runner —— 拉取告警 → 检查常见嫌疑项 → 格式化输出结论
• • log-correlator —— 给定一个请求 ID，拉取所有可能接触过它的系统中的匹配日志

9. 基础设施运维

这类 skill 执行日常维护和运维流程，其中有些会涉及破坏性操作，因此很适合通过 guardrails 加以保护。它们让工程师在关键操作中更容易遵循最佳实践。

示例：

• •  -orphans  —— 查找孤儿 pods/volumes → 发到 Slack → 观察期 → 用户确认 → 级联清理
• • dependency-management —— 你们组织内部的依赖审批流程
• • cost-investigation —— “为什么我们的存储/出口带宽账单突然飙升了”，附带具体 bucket 和查询模式