skills | 把技能安装到所有的 AI 助手

#skills #vibecoding #AI 

前言

AI 助手越来越多，你想让它们多会一点东西，麻烦也跟着来。Claude Code 认一套技能目录，Cursor 认一套，Codex 又认一套。同一个技能，装完这个助手，还得再给那个助手装一遍。技能少的时候还能忍，一旦装到十几个，你整天都在重复同一件事。

这篇要解决的就是这个具体麻烦。用 Vercel 开源的 skills，一行命令把同一个技能同时装进所有主流 AI 助手，之后查、更新、卸载也是统一操作。读完你会掌握这套命令的完整用法，从查、装、用，到改、删、建，最后避开通篇最容易踩的坑。

前提条件只有一个，Node.js 18 以上。不需要全局安装，npx 会在运行时临时拉包。

一个技能到底是什么

先把对象看清楚，后面才不乱。技能（Skill）本质上是一个文件夹，核心是里面那份 SKILL.md 文件。

SKILL.md 由两部分组成。开头是 YAML frontmatter，用两个 --- 夹住，里面 name 和 description 必填。后面是 Markdown 正文，写这套技能的完整流程、规则和示例。

装一个技能，就是把这样一份文件放进 AI 助手认得到的目录。之后助手遇到相关任务，会自动加载它。

有两个字段值得单独说。name 是整个技能的身份证，有命名规范，后面建技能那节细讲。description 是助手决定要不要加载这份技能的依据，它写清楚触发场景，比正文堆细节重要得多。因为助手启动时只预载所有技能的 name 和 description，只有判定某个技能相关，才会去读正文。

一个技能文件夹大概长这样。

my-skill/├── SKILL.md       # 必需，技能定义├── scripts/       # 可选，可执行脚本├── references/    # 可选，参考文档└── assets/        # 可选，模板、字体、图标等静态资源

为什么值得为装技能专门学一个命令行

看到这里你可能会问，各家助手自己就能装技能，直接复制到目录里不就行了，何必多学一个命令行。

这里的关键区别，在装一次和装很多次。手动装，一个技能你只在 Claude Code 里用，就放一份到它的目录；你要是同时用三个助手，同一个技能得复制三份，放三个地方。更新的时候，三个地方逐个改。技能数量一多，你维护的是一堆彼此不同步的副本，你根本不记得哪个助手用的是新版本，哪个还停在旧版。

skills 把这件事反过来。它的默认安装方式是软链，所有助手的目录都指向同一个源文件，源头只有一份。更新这一份，所有助手一起生效。这就是它存在的理由，它管的是那堆副本本身，让同步这件事不再需要你手动记。

它也有代价。多学一套命令，多一次 npx 启动的等待，Windows 上软链偶尔还出问题。所以它适合的场景很清楚，你同时在用两个以上 AI 助手，或者想让一个技能在多个助手间保持一致。只有一个助手、只装一两个技能，直接复制就行，别为它折腾。

这个判断想清楚了，后面的命令才有意义，它们都是在替你省掉那些重复的复制。

查，看看有什么可装的

装之前先找。skills 的搜索命令是 find，不带关键词是交互式搜索，fzf 那种风格，输关键词就直接搜。

# 交互式搜索npx skills find# 关键词搜索npx skills find typescript

想预览某个仓库里有哪些技能，用 add 的 --list，只列不装，方便安装前看清货架。

npx skills add vercel-labs/agent-skills --list

查已装技能用 list，别名是 ls，默认列项目和全局两处，可以用参数过滤。

# 列出所有已装技能npx skills list# 只看全局npx skills ls -g# 按 agent 过滤npx skills ls -a claude-code -a cursor

装，最核心的 add

安装用 add，别名 a。它认六种来源。

# GitHub 简写npx skills add vercel-labs/agent-skills# 完整 GitHub URLnpx skills add https://github.com/vercel-labs/agent-skills# 仓库里某个具体技能目录npx skills add https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines# GitLab URLnpx skills add https://gitlab.com/org/repo# 任意 git URLnpx skills add git@github.com:vercel-labs/agent-skills.git# 本地路径npx skills add ./my-local-skills

还能指定分支、标签，或者只装仓库里某一个技能。

npx skills add owner/repo#mainnpx skills add owner/repo#v1.2.0npx skills add owner/repo#main@skill-name

两个范围要分清。默认是项目级，装到 ./.claude/skills/ 这类目录，跟着 git 提交，团队共享。加 -g 是全局，装到 ~/.claude/skills/，跨项目可用。

安装时工具会问你用软链还是复制。推荐软链，各 agent 目录都链到同一份源文件，源头单一，更新方便。Windows 某些配置不支持软链，就加 --copy 强制复制。

常用参数组合有这些。

# 装单个指定技能npx skills add vercel-labs/agent-skills --skill frontend-design# 装多个技能到指定 agentnpx skills add vercel-labs/agent-skills --skill frontend-design --skill skill-creator -a claude-code -a cursor# 非交互式 + 全局，CI 友好npx skills add vercel-labs/agent-skills --skill frontend-design -g -a claude-code -y# 仓库所有技能装到所有 agentnpx skills add vercel-labs/agent-skills --all

名字带空格的技能，比如 Convex Best Practices，记得用引号包起来。

用，不安装先试一把

use 和 add 解析来源的方式一样，差别在落地。use 只把技能写到临时目录，把生成好的 prompt 打到屏幕，不污染项目，也不留全局痕迹。

# 生成 prompt，管道喂给 claudenpx skills use vercel-labs/agent-skills@web-design-guidelines | claude# 临时启动指定 agentnpx skills use vercel-labs/agent-skills --skill web-design-guidelines --agent claude-code

CI 里想用一把就走，不想留下安装痕迹，用 use 而不是 add。

改和删，更新与卸载

更新前先检查有没有新版。

# 检查是否有更新npx skills check# 更新全部npx skills update# 更新指定技能npx skills update frontend-design web-design-guidelines# 只更新全局或只更新项目级npx skills update -gnpx skills update -p# 非交互式更新npx skills update -y

卸载用 remove，别名 rm。

# 交互式选择要删的npx skills remove# 删除指定技能npx skills remove web-design-guidelines# 从全局删npx skills remove --global web-design-guidelines# 从特定 agent 删npx skills remove --agent claude-code cursor my-skill

remove --all 一把清空，跳过确认，用之前想清楚。

建，自己写一个技能

不想只装别人的，用 init 起头。

# 在当前目录创建 SKILL.mdnpx skills init# 在子目录创建npx skills init my-skill

name 的规范值得单独记。2 到 64 个字符，只允许小写字母、数字和连字符。Claude 生态严格要求 kebab-case，不能含下划线、点或连续连字符，也不能以下划线或连字符开头结尾。

最小可用版本长这样。

---name: my-skilldescription: 一句话说明这个技能做什么、什么时候触发---# My Skill当用户输入 XXX 时，按以下步骤执行：1. ...2. ...

description 最多 1024 字符，写好它比堆正文重要。这是助手判断是否加载技能的唯一依据。

几个顺手的环境变量

DISABLE_TELEMETRY=1 或 DO_NOT_TRACK=1 关闭匿名使用统计。INSTALL_INTERNAL_SKILLS=1 显示标记为 internal 的技能。GITHUB_TOKEN 能提高 GitHub API 的速率限制。CLAUDE_CONFIG_DIR 和 CODEX_HOME 自定义各自的配置目录。

例如关掉遥测再安装。

DISABLE_TELEMETRY=1 npx skills add owner/repo

一套完整的日常流程

把上面的命令串成一个循环，就是这个工具的日常用法。

# 1. 搜技能npx skills find "react performance"# 2. 预览仓库里有什么npx skills add vercel-labs/agent-skills --list# 3. 装到 Claude Code，项目级npx skills add vercel-labs/agent-skills --skill frontend-design -a claude-code -y# 4. 装到 Cursor，全局npx skills add vercel-labs/agent-skills --skill frontend-design -a cursor -g -y# 5. 查看已装npx skills list# 6. 定期更新npx skills update -y# 7. 不需要了就删npx skills remove frontend-design

最容易踩的坑

这几个坑我在整理命令时都核对过，属于第一次用必中招的类型。

首次运行会提示安装包。npx 第一次跑 skills 会问要不要装这个包，加 -y 跳过，CI 环境必须加，否则会卡住。

Windows 软链问题。默认安装方式是软链，Windows 某些配置不支持，加 --copy 改用复制。

名字带空格必须引号。--skill "Convex Best Practices"，否则 shell 会把名字拆成两个参数。

npx 每次拉最新版。想可重现，把版本号 pin 在 @ 后面，例如 npx skills@1.5.22 add ...。当前 npm 上的 latest 是 1.5.22，写的时候以实际版本为准。

--all 很激进。它把仓库所有技能装到所有 agent，还跳过确认，个人项目慎用，先 --list 看清再选。

快速回顾

把这条命令线记下来就够了。

• 查用 find 和 list，预览仓库用 add --list
• 装用 add，认六种来源，可指定分支、标签、单个技能
• 临时用 use，不落地不污染
• 改删用 check、update、remove
• 自建用 init，name 必须 kebab-case，description 写清触发场景
• 踩坑加 -y 和 --copy，名字带空格加引号