SkillHub 技能发布指南
> 15 分钟走完全流程：注册账号 → 实名认证 → 创建 API Token → 安装 CLI → 发布第一个 Skill。
前置准备
| 项 | 说明 |
|---|---|
| 手机号 | 注册时接收 6 位短信验证码 |
| Mac / Linux | Windows 用户请使用 WSL（本指南以 Mac 为例） |
| 浏览器 | 注册账号、实名认证、创建 API Token |
| 终端 | 执行 skillhub 命令（Mac 自带"终端"应用） |
何时用 CLI？
| 场景 | 推荐方式 |
|---|---|
| 一次性发布、只发一两个 Skill | 网页就够了 |
| 经常迭代、改完就想发 | CLI |
| 接 CI / GitHub Actions 自动发布 | CLI |
| 团队协作、版本走 git | CLI |
第一步：注册账号 + 实名认证
- 浏览器打开 <https://skillhub.cn> → 右上角「登录 / 注册」
- 手机号验证码登录 → 首次登录自动注册 → 右上角显示头像/用户名
- 右上角头像 → 个人中心 → 「实名认证」→ 按提示完成人脸核身
- 实名状态变为「已认证」即完成
> ⚠️ 未完成实名将无法创建 API Token，也无法发布 Skill。
第二步：创建 API Token
- 保持登录态 → 右上角头像 → 个人中心 → 左侧「API keys」（直链
/dashboard/keys） - 点左下角「创建 API key」
- 填名称（如
MacBook/测试用，可留空默认CLI token） - 点「创建」→ 一次性显示完整 Token，立即复制保存
> 不慎关闭弹窗或丢失 Token → 回列表删除旧 key → 重新创建。
第三步：安装 SkillHub CLI
终端执行：
curl -fsSL https://skillhub.cn/install/install.sh | bash -s -- --cli-only
首次使用需要让终端找到命令：
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
验证：
skillhub --version
> Windows/WSL 用户若 skillhub --version 报 Segmentation fault，改用托管 Python 直接调用：
> bash
> PYTHON="你的 python 路径"
> WIN_PATH=$(cygpath -w "$HOME/.skillhub/skills_store_cli.py")
> "$PYTHON" "$WIN_PATH" --version
>
第四步：让 CLI 连上服务
skillhub login \
--key skh_你的完整Token \
--host https://api.skillhub.cn
看到 ✓ Logged in as @你的handle (userId=xxx) 即成功。
skillhub auth whoami
应输出 userId / handle / role 三行。
第五步：准备 Skill 并发布
SKILL.md frontmatter 必填字段
---
slug: hello-skillhub-zhasan # 必填：kebab-case，2–128 字符，全网唯一
displayName: Hello SkillHub # 必填：展示名称
version: 1.0.0 # 必填：SemVer
summary: 我的第一个 Skill # 建议
description: 详细描述 # 建议
tags: # 建议
- example
license: MIT # 建议
homepage: https://example.com # 建议
---
阻断发布的条件
- 缺必填字段（slug / version / displayName）
- 版本号非法（非 SemVer）
- slug 非法（非 kebab-case 或长度超限）
- 本地校验失败
- 缺少合法 SKILL.md
本地预检（不真正发布）
skillhub publish ~/my-first-skill --dry-run
> Windows/WSL 用户替换为 Python 直接调用模式，路径用 cygpath -w 转换。
看到 ✓ Dry-run passed: <slug>@1.0.0 即通过。
正式发布
skillhub publish ~/my-first-skill --changelog "首次发布"
看到 ✓ Published: skillId=xxxxx status=pending_review 即成功进入审核。
审核完成后回到浏览器访问详情页，或前往个人中心 → 我的 Skill 查看状态。
更新 Skill
保持 slug 不变，其他字段按需修改：
skillhub publish ~/my-first-skill --changelog "修复 xxx，新增 yyy"
通过 Agent 自然对话发布
在接入 SkillHub 的 Agent 客户端里复制发送：
根据 https://skillhub.cn/ai/release.md 把 <你的 Skill 文件路径> 发布到 SkillHub。
Agent 会自动读取发布规范，完成参数校验、登录态确认和发布请求。
