夜雨聆风技能还得写两遍？
给 AI 助手装个共享技能生态
skills.sh · 77 个助手一码通行
SKILL.md · npx skills · find-skills · 跨工具兼容
AI 编程工具实战 · 公众号
本文看点 · READ MAP
01
skill 是什么加 77 助手共享
02
find-skills 加安装命令
03
挑靠谱加兼容差异表
装 Codex 那阵我顺手往它里头塞技能，又往 Claude Code 里头塞。塞到第三个我才烦，同一个技能写两遍，给 Codex 放一份给 Claude Code 放一份，改一次得改两处。我心想这帮 AI 助手各家各搞一套，技能互不相通，谁也用不上谁的，挺浪费。
后来撞见 skills.sh，Vercel 做的一个开放生态，一整套技能一次定义，一行命令装到 77 个 AI 编程助手里。Claude Code、Codex、Cursor 全共享。这篇把这个生态和我踩的坑讲清楚。
01
PART
skill 是什么，一句话
SKILL · 一个 md 文件
skill 就是一个 SKILL.md 文件，里面写一段可复用的指令，告诉你的 AI 助手这类活该怎么干。
它跟提示词模板的区别，在于它会被助手自动加载。你把 SKILL.md 放进助手的技能目录，助手启动时就把它读进上下文，下次干这类活自动按这套规矩来，不用你每次手敲提示。这跟 Codex 的 AGENTS.md、Claude Code 的 CLAUDE.md 一个路子，只是 skill 更碎、更专，一个技能管一类活。
SKILL.md 长这样，顶部一段 YAML frontmatter，必须有 name 和 description 两个字段，底下是正文。
---
name: code-review-checklist
description: 代码审查时按这套清单逐项过，重点关注边界条件和测试覆盖
---
# 代码审查清单
审查一个 PR 前先做这几步……
name 是技能名，description 是干啥用的。助手靠这两个字段判断什么时候用这个技能。正文写具体怎么做，跟普通 markdown 一样。
02
PART
77 个助手共享一个生态
SHARE · 一份 SKILL.md 装多处
skills.sh 这事最值钱的地方，不是单个技能写得多好，是它把 77 个 AI 编程助手拉到了同一套格式下。一个 SKILL.md，装到哪都认。
Vercel 的 skills CLI 是这个生态的包管理器，命令叫 npx skills。它自动检测你机器上装了哪些助手，检测到就往对应目录装，没检测到会让你选。
图 1 — 上半一份 SKILL.md 辐射多助手各自技能目录，下半 find→add→使用闭环，挑靠装量和官方源。
这是几个主流助手对应的技能目录。
| Claude Code | .claude/skills/ | ~/.claude/skills/ |
| Codex | .agents/skills/ | ~/.codex/skills/ |
| Cursor | .agents/skills/ | ~/.cursor/skills/ |
| GitHub Copilot | .agents/skills/ | ~/.copilot/skills/ |
| Gemini CLI | .agents/skills/ | ~/.gemini/skills/ |
注意 Codex 和 Cursor、Copilot、Gemini 的项目级目录都叫 .agents/skills/，是同一套。所以你在项目里装一个技能，这几个助手能共享同一份文件。Claude Code 单走 .claude/skills/，自己一份。
03
PART
find-skills，发现技能的元技能
FIND · 排行榜 + 装量 + 官方源
生态大了，技能多了，问题变成怎么找靠谱的。find-skills 就是为这个生的，它是个元技能，专门帮你发现和安装别的技能。
它的逻辑挺讲究。先查 skills.sh 的排行榜，找那些经过实战检验、装得多的热门技能，再去跑 CLI 搜索。推荐的时候看三样，安装量偏好 1K 以上、来源是不是官方（Vercel、Anthropic 这种）、GitHub star 多不多。这套标准比你自己一个个翻靠谱，毕竟群众装过的踩过雷的，比你自己蒙强。
发现靠 npx skills find，交互式搜，fzf 那种 fuzzy 风格。
npx skills find # 交互式搜，fzf 风格
npx skills find typescript # 按关键词搜
npx skills find react --owner vercel # 只搜某组织的仓库
装靠 npx skills add，从 GitHub 装，支持简写、完整 URL、本地路径。
npx skills add vercel-labs/agent-skills # GitHub 简写
npx skills add https://github.com/vercel-labs/skills --skill find-skills # 装单个
npx skills add vercel-labs/agent-skills -a claude-code -a codex # 只装到这两个助手
-a 指定装到哪个助手，不指定就装到它检测到的所有。-s 按名装某个技能，'*' 装全部。-g 装全局而非项目级。
装完管它，几个子命令。
npx skills list # 列出已装的技能
npx skills list -a claude-code # 只看 Claude Code 的
npx skills update # 更新所有技能
npx skills remove my-skill # 删一个
npx skills init # 在当前目录建个 SKILL.md 模板，写自己的技能
init 这个值得单独提。想自己写个技能，敲 npx skills init my-skill，它在子目录给你建一份 SKILL.md 脚手架，照填改就行。Anthropic 官方那个 skill-creator 也是干这个的，能测、能发布，更重一点。
04
PART
项目级还是全局，怎么选
SCOPE · 项目级 vs 全局
装的时候默认是项目级，装到 ./<助手>/skills/，跟着仓库走，团队共享。加 -g 装全局，~/<助手>/skills/，跨所有项目可用。
| 项目级（默认） | ./<助手>/skills/ | ||
| 全局 -g | ~/<助手>/skills/ |
！别一股脑全装全局 🕳
我自己这套分法，项目专属的规矩进项目级跟着 git 走，新人 clone 下来直接有。我个人偏好这种放全局，换个项目也带着。别一股脑全装全局，污染了每个项目的上下文，助手读一堆跟当前项目无关的技能，反而干扰判断。
05
PART
装之前怎么挑，别见就装
CURATE · 装量 + 官方源 + 审计
生态开放，谁都能发技能，难免有水的。装之前过一遍这几条。
先看安装量。find-skills 默认偏好 1K 以上，有群众基础。装个位数的小众技能，作者自己都没怎么用，你装了踩雷概率高。
再看来源。官方源优先，Vercel、Anthropic 这种，有团队维护。obra/superpowers 这种社区高 star 的也行，但要去看一眼最近还更不更新。那种一两年没动过的，慎装，SKILL.md 格式跟助手对不上是常事。
看 skills.sh 上有没有安全审计。每个技能页挂了 Agent Trust Hub、Socket、Snyk 几个审计结果，Pass 是好的，Warn 得自己看一眼 SKILL.md 里有没有乱来的指令。技能本质是一段会被助手自动执行的指令，装之前扫一眼正文，别装到会把你 key 发外网的活。
我自己的规矩，只装官方源或 1K 安装以上的社区源，装之前必扫一遍 SKILL.md 正文。麻烦点，但避坑。
06
PART
跨工具兼容性，别以为装了就全能用
COMPAT · 部分特性独有
一个技能装进 77 个助手，不代表 77 个都支持它的全部特性。有些高级特性是部分助手独有的，装之前心里有数。
| 基础技能 | |
| allowed-tools 限定工具 | |
| context: fork 派子上下文 | |
| Hooks 钩子 |
也就是说，你写个技能带 Hooks，装到 Codex 里，Hooks 那段不生效，Codex 看不懂。装到 Claude Code 才认。context: fork 更挑，只有 Claude Code 吃。基础技能没这烦恼，77 个都认。
挑技能的时候顺手看一眼它用了哪些特性，跟你常用的助手对不对得上。别装了个 fork 技能到 Codex 里，跑起来发现根本没分叉，还以为技能坏了。
///
PART
这套生态到底省在哪
TAKEAWAY · 别写两遍
省在别写两遍。以前给 Codex 写一份技能，给 Claude Code 再写一份，改一次动两处，迟早对不上。现在一份 SKILL.md，npx skills add 一行，几个助手同时有。
也省在别蒙着选。find-skills 那套排行榜加安装量加官方源的标准，比自己一个个翻仓库强。群众踩过雷的，你跟着踩的概率低。
更省在团队共享。项目级技能进 git，新人 clone 下来助手自动加载，不用口头交代「我们这套代码审查规矩是啥」。技能文件在那摆着，助手自己读。
一份 SKILL.md，77 个助手共享，别再写两遍
find 查靠谱的，add 一行装上，助手自动加载。
一句话，skills.sh 把 AI 编程助手从各搞一套拉到共享一套。你要是 Claude Code 和 Codex 都用，这生态值当你花半小时摸一遍。
关注 AI 编程工具的系统化使用，持续拆解 Agent 类工具的设计与落地。今晚敲一行 npx skills find，交互式翻一翻排行榜，挑个 1K 安装以上的官方技能装上。Claude Code 和 Codex 都用的话，-a claude-code -a codex 一起装，一次到位。装完进项目 npx skills list 看认没认上。
既然看到这里了，如果觉得有用，随手点个赞、在看、转发三连吧。
THANKS FOR READING