npx skills 是 Vercel 发布的 Agent Skills 管理工具，可以将开源仓库中的 skill 直接安装到项目或全局环境中，便于在不同项目中复用特定工具、框架或业务场景的使用经验。
本文以开源项目 unocss-preset-magicolor 为例，演示如何为该项目编写一个与工具使用相关的 skill，并在提交到主分支后，通过 npx skills 下载并安装到其他项目中使用。
编写 skill
这里借助 Codex 的 skill 创建能力进行开发，并描述该 skill 需要包含的内容与触发场景。
[$skill-creator] 在当前项目下创建skills文件夹，skills下创建一个名为“unocss-preset-magicolor”的skill:
- 该skill主要用于协助用户更好的使用unocss-preset-magicolor
- 可根据 [default.html](playground/src/template/default.html) 、 [uno.config.ts](playground/uno.config.ts) 、 [src](packages/presets/src/) 下的测试文件等使用方式分析用法
- 按照不同的用法拆分不同的references文件，用法进行可能覆盖所有情况
- skill的触发时机为用户当前项目使用了unocss且安装了“unocss-preset-magicolor”下，在使用到有关颜色的样式时，可触发调用该skill，根据用法编写有关颜色样式的代码
- skill的内容使用英文描述
通过上述描述，可以让 skill 围绕 unocss-preset-magicolor 的实际用法进行组织，例如从示例模板、UnoCSS 配置以及测试文件中提取典型使用方式，再按场景拆分为不同的 references 文件。这样在后续使用时，Agent 可以根据用户当前项目中的 UnoCSS 配置和颜色样式需求，更准确地调用对应的 skill 内容。
使用 npx skills 下载
将编写完成的 skill 提交到仓库后，在需要使用该 skill 的项目中执行以下命令，即可安装对应仓库下的指定 skill。
npx skills add nixwai/unocss-preset-magicolor --skill unocss-preset-magicolor
安装过程中可根据实际需求进行选择。安装成功后，项目中会出现刚刚生成的 skill，后续在处理与 unocss-preset-magicolor 相关的颜色样式代码时，就可以让 Agent 基于该 skill 提供更贴近项目用法的辅助。
npx skills 常用命令
除了安装指定 skill，npx skills 还支持安装仓库内的全部 skills，以及检查、更新和生成锁定文件等维护操作。
1. 安装技能
npx skills add <user>/<repo> # 安装仓库内所有技能
npx skills add <url> --skill <name> # 安装指定技能
如果一个仓库中包含多个 skills，可以直接使用 <user>/<repo> 的形式一次性安装全部技能；如果只需要其中某一个 skill，则可以通过 --skill <name> 指定名称进行安装。
2. 维护管理
npx skills check # 检查更新
npx skills update # 更新所有技能到最新 Commit
npx skills generate-lock --dry-run # 生成/预览锁定文件
在多个项目中复用 skills 时，可以定期使用 npx skills check 检查是否存在更新，再通过 npx skills update 同步到最新 Commit。若需要查看或生成锁定文件，可以使用 npx skills generate-lock --dry-run 先进行预览，便于确认更新内容后再应用到项目中。