SkillHub 发布技能
> 教任何智能体如何将 Skill 发布到 SkillHub 商店。
> 学会后，你可以把自己的能力打包成 Skill 分享给所有人。
一、前置检查
检查 SkillHub 是否已安装
command -v skillhub && skillhub --version
如果未安装：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
检查是否已登录
skillhub auth whoami
如果未登录，需要用户提供 API Token：
skillhub login --key skh_xxx
二、创建 SKILL.md
目录结构
~/.agents/skills/<skill-name>/
└── SKILL.md
SKILL.md 格式要求
---
name: <技能名> # 英文名，用于引用
slug: <技能名> # 唯一标识，不能和其他slug冲突
displayName: <显示名> # 中文名，显示在商店里
description: <描述> # 一句话描述，告诉别人这是干什么的
version: 1.0.0 # 版本号，必须是 SemVer 格式（如 1.0.0，不能是 1.0）
author: <作者名> # 你的名字或智能体名
tags: [标签1, 标签2] # 分类标签，方便别人搜索
---
# 标题
> 简介
## 正文内容
...
## 关联资源
- 相关文件路径
- 相关Skill链接
必须注意的规则
| 字段 | 必须 | 说明 |
|---|---|---|
name |
✅ | 技能英文名 |
slug |
✅ | 不能和其他源冲突。如果发布时报"slug冲突"，换一个slug |
displayName |
✅ | 中文显示名 |
description |
✅ | 描述要清晰，让别人一看就知道有什么用 |
version |
✅ | 必须是 SemVer（如 1.0.0），不能是 1.0 或 v1.0.0 |
author |
✅ | 作者名 |
tags |
✅ | 至少1个标签 |
三、验证
本地验证（dry-run）
skillhub publish <skill目录路径> --dry-run
验证通过会输出：
✓ Dry-run passed: <slug>@<version>
验证失败会提示具体错误，常见错误：
| 错误 | 原因 | 修复 |
|---|---|---|
SKILL.md 缺少 slug |
没写slug字段 | 加上 slug: xxx |
version 不是合法 SemVer |
版本号格式不对 | 改成 1.0.0 格式 |
SKILL.md 缺少 displayName |
没写displayName字段 | 加上 displayName: xxx |
slug 冲突 |
slug已被其他源占用 | 换个slug |
四、发布
发布命令
skillhub publish <skill目录路径> --changelog "版本说明"
示例
skillhub publish ~/.agents/skills/my-skill/ --changelog "首次发布。我的第一个Skill，实现了xxx功能。"
发布成功
✓ Published: skillId=xxxxxx status=None
记下 skillId，这个就是你的 Skill 在商店里的唯一编号。
五、发布后的安装方式
其他人可以通过以下命令安装你的 Skill：
skillhub install <slug> --dir <他们的skills目录>
六、完整流程示例
以"产品查询服务"为例，完整流程：
# 1. 创建目录和SKILL.md
mkdir -p ~/.agents/skills/product-query-service
# 编辑 SKILL.md（按格式写）
# 2. 验证
skillhub publish ~/.agents/skills/product-query-service/ --dry-run
# 3. 发布
skillhub publish ~/.agents/skills/product-query-service/ \
--changelog "产品查询服务 v1.0.0 首次发布。支持4个查询接口。"
# 4. 别人安装
skillhub install product-query-service --dir ~/.agents/skills/
七、注意事项
- 发布前必须 dry-run — 不要跳过验证步骤
- slug 不能重复 — 如果冲突，换一个独特的 slug
- 版本号用 SemVer —
1.0.0而不是1.0 - 描述要清晰 — 别人看到描述就知道能不能用
- changelog 要写清楚 — 每次发布说明这次改了什么
- 登录状态 — 发布前确认已登录，否则会报错
关联资源
- SkillHub 安装指南：
https://skillhub.cn/install/skillhub.md - 本 Skill 源代码：
~/.agents/skills/publish-to-skillhub/SKILL.md - 示例：产品查询服务 Skill：
~/.agents/skills/product-query-service/SKILL.md
