npx skills 怎么用？Claude Code/Codex 技能包安装教程

第一次给 Claude Code 或 Codex 装 Skill，别急着复制一长串命令。更稳的顺序是先确认自己要装到哪里：只给当前项目用，还是让所有项目都能调用；只给 Claude Code，还是同时给 Codex。`npx skills` 的好处在这里，它把安装范围、目标 Agent 和具体 Skill 名称拆成参数，不用手动去找每个工具的技能目录。

先跑最小安装命令

README 里的基础示例是 `npx skills add vercel-labs/agent-skills`。这条命令适合做第一次验证：终端能访问 npm，npx 能拉起 skills CLI，目标仓库也能被解析。成功后再决定是否指定某个 Skill。失败时不要马上换仓库，先看报错属于网络、npm 权限、Node 环境，还是目标 Agent 没被识别。很多安装失败并不是 skills 本身的问题，而是本机环境没有准备好。

再指定 Agent 和 Skill

真正给 Claude Code 或 Codex 用时，重点看 `--agent` 和 `--skill`。比如只装前端设计相关 Skill，可以用 `--skill frontend-design`；只装给某个 Agent，可以加 `-a claude-code` 或对应目标。需要注意，README 示例里还支持 `--agent '*'` 和 `--skill '*'`，这类通配安装适合测试机，不适合工作目录。一次装太多，Agent 读到的说明变多，反而可能让任务判断变慢。

项目级还是全局级

默认项目级安装更适合团队：Skill 跟项目走，别人拉代码后能知道这个仓库依赖哪些 Agent 规则。`-g` 全局安装适合个人常用 Skill，比如写测试、查文档、前端审美检查。失败场景是把团队必须遵守的规范装到个人全局目录，换一台电脑或换一个同事就丢了。安装前先判断“这个技能是不是项目资产”，能少很多后续解释。

常见卡点怎么判断

如果命令卡在下载阶段，先看 npm 源和网络；如果能下载但没有安装到预期 Agent，回头检查 `--agent` 参数；如果提示找不到 Skill，通常是 `--skill` 名称不对，或者仓库里的 Skill 不在你以为的位置。还有一种情况容易误判：命令成功了，但 Claude Code 或 Codex 没按 Skill 做事。这时不要马上重装，先确认当前会话是否在对应项目目录里，目标 Agent 是否会读取项目级 Skill。

批量安装时也要谨慎。`--all` 看起来省事，但新手用它容易把不需要的 Skill 一起带进来。更稳的做法是先 `--list`，挑一两个最贴近任务的 Skill 装上，跑一次小任务验证，再决定是否扩展。安装教程最怕只给命令，不给判断标准；真正能减少返工的是知道什么时候不该装。

安装后怎么验收

装完不要只看终端没有报错。可以接着跑 `npx skills list` 看已安装项，再在 Claude Code 或 Codex 里发一个小任务，观察 Agent 是否真的读到了 Skill 的约束。比如前端 Skill 应该能主动提到组件状态、响应式和视觉检查；如果回答仍像普通聊天，说明安装位置、目标 Agent 或 Skill 名称可能没对上。安装教程到这里才算闭环。记录下成功命令也很重要，下次换电脑或给同事复现时，不必从聊天记录里翻旧步骤，也能减少重复排查。