技能介绍

要解决什么问题

在 SkillHub 上发 Skill，往往要反复查 frontmatter 规范、CLI 参数和踩坑帖：缺字段、409 slug 冲突、566 / fail to fetch 时也很难判断是网络还是内容扫描器崩了。本技能把「本地校验 → 正式发布 → 取评测 → 按短板迭代」收成可复用流程，而不是每次从零摸索。

技能如何工作

前置一次性准备：在 skillhub.cn 完成注册与实名认证，在个人中心创建 API Token（skh_xxx，只显示一次）；本机需已有 SkillHub CLI（如 skills_store_cli.py）。

核心步骤：

对照 references/skillhub-frontmatter.md 确认 SKILL.md 头部含 SkillHub 必需字段（slug、displayName、version、summary、license 等）；WorkBuddy 字段可共存。
dry-run：本地预检 frontmatter 与结构，不发 HTTP 请求。
正式发布：带上 --changelog 与 Token 调用 publish；同 slug 且升 version 即版本更新，不新建 listing。
个人中心查看审核状态；通过后可用 skill evaluation --json 取 TRACE 五维评测，按 references/eval-feedback-loop.md 改短板再发。

目录内 publish.sh 封装上述流程：默认 dry-run，须显式 --publish 才真发；Token 从环境变量或参数读取；在 Git Bash 下直接调 Python 脚本并配合 MSYS_NO_PATHCONV=1，规避路径被拼成 c:\c\... 的问题。

适用边界与注意点

只面向 SkillHub：其它市场或 GitHub 直传流程不同，不在本技能范围内。
不代做实名 / 人脸核身，Token 须本人创建；publish --token 为内联用法，auth whoami 显示未登录属正常。
遇 566 / fail to fetch：多为服务端内容扫描对某文件处理异常（内嵌脚本尤甚），先做「极简 SKILL.md + 全新 slug」对照，再二分定位；详见 references/troubleshooting-566.md。
409 slug 冲突：在 slug 上加 handle 前缀后重发。