skillhub CLI

一条命令安装已发布技能；未登录时走 public 安装接口，需鉴权的技能可先登录或传 Token：

skillhub install @acme/data-processor --registry https://你的平台
# 需鉴权时：skillhub auth login --username <u> --password <p> --registry https://你的平台

安装

生产环境推荐使用公司私有 npm registry 发布的 @hxskillhub/cli：

npm config set @hxskillhub:registry https://你的私有-npm-registry/
npm install -g @hxskillhub/cli

仓库内调试本地实现时，可直接走兼容脚本：

./scripts/skillhub --help

免安装快速使用（npx）

npx -p @hxskillhub/cli skillhub install sonoscli

如需覆盖默认 registry，可设置环境变量后再运行：

export SKILLHUB_URL=https://chat.huaxincem.com
npx -p @hxskillhub/cli skillhub install sonoscli

命令

skillhub install <package[@version]> [--registry <url>] [--token <jwt>] [--offline] [--force] [--allow-http]
skillhub list [--json]
skillhub search <keyword> [--registry <url>] [--limit <n>]
skillhub info <package> [--registry <url>]
skillhub versions <package> [--registry <url>] [--limit <n>]
skillhub remove <package> [--all-versions]
skillhub update <package[@version]> [--registry <url>] [--token <jwt>] [--allow-http]
skillhub publish <skillId> <zipPath> [--registry <url>] [--scan] [--release]
skillhub auth login --username <u> --password <p> [--registry <url>]
skillhub auth logout
skillhub auth whoami [--registry <url>]
skillhub cache clean [--all]
skillhub --help
skillhub publish --help

• --registry 指定后端地址（优先级最高）
• 未传 --registry 时，默认读取 SKILLHUB_URL
• 若 SKILLHUB_URL 未设置，则回退 SKILLREGISTRY_URL
• 两个环境变量都未设置时，使用内置默认：https://chat.huaxincem.com
• install / update 与鉴权：未传 Token 时访问 public 安装接口，只能安装已发布 Skill；传 Token 后访问鉴权接口，可安装需要权限的 Skill。Token 来源任选其一：
  • skillhub auth login ...（token 写入 ~/.skillhub/auth.json）
  • --token <access_jwt>
  • 环境变量（按顺序尝试）：SKILLHUB_TOKEN、SKILLREGISTRY_TOKEN、OPENCLAW_API_TOKEN
• --offline 仅使用本地缓存与 lock 文件
• --force 强制重装
• --allow-http 允许 HTTP 下载（仅开发环境）
• publish <skillId> <zipPath>：上传 zip 创建新版本（默认不自动发布）
• publish --scan：创建版本后先执行安全扫描
• publish --release：上传后继续发布 release

发布示例（publish）

先登录：

skillhub auth login --username <u> --password <p> --registry https://chat.huaxincem.com

仅创建版本（默认，更安全）：

skillhub publish 1001 ./sonoscli.zip --registry https://chat.huaxincem.com

创建后先扫描：

skillhub publish 1001 ./sonoscli.zip --scan

上传后立即发布：

skillhub publish 1001 ./sonoscli.zip --release

创建后先扫描再发布：

skillhub publish 1001 ./sonoscli.zip --scan --release

安装产物目录（默认）

• 缓存：~/.skillhub/cache
• 存储：~/.skillhub/store
• 激活：自动写入已安装 Runtime 的 Skill 目录
  • Hermes：~/.hermes/skills
  • OpenClaw：~/.openclaw/workspace/skills
• 锁文件：当前目录 skillhub-lock.json

激活目录可通过环境变量覆盖：

• HERMES_SKILL_INSTALL_DIR：仅覆盖 Hermes Skill 目录
• OPENCLAW_SKILL_INSTALL_DIR：仅覆盖 OpenClaw Skill 目录
• HERMES_HOME：覆盖 Hermes 根目录，默认根目录下使用 skills
• OPENCLAW_HOME：覆盖 OpenClaw 根目录，默认根目录下使用 workspace/skills
• SKILLHUB_ACTIVE_DIR：全局单目录覆盖；设置后只写入该目录

若 Hermes 或 OpenClaw 未安装，对应目录会被跳过，不影响 skillhub install 下载、缓存、存储与写锁文件。