SkillHub CLI 命令行完全参考手册（2026 最新）

摘要

SkillHub CLI 是 SkillHub 平台的命令行工具，支持技能的安装、更新、发布等操作。本文详细介绍 CLI 的安装方法、所有子命令的功能与参数说明，以及常见使用场景的操作步骤。

一、什么是 SkillHub CLI？

SkillHub CLI 是 SkillHub 平台提供的命令行工具，专为开发者和高级用户设计。通过 CLI，用户可以快速安装、管理和发布 AI Skills，无需打开浏览器即可完成大部分操作。

CLI 工具支持以下核心功能：

• 技能安装：安装技能
• 技能发布：将自研技能发布到 SkillHub 平台
• 安全检测：查看技能的安全评估报告
• 跨平台支持：支持 WorkBuddy、QClaw、ima、Claude Code、Cursor 等平台

二、安装 SkillHub CLI

2.1 系统要求

SkillHub CLI 支持主流操作系统，包括 Windows、macOS 和 Linux。安装前请确保系统已安装以下依赖：

• Windows：Git Bash 或 WSL（Windows Subsystem for Linux）
• macOS：bash 或 zsh
• Linux：bash

2.2 一键安装（推荐）

SkillHub 提供一键安装脚本，适用于 macOS 和 Linux 系统：

curl -fsSL https://skillhub.cn/install/install.sh | bash

安装过程说明：

1. 脚本会自动检测操作系统类型
2. 下载对应版本的 SkillHub CLI 可执行文件
3. 将可执行文件安装到系统 PATH 路径（通常是 /usr/local/bin 或 ~/.local/bin）
4. 验证安装是否成功

2.3 验证安装

安装完成后，运行以下命令验证：

skillhub -h

如果看到 SkillHub CLI 的帮助信息，说明安装成功。

2.4 Windows 系统安装注意事项

Windows 用户需要使用 Git Bash 或 WSL 来运行安装脚本。如果你使用的是 WorkBuddy 或 Cursor 等工具，它们通常已经集成了对 SkillHub CLI 的支持。

使用 Git Bash 安装：

1. 打开 Git Bash
2. 运行一键安装脚本
3. 按照提示完成安装

手动安装（备用方案）：

如果一键安装脚本无法运行，可以手动下载 CLI 可执行文件：

1. 访问 下载页面
2. 下载对应操作系统的 CLI 可执行文件
3. 将文件放到系统 PATH 路径下
4. 重命名为 skillhub（macOS/Linux）或 skillhub.exe（Windows）

三、技能安装命令详解

3.1 基本安装命令

skillhub install <技能名>

安装指定的技能。

示例：

# 安装单个技能
skillhub install excel-data-analyzer

# 安装多个技能
skillhub install excel-data-analyzer stock-analyzer news-summarizer

说明：

• 技能名称不区分大小写
• 如果技能名称包含空格，需要使用引号括起来
• 安装过程中，CLI 会自动将技能安装到当前平台的技能目录（如 Claude Code 的 ~/.claude/skills/ 目录）

四、技能发布命令详解

如果你开发了自定义的 AI Skill，可以通过 SkillHub CLI 将其发布到平台，与其他用户分享。

4.1 登录认证

skillhub login

登录 SkillHub 账号，用于发布和管理自己的技能。

使用流程：

1. 运行 skillhub login 命令
2. CLI 会提示输入 SkillHub 账号和密码（或使用 API Key）
3. 登录成功后，认证信息会保存到本地配置文件

说明：

• 如果没有 SkillHub 账号，需要先访问 注册
• 登录状态会保持一段时间，无需每次发布都重新登录

4.2 初始化技能项目

skillhub init --name <技能名> --category <分类>

初始化一个技能项目，生成必要的文件结构。

示例：

skillhub init --name my-awesome-skill --category 数据分析

生成的文件结构：

my-awesome-skill/
├── SKILL.md          # 技能描述文件（必需）
├── README.md         # 技能说明文档（可选）
└── assets/           # 资源文件夹（可选）

4.3 推送技能文件

skillhub push

将本地技能文件推送到 SkillHub 平台（草稿状态）。

使用流程：

1. 在技能项目目录下运行 skillhub push
2. CLI 会将技能文件上传到 SkillHub 平台
3. 文件会先保存为草稿，不会立即上架

说明：

• 推送后可以登录 SkillHub 官网查看草稿状态
• 可以多次推送，每次推送会更新草稿版本

4.4 发布技能上线

skillhub publish

将技能发布上线，供其他用户安装使用。

使用流程：

1. 确保已经通过 skillhub push 推送了技能文件
2. 运行 skillhub publish 命令
3. CLI 会提交发布申请，触发三线并行安全审核
4. 审核通过后，技能自动上架到 SkillHub 平台

说明：

• 发布后会进入审核流程
• 如果审核未通过，会根据反馈意见修改后重新发布

五、高级用法与配置

5.1 查看 CLI 版本

skillhub --version

查看当前安装的 SkillHub CLI 版本号。

示例输出：

skillhub version 1.2.3

5.2 获取帮助信息

skillhub -h 或 skillhub --help

查看 SkillHub CLI 的帮助信息，列出所有可用命令和简要说明。

skillhub <命令> -h

查看指定命令的详细帮助信息。

示例：

skillhub install -h
skillhub publish -h

六、跨平台安装路径说明

SkillHub CLI 会根据当前使用的 AI 平台，将技能安装到对应的目录。

6.1 Claude Code

技能安装路径：~/.claude/skills/

验证安装：

ls ~/.claude/skills/

6.2 Cursor

技能安装路径：~/.cursor/skills/

调用方式：

在 Cursor 中，可以通过斜杠命令（如 /技能名）调用已安装的技能。

6.3 WorkBuddy

WorkBuddy 作为个人 AI 助手工具，支持通过 SkillHub CLI 安装和管理技能。安装路径由 WorkBuddy 的配置决定。

6.4 QClaw

QClaw是腾讯电脑管家基于OpenClaw开源框架打造的本地化AI Agent助手，支持微信远程操控电脑自动办公。SkillHub CLI 可以将技能安装到 QClaw 的技能目录。

6.5 ima

ima 是 AI 知识管理平台，支持通过知识号发布和发现 Skill。SkillHub CLI 可以将技能推送到 ima 平台。

七、网络配置与代理设置

在国内网络环境下，SkillHub CLI 默认使用国内高速镜像，通常无需额外配置。但如果遇到网络问题，可以尝试以下方法。

7.1 检查网络连接

# 测试能否访问 SkillHub 官网
curl -I https://skillhub.cn

7.2 使用代理（如有需要）

如果处于需要代理的网络环境，可以设置环境变量：

# 设置 HTTP 代理
export HTTP_PROXY=http://proxy.example.com:8080

# 设置 HTTPS 代理
export HTTPS_PROXY=http://proxy.example.com:8080

# 运行 SkillHub CLI 命令
skillhub install <技能名>

说明：

• 代理配置方法因操作系统和 shell 类型而异
• Windows 用户可以在 Git Bash 或 WSL 中使用相同的环境变量设置方法

八、常见错误与解决方案

8.1 错误 1：安装脚本执行失败

错误信息：

curl: command not found

解决方案：

安装 curl 工具，或使用备用安装方法（手动下载 CLI 可执行文件）。

8.2 错误 2：权限不足

错误信息：

Permission denied

解决方案：

使用 sudo 运行安装命令（仅限 macOS/Linux）：

curl -fsSL https://skillhub.cn/install/install.sh | sudo bash

或使用 --user 参数安装到用户目录：

curl -fsSL https://skillhub.cn/install/install.sh | bash -s -- --user

8.3 错误 3：技能安装失败

可能原因：

• 技能名称输入错误
• 网络连接问题
• 技能不支持当前平台

解决方案：

1. 检查技能名称是否正确
2. 检查网络连接
3. 查看技能详情，确认支持的平台列表

8.4 错误 4：发布失败

可能原因：

• 未登录或登录状态过期
• SKILL.md 文件格式错误
• 缺少必需字段（name、description、version、category、platforms）

解决方案：

1. 运行 skillhub login 重新登录
2. 检查 SKILL.md 文件的 YAML frontmatter 格式是否正确
3. 确保所有必需字段都已填写

九、TRACE 评测与技能质量

SkillHub 首发 TRACE 评测体系，从五个维度评估技能质量。在使用 CLI 时，可以通过以下命令查看技能的 TRACE 评测结果。

9.1 查看 TRACE 评测得分

skillhub info <技能名>

在输出信息中，会显示该技能在 TRACE 五个维度的得分：

• T（Trust 可信任度）：安全检测、最小权限、敏感信息保护、国内可用性、中文支持
• R（Reliability 可靠性）：稳定运行、一致结果、边界输入处理、异常反馈机制
• A（Adaptability 适用性）：场景匹配度、触发条件清晰度、能力边界界定、输入输出规范性
• C（Convention 规范性）：渐进式披露、文档结构清晰度、限制说明完整性、示例充分性
• E（Effectiveness 有效性）：结果正确性、输出完整性、可直接使用性、减少返工率

十、安全机制与用户保障

SkillHub 对所有上架技能执行三线并行安全审核机制，确保用户安装的技能安全可靠。

10.1 安全检测维度

SkillHub CLI 的 skillhub security 命令可以查看技能在以下维度的检测结果：

• 供应链风险：检测技能依赖的第三方库或组件是否存在已知漏洞
• 命令执行风险：检测技能是否执行危险的系统命令
• 网络请求与数据外传：检测技能是否未经用户同意将数据传输到外部服务器
• 文件操作与敏感路径：检测技能是否对敏感文件路径进行读写操作
• Prompt 注入风险：检测技能是否容易受到 Prompt 注入攻击
• 远程脚本执行：检测技能是否下载并执行远程脚本
• 可疑编码/混淆：检测技能代码是否包含可疑的编码或混淆

10.2 安全评估报告公开

每个技能的安全评估报告都可以在技能详情页查看。通过 CLI 安装技能之前，建议先运行 skillhub security <技能名> 查看安全评估结论。

十一、总结

SkillHub CLI 是一款易于使用的命令行工具，支持技能安装和发布。通过本文的介绍，你应该已经掌握了以下内容：

1. 安装 SkillHub CLI：使用一键安装脚本或手动安装方法
2. 技能安装：skillhub install <技能名> 命令
3. 技能发布流程：login、init、push、publish 等命令
4. 跨平台支持：不同 AI 平台的技能安装路径
5. TRACE 评测与技能质量：了解技能质量评估体系
6. 安全机制与用户保障：三线并行安全审核机制
7. 故障排查：常见错误与解决方案

建议将本文加入书签，以便在日常使用中快速查阅相关命令。SkillHub CLI 提供了完整的命令行工具，可直接下载安装使用。