npx skills 实测：一条命令给近 80 种 Agent 装 Skill

Claude Code 的 Skill 放 .claude/skills，OpenCode、Codex、Cursor 读 .agents/skills，全局目录又各不相同。同时用两三个 Agent，同一个 Skill 就得复制好几份，更新时还容易漏掉一份。Vercel Labs 的 npx skills 专门管这件事：一条命令装好，各家 Agent 都能读到。我们 10 月 21 日在机器上把它的常用命令都跑了一遍。

它是什么

一句话：给编程 Agent 装 Skill 的命令行工具。Skill 放进项目的 .agents/skills/，需要的 Agent 再软链过去。

解决什么问题

Skill 本身只是一个文件夹，里面是 SKILL.md 加几份参考资料，难的是分发。官方文档 docs/agents.md 列了几十种 Agent 的 Skill 目录：多数项目级用 .agents/skills/，Claude Code 用 .claude/skills/，全局目录几乎每家一个样。手动管理容易出三种问题：复制漏了某个 Agent；上游更新了自己不知道；队友装的版本跟你不一样。这个工具的处理办法是装一份实体，其余用软链；锁文件记下来源、路径和内容哈希；check/update 负责查更新。

适合的人：同时用几个编程 Agent 的开发者，以及想让全组用同一套 Skill 的团队。

怎么用

node -v                                   # 先确认 ≥ 22.20
npx skills add vercel-labs/agent-skills --list          # 只看仓库里有哪些 Skill
npx skills add vercel-labs/agent-skills \
  --skill web-design-guidelines -a opencode -a claude-code -y
npx skills list                           # 看装了什么、给了哪些 Agent
npx skills use vercel-labs/agent-skills@web-design-guidelines   # 不安装，只打印提示词
npx skills init my-skill                  # 生成 SKILL.md 模板
npx skills remove web-design-guidelines -y
export DISABLE_TELEMETRY=1                # 关掉匿名统计（默认开）

加 -g 装到用户目录，所有项目共用。来源可以是 GitHub 的 owner/repo、完整 Git 地址，也可以是本地路径。

实测：6 条命令，1 个硬门槛

环境：2026-10-21，Debian 13，skills 1.7.4，OpenCode 1.19.3。

• Node 20 直接报错退出。输出是 SyntaxError: The requested module 'fs/promises' does not provide an export named 'glob'。这个函数 Node 22 才有，报错里没提版本要求，第一次碰到容易以为是包坏了。从 nodejs.org 下了 22.23.3 的二进制包，放进 PATH 就好了，不用 sudo。
• add --list 克隆仓库后列出 vercel-labs/agent-skills 的 9 个 Skill，附各自的触发描述。
• 安装：实体在 ./.agents/skills/web-design-guidelines/SKILL.md，.claude/skills/ 下是一个指向它的软链，同时生成 skills-lock.json，里面记了来源、路径和 computedHash。list 显示这个 Skill 对 Claude Code、Codex、Cursor、OpenCode 都可见。
• Agent 认不认：在项目里运行 opencode debug skill，列表里出现了刚装的 Skill。拿本地路径装的 my-skill（复制模式）也认得出来。
• remove 会把实体、软链和锁文件里的记录一起清掉。
• find mcp 按安装量排序，第一条是微软的 azure-aigateway（55.9 万次安装）。同一页还有一个「anti-detect-browser」（反检测浏览器）Skill，13 万次安装。目录站收录的东西没人把关。

它帮你把 Skill 放到 Agent 能读到的地方，但不替你判断这个 Skill 安不安全。

还有个小细节：我们是在 Agent 环境里执行命令的，工具检测到之后提示「Agent detected — installing non-interactively」，自动跳过了交互式选择。在普通终端里会弹出多选菜单。

适合谁，不适合谁

想自己写一个 Skill，可以先看第一个 Agent Skill 教程。去 AI 味写作 Skill 那篇也是用这个命令装的。

最后

先确认 node -v 在 22.20 以上，再用 --list 看一个仓库里有哪些 Skill，挑一个装进当前项目，然后打开 SKILL.md 读一遍。