前言¶

自己写的 Skill 想给别人用，最直接的方式是发布到 SkillHub 社区。但真正走一遍就会遇到一连串琐碎问题：API Token 放哪、本地 CLI 怎么调、Git Bash 下路径会不会踩坑、Skill 文件的 frontmatter 要符合哪些字段要求、怎么确认不会误发。这套流程一旦做熟，每次发布都在重复同样的判断。SkillHub 发布器（SkillHub publish helper）做的事情，就是把这条「本地 Skill → SkillHub 社区」的发布链路固化成一套可复用方法，附带一个默认防误发的发布脚本。

这是什么¶

SkillHub 发布器是一个发布在 SkillHub 社区的 Skill（来源 community），坐标 @user_00c9b356/skillhub-publish-helper，当前版本 1.4.0，分类 dev-programming，发布者 user_00c9b356。它解决的是发布流程本身：前置条件、Token 安全读取、本地 CLI 调用、frontmatter 字段转换、dry-run 预检、常见报错处理，并提供一套发布后的反馈闭环方法论。

核心功能¶

下面列出资料中已核实的能力，按发布流程顺序排列。

1、前置条件：发布前需要完成实名认证并持有 API Token。
2、本地 CLI 调用：覆盖从本地调用 SkillHub 接口的完整路径，并包含对 Git Bash 路径 bug 的规避。
3、frontmatter 转换指南：给出 SkillHub 要求的 frontmatter 字段说明，便于把本地 Skill 的元数据整理成社区接受的格式。
4、dry-run 预检：发布脚本默认执行 dry-run，只做检查不实际发布，防止误发。
5、安全发布：加 --publish 参数才会真正提交发布。
6、Token 安全读取：Token 从环境变量 SKILLHUB_TOKEN 或 --token 参数读取，不落盘。
7、常见报错处理：覆盖 409 slug 冲突等发布阶段常见报错。
8、反馈闭环方法论：发布 → 取评测 → 优化 → 重发的流程由 references/eval-feedback-loop.md 承载。

随包附带通用 publish.sh 脚本，实现上述第 4 到第 6 项。另有本机可选的 fetch_eval.sh，用于一键取回评测做对比；该脚本因触发服务端扫描 bug（编号 566）未随发布包分发。

安装与启用¶

该 Skill 通过 SkillHub 社区分发，坐标 @user_00c9b356/skillhub-publish-helper，版本 1.4.0。启用前需准备好 API Token，可用环境变量方式提供：

export SKILLHUB_TOKEN="<your-token>"

随后在 Skill 目录内运行随包附带的 publish.sh。脚本依赖上述环境变量，或改用 --token 参数传入。

典型用法¶

发布脚本的核心行为是默认 dry-run、显式加 --publish 才真发。典型的两次运行如下。

第一次，只做预检，不实际发布：

./publish.sh

这一步执行 dry-run，会检查 frontmatter 字段、路径等问题，但不会向社区提交。

确认预检通过后，再真正发布：

./publish.sh --publish

如果不想设置环境变量，可以用参数传入 Token：

./publish.sh --publish --token "<your-token>"

发布完成后，按 references/eval-feedback-loop.md 的方法论取回评测、优化、重发，形成闭环。

适用场景与注意¶

适合在 SkillHub 社区发布 Skill 的开发者，尤其是需要反复发布、迭代的情况。资料中明确提到一个已实测的事实：在 WorkBuddy 沙箱内即可直连 api.skillhub.cn 完成发布，无需转到用户 WSL。

需要注意的几点：

1、Token 不要写进脚本或配置文件，统一走环境变量或 --token 参数。
2、frontmatter 字段要按 SkillHub 要求整理，dry-run 阶段会先暴露这类问题。
3、遇到 409 错误通常意味着 slug 已被占用，需要更换 slug。
4、fetch_eval.sh 未随发布包分发，需要时需自行从方法论文档中获取。
5、该 Skill 带 requires_api_key=true 标签，说明使用前必须先准备好 API Token。

结尾¶

SkillHub 发布器的价值不在于提供一个新的发布接口，而是把发布这条链路上的前置条件、路径坑、字段要求和防误发机制一次性梳理清楚，让人不必每次重新试错。官方地址：https://api.skillhub.cn/user_00c9b356/skillhub-publish-helper