SkillHub 开源发布器 · Agent 一键上架
将以下提示词粘贴到你的 AI 对话框中:
请根据官方安装指南 https://skillhub.cn/install/skillhub.md,在 AI 助手中安装 @user_5ba23798/skillhub-publisher-cn。
技能介绍
问题:Skill 写好了,但 skillhub publish 不认
你在 WorkBuddy 里自建的 Agent,本质上是一个 Skill:一个 SKILL.md,可能还配有 references/、data/、assets/。写完后如果想让别人搜到、安装、使用,需要发布到 SkillHub——但后端对 SKILL.md 头部的 frontmatter 校验非常严格。
常见情况是:本地 Skill 只有 name 和 description,再加一句 agent_created: true,缺少 slug、version、displayName 三个必填字段,直接 publish 会被拒。这个技能要解决的就是「格式补齐 → 本地校验 → 安全上传」这条链路上的摩擦,你不需要懂 CLI 细节。
它如何工作
核心能力一:补齐 frontmatter。 用 Edit 工具只改 --- 包裹的头部,正文不动。必填三项规则很死:
slug:只允许小写字母、数字、中划线,2–128 字符,不能以-开头或结尾,即必须匹配^a-z0-9-?$version:必须是 SemVer 三段式,像1.0.0,v1.0或1.0都不行displayName:非空展示名
另有一组可选但强烈建议填的字段:description、tags(影响搜索命中)、license(个人作品常用 MIT)、summary、homepage。
核心能力二:本地预检。 第 3 步是一次不联网的校验:通过就继续,报错则按提示回修 frontmatter。最常见的四类错误是缺 slug、slug 含大写或下划线、version 不是合法 SemVer、缺 displayName——本质上都是格式问题,改回来即可。
核心能力三:凭证与发布分离。 skillhub auth 可以用 skh_ 开头的个人 Token 登录,推荐做法是你自己在 SkillHub 网站生成 PAT 后在终端完成登录,Token 不必出现在聊天里;技能随后执行发布、拿回 skillId 和 status,并告诉你搜索与安装方式。
适用边界与注意点
- 前置条件是
skillhubCLI 已安装且已登录,skill 目录下根层级必须有SKILL.md - 发布前检查
data/目录:SkillHub 会连同data/一起打包上传,私密或未脱敏内容会一起暴露 - 自动忽略的内容包括
.git、.idea、.vscode、node_modules、__pycache__、*.pyc、.DS_Store,不用担心把它们传上去 - 单包上限约 10MB,普通文本 Skill 很难触及
- 数组写法
tags下每行需要缩进两格加-,这个缩进不规范也会导致发布失败
使用场景
- 自建 Agent 技能发布到 SkillHub 被拒(缺 slug 等必填字段),需补齐 frontmatter 并过本地预检。
- 本地校验报错:slug 含大写、version 非三段式 SemVer,按提示修改格式后重新预检。
- 想要在聊天里完成技能发布但不想泄露 skh_ Token,需走 PAT 终端登录流程完成上架。
- 手头有多个自建 Skill 需要批量上架,为每个 slug 补齐必填字段后循环执行发布命令。
适合人员
- 在 WorkBuddy 里自己开发 Agent 技能、希望公开让别人搜索安装的个人开发者
- 负责将内部工具发布到 SkillHub、需要排查 frontmatter 校验报错的工程团队成员
- 有多个自建 Skill 待上架、要求凭证不落盘、不想 Token 出现在聊天记录里的开源工具维护者
- 刚从 WorkBuddy 自建 Agent 转向开源分发、对 CLI 发布流程不熟悉的独立创作者