@nodeskai/skillshub

SkillsHub CLI — 搜索、安装和发布 AI Agent Skills 的命令行工具。

安装

# 全局安装
npm install -g @nodeskai/skillshub

# 或直接通过 npx 使用（无需安装）
npx @nodeskai/skillshub <command>

快速开始

# 搜索 skills
skillshub search agent

# 安装 skill（默认安装到 ~/.openclaw/skills/<slug>/）
skillshub install free-ride

# 安装指定版本
skillshub install free-ride -v 1.0.0

# 安装到自定义目录
skillshub install free-ride -d ./my-skills/free-ride

# 查看当前登录用户
skillshub whoami

# 查看 skill 详情
skillshub inspect free-ride

# 列出本地已安装的 skills
skillshub list

命令一览

搜索

skillshub search <关键词>

在 SkillsHub 平台搜索 skills，返回名称、描述、下载量和收藏数。

安装

skillshub install <slug> [选项]

下载 skill 并自动解压到本地。默认安装到 ~/.openclaw/skills/<slug>/。

| 选项 | 说明 | |------|------| | -d, --dir <目录> | 安装到自定义目录 | | -v, --version <版本> | 安装指定版本（默认最新） | | --cwd | 安装到当前工作目录下的 <slug>/ |

查看详情

skillshub inspect <slug>

查看 skill 的详细信息，包括版本列表、文件、标签、下载量和收藏数。

查看当前用户

skillshub whoami

显示当前登录用户的 handle、昵称和角色。

本地管理

skillshub list              # 列出本地已安装的 skills（别名: ls）
skillshub list -d ./my-skills  # 指定 Skills 目录
skillshub uninstall <slug>  # 卸载本地 skill（别名: rm）
skillshub uninstall <slug> -f  # 跳过确认直接卸载
skillshub uninstall <slug> -d ./my-skills  # 从指定目录卸载

默认扫描 ~/.openclaw/skills/ 目录，可通过 -d 指定其他目录。

检查更新

skillshub outdated          # 检查所有已安装 skill 是否有可用更新
skillshub outdated -d ./my-skills  # 检查指定目录

批量比对本地版本与远端最新版本，列出有更新的 skills。

更新

skillshub update <slug>     # 更新指定 skill 到最新版本
skillshub update --all      # 更新所有有可用更新的 skills
skillshub update <slug> -d ./my-skills  # 更新到指定目录

发布

skillshub publish [目录]

将本地目录发布为一个 skill。目录下必须包含 SKILL.md 文件，且 frontmatter 中需包含 slug 和 version 字段。

SKILL.md 示例：

---
slug: my-awesome-skill
version: 1.0.0
displayName: My Awesome Skill
summary: 一个示例 skill
tags: example, demo
---

# My Awesome Skill

Skill 的详细说明...

同步

skillshub sync [目录]

比较本地 SKILL.md 的版本和远端版本，如果不一致则自动发布。适合 CI/CD 场景。

收藏

skillshub star <slug>      # 收藏
skillshub unstar <slug>    # 取消收藏

删除

skillshub delete <slug> [-f]

删除你发布的 skill。加 -f 跳过确认提示。删除后 slug 将保留 90 天。

Token 管理

skillshub token create <名称>   # 创建 API Token
skillshub token list             # 列出所有 Token
skillshub token revoke <id>      # 撤销 Token

认证

需要登录的命令（publish、sync、star、delete、token、whoami）需要先配置认证：

1. 在 SkillsHub 网站登录
2. 进入用户中心，创建 API Token
3. 在终端执行：

skillshub login <你的token>

Token 保存在 ~/.skillshub/config.json。

配置

默认连接 https://skills.nodeskai.com。如需切换到其他环境：

skillshub config --api-url https://your-server.com

License

MIT