DeskHub
登录
← 返回文档中心

CLI 命令行工具

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

安装

全局安装后可直接使用 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（--org 搜索组织内技能）不需要
install <slug>安装 Skill 到 ~/.openclaw/skills/（--org 安装组织技能）不需要
inspect <slug>查看 Skill 详情（版本、文件、统计）不需要
list列出本地已安装的 Skills（别名: ls，-d 指定目录）不需要
uninstall <slug>卸载本地 Skill（别名: rm，-d 指定目录）不需要
outdated检查已安装 Skills 是否有可用更新（-d 指定目录）不需要
update <slug>更新指定 Skill（--all 更新全部，-d 指定目录）不需要
whoami查看当前登录用户需要
publish [dir]发布 Skill（--org 发布到组织，--visibility 设置可见性）需要
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 地址不需要
config --default-org <slug>设置默认组织不需要
config --clear-org清除默认组织不需要
rules match扫描当前项目特征，智能推荐匹配的 Rules（--cwd, --limit）不需要
rules install <slug>安装 Rule 到项目（--project-name 替换项目名，--skip-replace, -d）需要
rules publish [fileOrDir]发布 Rule（--org, --visibility, --slug, --name, --from-github）需要
rules list列出本地已安装的 Rules（别名: ls，-d 指定目录）不需要

安装 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

认证

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

  1. 在 DeskHub 网站登录你的账号
  2. 进入 用户中心，切换到 API Token 标签页，创建一个新 Token
  3. 在终端执行登录命令
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

# 发布到组织
skillshub publish --org my-company

# 发布为组织内部可见
skillshub publish --org my-company --visibility org_internal

Rules 管理

Rules 是 AI 编码助手的行为规则文件，包括 Cursor Rules（.cursor/rules/*.mdc）、AGENTS.md 和 CLAUDE.md。 CLI 支持智能匹配、一键安装和发布 Rules。

匹配推荐
# 扫描当前项目特征，推荐最相关的 Rules
skillshub rules match

# 指定项目目录
skillshub rules match --cwd /path/to/project

# 限制返回数量
skillshub rules match --limit 5
安装 Rule
# 安装到当前项目
skillshub rules install <slug>

# 安装时替换来源项目名为你的项目名
skillshub rules install <slug> --project-name my-project

# 跳过项目名替换
skillshub rules install <slug> --skip-replace

# 安装到指定目录
skillshub rules install <slug> -d ./my-project
发布 Rule
# 发布当前目录下的规则文件
skillshub rules publish

# 发布指定文件
skillshub rules publish .cursor/rules/my-rule.mdc

# 自定义 slug 和名称
skillshub rules publish --slug my-rule --name "My Rule"

# 从 GitHub 仓库导入规则
skillshub rules publish --from-github https://github.com/owner/repo

# 发布到组织
skillshub rules publish --org my-company --visibility org_internal
查看本地 Rules
# 列出当前项目已安装的 Rules
skillshub rules list

# 指定目录
skillshub rules list -d ./my-project

组织功能

CLI 支持在组织上下文中搜索、安装和发布技能。使用 --org 参数指定组织， 或通过 config --default-org 设置默认组织。 使用 --org 参数时需要先登录。

# 搜索组织内的技能
skillshub search agent --org my-company

# 安装组织内的私有技能
skillshub install internal-tool --org my-company

# 发布到组织（默认公开）
skillshub publish --org my-company

# 发布为组织内部可见
skillshub publish --org my-company --visibility org_internal

# 发布为私有（仅发布者和组织管理员可见）
skillshub publish --org my-company --visibility private

# 设置默认组织（之后无需每次传 --org）
skillshub config --default-org my-company

# 清除默认组织
skillshub config --clear-org

可见性级别

  • public — 所有人可搜索和下载（默认）
  • org_internal — 仅组织成员可搜索和下载
  • private — 仅发布者和组织管理员可见

同步

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

skillshub sync ./my-skill

配置

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

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

# 设置默认组织
skillshub config --default-org my-company

# 清除默认组织
skillshub config --clear-org