CLI 命令行工具

通过命令行搜索、安装和发布 AI Agent Skills。

安装

全局安装后可直接使用 skillshub 命令，也可以通过 npx 免安装使用。

# 全局安装
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

# 查看 skill 详情
skillshub inspect free-ride

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

命令一览

命令	说明	认证
`search <query>`	搜索 Skills	不需要
`install <slug>`	安装 Skill 到 ~/.openclaw/skills/	不需要
`inspect <slug>`	查看 Skill 详情（版本、文件、统计）	不需要
`list`	列出本地已安装的 Skills（别名: ls，-d 指定目录）	不需要
`uninstall <slug>`	卸载本地 Skill（别名: rm，-d 指定目录）	不需要
`outdated`	检查已安装 Skills 是否有可用更新（-d 指定目录）	不需要
`update <slug>`	更新指定 Skill（--all 更新全部，-d 指定目录）	不需要
`whoami`	查看当前登录用户	需要
`publish [dir]`	发布 Skill	需要
`sync [dir]`	同步版本到远端	需要
`star <slug>`	收藏 Skill	需要
`unstar <slug>`	取消收藏	需要
`delete <slug>`	删除 Skill	需要
`token create <label>`	创建 API Token	需要
`token list`	列出所有 Token	需要
`token revoke <id>`	撤销 Token	需要
`login <token>`	保存认证凭证	不需要
`config --api-url <url>`	设置 API 地址	不需要

安装 Skill

默认安装到 ~/.openclaw/skills/<slug>/，支持指定版本和自定义目录。

# 安装最新版本
skillshub install <slug>

# 安装指定版本
skillshub install <slug> -v 1.0.0

# 安装到自定义目录
skillshub install <slug> -d ./my-dir

# 安装到当前工作目录下
skillshub install <slug> --cwd

本地管理

管理本地安装在 ~/.openclaw/skills/ 下的 Skills。所有本地管理命令均支持 -d 参数指定自定义 Skills 目录。

# 列出已安装的 skills
skillshub list        # 或 skillshub ls
skillshub list -d ./my-skills  # 指定 Skills 目录

# 查看 skill 详情
skillshub inspect <slug>

# 查看当前登录用户
skillshub whoami

# 卸载本地 skill
skillshub uninstall <slug>       # 或 skillshub rm <slug>
skillshub uninstall <slug> -f    # 跳过确认
skillshub uninstall <slug> -d ./my-skills  # 从指定目录卸载

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

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

认证

发布、收藏、删除等操作需要先配置认证。按以下步骤操作：

在 DeskHub 网站登录你的账号
进入用户中心，切换到 API Token 标签页，创建一个新 Token
在终端执行登录命令

skillshub login sk-your-api-token-here

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

发布 Skill

发布前，你的目录下必须包含一个 SKILL.md 文件，其 frontmatter 中需要包含 slug 和 version 字段。

SKILL.md 示例

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

# My Awesome Skill

这里写 Skill 的详细说明...

# 发布当前目录
skillshub publish

# 发布指定目录
skillshub publish ./path/to/skill

同步

sync 命令会比较本地 SKILL.md 中的版本号和远端版本，如果不一致则自动发布。适合在 CI/CD 中使用。

skillshub sync ./my-skill

配置

CLI 默认连接 https://skills.nodeskai.com。如需切换到私有部署或开发环境：

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