Agent Skills
返回列表
SkillHub 一键连接上传指南

SkillHub 一键连接上传指南

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_af163eaa/z-guide-skillhub。

技能介绍

要解决的问题

把自研 Skill 发布到 SkillHub，对第一次接触的人并不直观：CLI 怎么装、账号怎么登、SKILL.md 少字段会被拒、批量上传撞到限频该怎么办。这份指南把这些散落在官方文档里的动作收拢成一条可照做的路径，并把最容易出错的两处——前置自检与限频急停——单独拎出来强调。

技能如何工作

  • 上传前自检：先确认 SKILL.md 字段齐全、目录结构符合规范、图标尺寸正确、包体未超限，且不携带密钥或敏感信息。
  • 连接 CLI：按官方指引安装命令行工具，完成浏览器 OAuth 登录，凭证统一存放在 ~/.skillhub/ 下，不进入技能包。
  • 逐个发布：在技能目录下执行 skillhub push 与 skillhub publish，一次只处理一个技能，避免并发触发风控。
  • 限频纪律：日上传上限约 100 个，技能之间建议留 3–5 秒间隔；一旦出现速率错误或 429 响应，立即暂停约 1 分钟再续传。
  • 失败即停：任一技能上传失败时停止后续操作，记录已成功数量、失败点与报错原文，交由用户判断，不做静默跳过。
  • 审核上架：发布后进入内容合规、漏洞扫描与模型安全评估的三线审核，通过后自动上架；未通过则按反馈修改后重传。

适用边界与注意点

只面向常规 Skill 的发布流程。仅安装他人技能的场景走网页或 skillhub install，不在本指南范围内；依赖外部 API / MCP 的 Skill 需要额外的专项校验。法律、医疗、财税类内容必须在技能中固化免责声明。

使用场景

  • 已写好本地 Skill 但首次发布，不清楚 SkillHub CLI 如何安装、登录及执行 push 与 publish 命令。
  • 准备批量上传多个自研技能，需要了解日上传上限及触发限频时的暂停与续传操作。
  • 技能提交后被审核拒绝，需要根据反馈修改 SKILL.md 字段并重新执行上传与发布流程。
  • 不想使用命令行工具，打算直接访问 skillhub.cn 网页发布页填写信息并上传技能文件。

适合人员

  • 已编写好合法 SKILL.md 的 AI Agent 开发者，希望将本地技能首次成功发布。
  • 需要批量上传自研技能的项目负责人，诉求是掌握限频节流与失败急停纪律以避免账号受限。
  • 不熟悉命令行操作的 Skill 创作者，诉求是通过网页版零命令完成技能信息填写与文件上传。
  • 遭遇技能审核驳回的发布者，诉求是依据安全审核反馈修正红线问题并重新上架技能。