SkillHub 连接与上传指南
一、定位 / 适用边界
- 定位：把"把自研 Skill 发布到 SkillHub"这件对新用户模糊的事，拆成可照做的官方步骤，并补齐"必要链接"与"限频纪律"。
- 适用：① 已写好一个本地 Skill（含合法 SKILL.md）想发布；② 不清楚 SkillHub CLI 怎么装/登/传；③ 批量上传怕触发限频不知如何停。
- 不适用：① 仅消费/安装他人 Skill（走 skillhub.cn 网页或
skillhub install即可）；② API/MCP 类 Skill 的 T4 专项校验（本指南只覆盖常规 Skill 发布）。
二、触发词
上传skill / 发布技能到skillhub / 连接skillhub cli / skillhub怎么用 / skillhub上传指南 / 发布自己的skill / skillhub链接 / 限频急停上传 / skills发布 / skillhub发布流程
三、章节地图
- 上传前自检（Skill 规则）
- 连接 SkillHub CLI（官方指引 + 必要链接）
- 执行上传（init → push → publish）
- 限频与急停纪律
- 审核与上架 / 排错
四、工作流程
阶段 0 · 上传前自检（必须满足才进阶段 1）
- SKILL.md 含 11 字段：name / id / version / description / agent_created / platforms / category / slug / displayName / summary / license / icon
- 目录结构合规：
SKILL.md+references/+USAGE.md+ 图标icon.png（512×512，保留水印） - 红线已固化：法律/医疗/财税类须含"非专业意见，重大事宜咨询持牌人士"免责
- 不依赖外部 API/MCP（除非用户显式指定并过 T4）
- 包规范：Skill 名称 1–128 字符；包支持 .zip / .tar.gz，≤50MB
阶段 1 · 连接 SkillHub CLI（官方指引）
> 官方来源：skillhub.cn 与腾讯云开发者社区 SkillHub 发布指南。
- 安装 CLI（官方一键脚本）：
bash curl -fsSL https://skillhub.cn/install/install.sh | bash
验证安装：skillhub -h（列出全部命令即成功）。 - 登录认证：
bash skillhub login
浏览器 OAuth 完成登录，凭证存于~/.skillhub/auth.json。 - （可选）初始化项目结构：在技能目录下执行，生成标准脚手架：
bash skillhub init --name <技能名称> --category <分类>
说明：若本地已按本工作空间规范准备好 SKILL.md，可直接进阶段 2 的 push，不必强依赖 init。
阶段 2 · 执行上传（官方发布流程）
按顺序执行，逐个技能上传，不并发：
skillhub push # 推送本地技能文件到 SkillHub 平台（不立即公开）
skillhub publish # 提交发布申请，进入审核
- 可见性（按需）：
skillhub publish --visibility public|unlisted|private|org public公开 /unlisted不公开列出 /private仅自己 /org组织内可见- 发布成功后 CLI 会输出技能详情页 URL。
阶段 3 · 限频与急停纪律（重点）
- 官方日上传上限约 100 个/天。批量上传务必节流：每个技能之间
sleep间隔（建议 3–5 秒）。 - 触发限频（速率错误 / 429 / 含
rate limit/too many requests）→ 立即暂停，等候约 1 分钟后再续传剩余，不要硬冲。 - 任一技能上传返回失败 → 立即停止后续，记录「已成功数 / 失败点 / 报错原文」交回用户判断，不要静默跳过。
- 全部成功 → 汇总
N/N汇报。
阶段 4 · 审核与上架 / 排错
- 发布后触发三线并行安全审核：内容合规过滤 + 科恩实验室深度漏洞扫描 + 云鼎实验室 AI 模型安全评估。审核通过自动上架。
- 审核未通过：按反馈意见修改后重新
skillhub push+skillhub publish。 - 常见坑：目录指错（应指到含 SKILL.md 的技能目录）、未登录就传、slug/名称重复、图标非 512、包超 50MB。
五、输出规范
- 给用户的是步骤清单 + 可复制命令 + 限频纪律说明 + 官方链接，不是长篇文档。
- 命令与链接以本指南"必要链接"节的官方值为准；若官方调整，以
skillhub -h/ 官网为准。
六、红蓝对抗（高频疑问）
- Q：连接失败？→ 检查 CLI 是否安装（
skillhub -h）、账号是否具备发布权限、网络是否可达（国内默认高速镜像）。 - Q：传一半限频了？→ 按阶段 3 暂停 1 分钟，再续传剩余技能（日上限≈100）。
- Q：Skill 被拒？→ 回阶段 0 自查 11 字段与红线，补正后重传。
- Q：不想用命令行？→ 访问 skillhub.cn 网页发布页，填信息+上传文件+提交审核（零命令）。
七、红线 / 安全审查
- 严禁在 Skill 中写入密钥 / token / 个人敏感信息（凭证由
~/.skillhub/管理，勿入技能包）。 - 法律/医疗/财税类必须固化免责声明。
- 发布内容须符合 SkillHub 平台规范与三线安全审核要求，不发布侵权/违规内容。
八、必要链接（官方，解决"链接不清楚"）
- SkillHub 官网 / 发布页：
https://skillhub.cn - CLI 一键安装：
curl -fsSL https://skillhub.cn/install/install.sh | bash - 腾讯云·SkillHub 怎么发布自己的 Skill：
https://cloud.tencent.com.cn/developer/techpedia/2618/20637 - SkillHub CLI 命令行完全参考手册：
https://cloud.tencent.com/developer/article/2697630 - 如何编写 SKILL.md（从零创建）：
https://cloud.tencent.com/developer/article/2698565 - 技能发布完整指南（编写到上架）：
https://cloud.tencent.com/developer/article/2697005
九、版本与来源
- V1.0.0 · 由本项目"刷题类 Skill 批量制作后需上传 SkillHub，但新用户不清楚连接与链接"的真实诉求催生；内容基于 SkillHub 官方指引（skillhub.cn + 腾讯云开发者社区），限频参数（日上限≈100、限频暂停1分钟）依用户提供的官方口径。
