使用 vercel-labs skills 管理个人 AI 技能

先说结论:

vercel-labs/skills 是安装器,不是技能来源。

我的技能来源是:

text
/Users/liguwe/832/skills

这个仓库只放真正的 skill。

对应的仓库为: https://github.com/liguwe/skills

1. 我现在的分工

这件事只分三层:

  • 技能内容:我自己维护,放在 /Users/liguwe/832/skills
  • 安装工具:vercel-labs/skills,用 npx skills add 分发。
  • 使用方:Codex、Claude Code、Cursor。

不要再在 skills 仓库里混 rules、commands、MCP。

需要复用规则,就复制一句规则。

需要复用命令,就在对应工具里写一个命令。

需要 MCP,就按权限边界放到工具自己的配置里。

这些都不是 skill。

2. 为什么这样用

三个工具的目录不一样。

如果每个工具里都手动维护一份 skill,很快就会分叉。今天改 Codex,明天忘了 Claude Code,后天 Cursor 还是旧版本。

所以 skill 只改一个源头:

text
/Users/liguwe/832/skills/personal-blog-writing/SKILL.md

然后用安装器同步出去。

3. 当前安装命令

全量安装:

bash
npx skills add /Users/liguwe/832/skills \
  -g \
  -a codex \
  -a claude-code \
  -a cursor \
  --skill '*' \
  -y

检查有哪些 skill:

bash
npx skills add /Users/liguwe/832/skills --list

两个命令基本够用了。

4. 我需要记住的边界

skills 仓库只放真正的 skill,并且只放个人公开的 skills

判断标准很简单:目录里有 SKILL.md,它描述一个可安装、可复用的能力。

其他东西不要硬塞进去:

  • 项目规则留在项目里,比如 AGENTS.mdCLAUDE.md.cursor/rules/
  • 项目命令放到各工具自己的命令目录。
  • MCP 单独按权限边界配置,不和 skills 混放。

以前想把仓库外层扩成一个总入口,现在看是过渡想法。没必要。

复用不是非要建一套中间层。有时候一句话就够了。