feat: SkillHub CLI — Agent Skills 包管理工具

[Rsweater]

feat(skillhub-cli): SkillHub CLI — Agent Skills 包管理工具

Summary

skillhub-cli 是 SkillHub 的命令行工具，基于 clawhub、skills 开发，用于发布、搜索、安装和管理 Agent Skills。现有issue中提到的命名空间、版本等问题均已解决，另外添加交互式引的搜索、安装skill等。

主要特性

特性	说明
多源安装	支持从 Registry、Git 仓库、本地路径安装 Skills
交互式体验	TUI 搜索、多选菜单、安装确认
多 Agent 支持	自动检测已安装的 Agent，支持指定安装目标
版本管理	支持指定版本、Tag 安装，版本锁定文件
完整工作流	发布、同步、评分、收藏、通知等

---

技能中心注册

# 临时方案
export SKILLHUB_REGISTRY=http://<skillhub-ip>:<backend-port>      # Linux
set SKILLHUB_REGISTRY=http://<skillhub-ip>:<backend-port>            # CMD
$env:SKILLHUB_REGISTRY="http://<skillhub-ip>:<backend-port>"      # PowerShell

# 长期方案
# Linux
vim ~/.skillhub/config.json      #默认 http://localhost:8080
# CMD
setx SKILLHUB_REGISTRY "http://<skillhub-ip>:<backend-port>"
# PowerShell
[System.Environment]::SetEnvironmentVariable("SKILLHUB_REGISTRY", "http://<skillhub-ip>:<backend-port>", "User")

命令速查表

认证

skillhub login --token <TOKEN>      # Token 登录
skillhub logout                     # 登出
skillhub whoami                     # 查看当前用户
skillhub whoami --json              # JSON 输出

搜索发现

# 浏览/搜索 skills（主命令）
skillhub explore [query]              # 交互式浏览搜索
skillhub explore <query> -n 20     # 指定结果数

# 别名
skillhub search <query>            # explore 的别名
skillhub find <query>                # explore 的别名
skillhub find-skills <query>       # explore 的别名

# 命名空间
skillhub namespaces                  # 列出有权限的命名空间

# 查看详情
skillhub inspect <slug>              # 查看 skill 详情（别名: info, view）
skillhub inspect <ns/slug>         # 指定命名空间
skillhub inspect <slug> --namespace <ns>

# 版本列表
skillhub versions <slug>            # 列出所有版本
skillhub versions <ns/slug>        # 指定命名空间

# 解析版本
skillhub resolve <slug>             # 交互式选择 (如在不同空间有同名skill)
skillhub resolve <ns/slug>        # 指定命名空间
skillhub resolve <slug> --skill-version <ver>   # 指定版本
skillhub resolve <slug> --tag <tag>             # 按 tag 解析
skillhub resolve <slug> --hash <hash>            # 按内容 hash 解析

安装管理

# install - 从 registry 安装
skillhub install <slug>                     # 默认 global namespace
skillhub install <ns/slug>                  # 指定 namespace
skillhub install <slug> --namespace <ns>    # 同上
skillhub install <slug> --skill-version <ver>    # 指定版本（非交互）
skillhub install <slug> --tag <tag>              # 指定 tag（非交互）
skillhub install <slug> --copy                   # 复制模式
skillhub install <slug> --global                 # 全局安装
skillhub install <slug> -y                       # 跳过确认
skillhub install <slug> --agent <agents...>      # 指定 agents
skillhub install <slug> --list                  # 只列出不安装
skillhub i <slug>                              # 别名

# install - 从 GitHub/Local 安装（使用 --from/-a）
skillhub install <name> --from <git-url>         # Git source
skillhub install <name> --from <local-path>      # Local source
skillhub install <name> --from ./my-skill        # 相对路径
skillhub install <name> --from /path/to/skill    # 绝对路径
skillhub install <name> --from github:owner/repo # GitHub 简写
skillhub install <name> --from ~/.agents/skills  # 展开 tilde 路径
skillhub install owner/repo                     # 自动检测为 git

# list - 已安装列表
skillhub list                      # 列出所有已安装（交互式选择 scope 和 agents）
skillhub list --global             # 只显示全局
skillhub list --project           # 只显示项目级
skillhub list --all               # 显示全部
skillhub list --agent <agents>    # 按 agent 过滤
skillhub ls                       # 别名

# uninstall - 卸载
skillhub uninstall <name>                        # 交互式选择 agent
skillhub uninstall <name> --all                 # 从所有 agent 卸载
skillhub uninstall <name> --global               # 卸载全局
skillhub uninstall <name> --agent <agents...>    # 指定 agents
skillhub uninstall <name> -y                    # 跳过确认
skillhub un <name>                              # 别名

# update - 更新
skillhub update <slug>              # 更新指定 skill
skillhub update --all              # 更新全部
skillhub update --global           # 更新全局
skillhub up <slug>                 # 别名

# check - 检查
skillhub check                         # 交互式：选择 scope → agents → statuses                           
skillhub check --global            # 检查全局                                                         
skillhub check --local             # 检查项目                                                         
skillhub check --all               # 检查所有 scope                                                   
skillhub check --agent "Claude Code" --agent Cline    # 只检查特定 agents                             
skillhub check --status ok --status missing          # 只显示 OK + Missing                            
skillhub check --json              # JSON 输出

# download - 下载
skillhub download <slug>                            # 下载 skill 包
skillhub download <ns/slug>                        # 指定命名空间
skillhub download <slug> --skill-version <ver>     # 指定版本
skillhub download <slug> --tag <tag>               # 按 tag 下载
skillhub download <slug> --output <dir>            # 指定输出目录

发布

skillhub publish [path]                        # 发布 skill
skillhub publish [path] --namespace <ns>       # 发布到指定 NS
skillhub publish [path] -v <ver>              # 指定版本（semver）
skillhub publish [path] --tag <tags>           # 指定标签（逗号分隔）
skillhub publish [path] --name <name>          # 指定显示名
skillhub publish [path] --changelog <text>    # 添加更新日志

skillhub sync [path]                          # 批量发布目录中所有 skills
skillhub sync [path] --namespace <ns>         # 发布到指定 NS
skillhub sync [path] --all                    # 包含所有（即使有变更）
skillhub sync [path] -y                       # 跳过确认

skillhub init [name]                          # 创建 SKILL.md 模板

skillhub archive <slug>                       # 归档 skill
skillhub archive <slug> --namespace <ns>      # 指定命名空间
skillhub archive <slug> -y                    # 跳过确认

社交

skillhub star <slug>                    # 收藏 skill
skillhub star <slug> --namespace <ns>    # 指定命名空间
skillhub star <slug> --unstar            # 取消收藏

skillhub rating <slug>                   # 查看评分
skillhub rating <slug> --namespace <ns>  # 指定命名空间
skillhub rate <slug> <score>             # 评分（1-5 分）

skillhub me skills                       # 我的发布
skillhub me stars                        # 我的收藏

skillhub notifications list              # 通知列表
skillhub notifications list --unread     # 只显示未读
skillhub notifications read <id>        # 标记已读
skillhub notifications read-all          # 全部已读
skillhub notif list                      # 别名

skillhub reviews my                       # 我的审核提交
skillhub reviews submissions             # 别名

skillhub report <slug>                   # 举报 skill
skillhub report <slug> --reason <reason> # 指定原因

管理

skillhub delete <slug>                    # 删除 skill（需 owner）
skillhub delete <slug> --namespace <ns>   # 指定命名空间
skillhub delete <slug> -y                 # 跳过确认
skillhub del <slug>                       # 别名
skillhub unpublish <slug>                 # 别名

skillhub transfer <namespace> <newOwnerId>  # 转移所有权
skillhub transfer <namespace> <newOwnerId> -y  # 跳过确认

skillhub hide <slug>                      # 隐藏 skill（admin）
skillhub hide <slug> --namespace <ns>      # 指定命名空间
skillhub hide <slug> -y                    # 跳过确认
skillhub hide unhide <slug>                # 取消隐藏
skillhub hide unhide <slug> --namespace <ns>

全局选项

--registry <url>      # 指定 Registry（默认: http://localhost:8080）
--json               # JSON 输出
--version / -V      # 显示版本
--help / -h         # 显示帮助

---

Source 类型与自动检测

Type	说明	检测方式
registry	从 SkillHub registry 安装	默认，或 ns/slug 格式
git	从 Git repository 安装	owner/repo、github.com/...
local	从本地路径安装	./ 开头、/ 开头、~ 开头

---

支持的 Agent：npx skills 支持的所有 agent

完整兼容 npx skills 支持的所有 Agent，并将静态分类机制改成动态分类机制，避免冗余安装

Universal Agents（通用路径 .agents/skills）

Agent-Specific Path Agents

---

安装路径

Scope	路径
Global	~/.agents/skills/
Project	<repo>/.agents/skills/

---

安装方式

# 编译
cd skillhub-cli && pnpm install && pnpm build

# 使用
node dist/cli.mjs --help
node dist/cli.mjs --version

# 或创建 alias
alias skillhub="node /path/to/skillhub-cli/dist/cli.mjs"
> 还未安装 npm 包，测试使用 "node /path/to/skillhub-cli/dist/cli.mjs"
> 临时 npm 包，npm install -g motovis-skillhub
> 还在充分测试阶段，欢迎尝鲜抓虫子～截止0418已知问题：
> - 交互式安装进度提示Fetching显示问题，已修复，改为发新的包
> - 前端等关于命令的显示、文档使用并未同步更新

[CLAassistant]

All committers have signed the CLA.

[dongmucat]

Hi @Rsweater，感谢你的贡献和对 SkillHub CLI 方向的关注！

这个 PR 的思路和我们内部正在推进的方向高度一致。我们目前已经有一份官方 SkillHub CLI 的设计 spec，正在按计划实现，会作为第一方工具集成进主仓库（cli/ 目录），基于 Bun + TypeScript 构建，并配套原生服务端适配层（/api/cli/v1）。

考虑到官方 CLI 已在开发中，我们暂时不会合并这个 PR，以避免维护两套并行实现带来的复杂度。但你的工作对我们很有参考价值，再次感谢你的投入！

[Rsweater]

Hi @Rsweater，感谢你的贡献和对 SkillHub CLI 方向的关注！

这个 PR 的思路和我们内部正在推进的方向高度一致。我们目前已经有一份官方 SkillHub CLI 的设计 spec，正在按计划实现，会作为第一方工具集成进主仓库（cli/ 目录），基于 Bun + TypeScript 构建，并配套原生服务端适配层（/api/cli/v1）。

考虑到官方 CLI 已在开发中，我们暂时不会合并这个 PR，以避免维护两套并行实现带来的复杂度。但你的工作对我们很有参考价值，再次感谢你的投入！

Hello @dongmucat, 非常感谢您的回复～ 虽然有点遗憾，但还是很期待官方的 CLI 发布的。

现已获悉这个情况～