Claude Code Skills:装好、生效、自己写

先搞清三件事:装在哪、怎么生效、何时要重开

Claude Code 的「技能」(Skills)本质就是一个文件夹加一个 SKILL.md 文件:文件夹给技能起名,SKILL.md 写清楚「遇到这类任务,按什么流程做、做到什么标准算完」。把它想成一本塞给 Claude 的操作手册——里面不是代码,是流程和验收标准。

生效的位置就一句话:文件放对目录。以 Claude Code 为例,放项目里的 ./.claude/skills/<技能名>/SKILL.md,当前项目生效;放用户目录的 ~/.claude/skills/<技能名>/SKILL.md,所有项目都能用。Cursor 和 Codex 也有各自的放法,后面会提到。

放好之后,先别急着在当前会话里试。Claude Code 的上下文窗口会越用越满,旧会话里它未必有余力处理新装的文件;所以建议直接重开一个干净会话再试,这是排除「装了没生效」最快的一步。重开后,用它的触发方式来调:以 Lathe 为例,输入 /lathe 开头的提示词;自己写的技能,直接用一句话吩咐即可。

路径一:装现成的技能包(以 Lathe 为例)

想先体验一整套别人做好的技能,目前最省事的例子是开源项目 Lathe。它把「生成动手型多步骤教程」打包成一套技能:装好后,你在 Claude Code(或 Cursor、Codex)会话里输入一句:

/lathe build a 3D Slicer in Erlang

它就会生成一套带步骤的教程并存入本地;你在终端里跑 lathe serve,浏览器会打开一个教程库,可以照着教程自己动手一关一关做。Lathe 是第三方开源项目,不是 Anthropic 官方出品,但它的安装流程恰好把「技能装到哪、怎么生效」完整演示了一遍。

安装分两步。第一步装 lathe 本体,macOS 用 Homebrew 一行:

brew install devenjarvis/tap/lathe

Linux 没有现成安装包(官方 Homebrew 渠道只分发 macOS 版),用安装脚本 curl -sSf https://raw.githubusercontent.com/devenjarvis/lathe/main/install.sh | sh,或者 go install(需要 Go 1.25 以上)。

第二步,把它自带的技能放进 Claude Code 能发现的目录:

lathe skills install          # 装进当前项目
lathe skills install --user   # 装进用户目录,之后所有项目都可用
lathe skills list             # 查看装好的技能

想让 Cursor 和 Codex 也用,装的时候加 --agent all(Cursor 会装成 .cursor/commands/ 下的斜杠命令,Codex 跟 Claude Code 共用 SKILL.md 格式)。装完照旧:重开会话,再输入上面的 /lathe 提示词。这些命令是项目仓库里给出的原样;第三方工具迭代快,动手前先去仓库扫一眼最新写法。

路径二:自己写一个技能,模板直接抄

自己写技能的「安装」更简单:建一个文件夹,里面放一个 SKILL.md,放进上文说的目录,重开会话,完事。难的是把 SKILL.md 写好。我的个人经验是,一份好技能至少写清三件事:目标、步骤、验证标准。下面这份可以直接复制改改:

---
name: draft-check
description: 文章定稿前做最后一次清单检查,逐项给出通过或失败
---

# 文章定稿检查

## 目标
把一篇文章改到「可直接发布」的标准,输出一份逐项结论。

## 步骤
读取指定文章。
按「检查清单与通过标准」逐项核对,报告每一项的结论(通过或失败)。
有失败项时,指出具体位置和修改建议。

## 检查清单与通过标准
标题不超过 20 字:直接数标题字数判断。
导语不超过 50 字:数完给结论。
全文不含「第一」「最」「绝对」等无依据的绝对化用词:逐个搜索这些词。
正文里的数据都标注了「截至某年某月」:检查每个年份是否带日期语境。
以上全部通过,才算定稿。

## 验证
最后必须以「PASS: 全部通过」或「FAIL: 第 x 项未通过 + 原因」的格式收尾,不要写「改得差不多了」。

这个模板最关键的是最后两节:检查清单把每一项写成「能直接判断对错」的标准,而不是「写得好一点」这种模糊要求;验证一节强制 Claude 用 PASS/FAIL 收尾。官方点破过这么一句:Claude 默认在「看起来做完了」的时候就会停下来。你不给它一个能自己判断 pass/fail 的检查,它就不会迭代到真正合格,于是你成了唯一的质检员。官方给的经典例子是:让 Claude 写一个校验邮箱的函数时,别只丢一句「写一个 validateEmail 函数」,而是附上测试用例(user@example.com 为真、[email protected] 为假),并让它跑完测试再交——把标准和验证写进文件,它自己就会把事情做完。

三个让技能好用的原则

一个技能只做一件事。 Anthropic 官方盘点过团队内部的所有技能,归成九类;结论是最好用的技能干净利落地落在某一类里,贪多求全的会横跨好几个类别,反而把智能体搞糊涂。九类中官方展开讲过四类:库与 API 参考(讲清某个库、命令行工具怎么用、有哪些坑)、产品验证(怎么测试和验收,常配合 Playwright、tmux 这类工具)、数据抓取与分析(接数据与监控栈,比如查转化漏斗、对比样本组)、业务流程与团队自动化(把重复工作流缩成一个命令)。写完技能后对照一下:它属于哪一类?是不是想塞太多事了?

验证比步骤更值钱。 Anthropic 官方博客在复盘内部技能时说,验证类技能对 Claude 输出质量的影响最可测。别把技能写成「步骤说明书」就收工,把精力花在「做到什么标准算过」上,回报最大。

技能本身也要省上下文。 Claude Code 最核心的约束是:上下文窗口很快就满,而一旦变满,性能就开始下降。技能是给 Claude 读的操作手册,写得越聚焦,留给真正要处理的代码和数据的空间就越多。

最后一句

整套流程抽出来就三步:SKILL.md 放进 skills 目录、重开会话、把验证标准写进文件。Lathe 会变、命令会改,这三步是这套机制里不变的部分。记住它们,任何技能你都能装好、用好。