nvwa-skill-cli

一个可发布到 npm 的最小 CLI。既支持把 zip 解压到指定目录，也支持从 8188 下载后委托 skills 做真正的 agent 安装。

功能

• 支持 install <zip-url-or-file>
• 支持 install-skillhub <skillId> [version] --base-url <8188>
• 自动下载 zip
• 自动解压
• 自动查找 SKILL.md
• 默认优先使用 SKILL.md 中的 name 作为安装目录名
• install-skillhub 会调用 skills add，把 skill 真正安装到 Codex/其他 agent 的 skills 目录

本地调试

在当前目录执行：

npm install
node bin/cli.js --help
node bin/cli.js install ./demo-skill.zip --target ./skills
node bin/cli.js install-skillhub 2062784556544692224 --base-url http://localhost:8188 -g
node bin/cli.js install-skillhub 2062784556544692224 1.0.0 --base-url http://localhost:8188 --agent codex,cursor -y

也可以用 npx 调试本地包：

npx . --help
npx . install ./demo-skill.zip --target ./skills
npx . install-skillhub 2062784556544692224 --base-url http://localhost:8188 -g
npx . install-skillhub 2062784556544692224 1.0.0 --base-url http://localhost:8188 --agent codex,cursor -y

命令

npx nvwa-skill-cli install <zip-url-or-file> [options]
npx nvwa-skill-cli install-skillhub <skillId> [version] [options]
nvwa-skill-cli install-skillhub <skillId> [version] [options]

参数

• install 命令参数
• --target <dir>：安装根目录，默认 ./installed-skills
• --name <dirName>：覆盖安装目录名
• --force：目标目录已存在时覆盖
• install-skillhub 命令参数
• --base-url <url>：install-skillhub 使用的 8188 地址，默认 http://localhost:8188
• --agent <agent>：要安装到的 agent；支持逗号分隔或重复传参；不传时默认安装到所有支持的 agent
• -g, --global：安装到全局目录；对于 Codex 即 ~/.codex/skills
• --copy：调用 skills add 时使用复制模式，不走 symlink
• -y, --yes：跳过 skills 的交互确认
• version：可选；不传时默认下载技能当前版本

示例

npx nvwa-skill-cli install https://example.com/demo-skill.zip
npx nvwa-skill-cli install ./demo-skill.zip --target ./skills
npx nvwa-skill-cli install https://example.com/demo-skill.zip --name self-improvement
npx nvwa-skill-cli install-skillhub 2062784556544692224 --base-url http://localhost:8188 -g
npx nvwa-skill-cli install-skillhub 2062784556544692224 1.0.0 --base-url http://localhost:8188 --agent codex,cursor -y
nvwa-skill-cli install-skillhub 2062785580131028992 --base-url http://172.23.64.1:8188 --agent codex -g -y

安装结果

• install：只是解压到指定目录，方便检查 zip 内容
• install-skillhub：下载后调用 skills add <临时目录>，会真正安装到 agent 的 skills 目录
• install-skillhub 不传 --agent 时，默认安装到所有支持的 agent
• install-skillhub --agent codex,cursor 这类写法支持一次安装到多个指定 agent
• 对 Codex 而言：
• 项目级安装默认落到 ./.agents/skills
• 全局安装 -g 落到 ~/.codex/skills

发布到 npm

1. 修改 package.json 中的 name，确认 npm 上未被占用
2. 按需要调整 version
3. 登录 npm：

npm login

4. 发布：

npm publish

如果后续需要 scoped package，可以改成：

{
  "name": "@your-scope/nvwa-skill-cli"
}

然后发布：

npm publish --access public