SkillHub 全自动发布

核心痛点

在开发完 Agent 技能后，将其发布到社区的过程往往存在诸多阻碍。开发者不仅需要手动切换到命令行工具，还要处理繁琐的登录验证、YAML frontmatter 格式校验以及文件合规性审查。任何一个环节出错都会导致发布失败，打断开发心流。本技能旨在将这些机械且容易出错的流程完全自动化。

工作机制

该技能封装了 SkillHub CLI 的交互逻辑，通过标准化的六个步骤确保发布过程顺畅：

• 环境预检：自动执行准备脚本，检测本地是否存在 ~/.skillhub/cli/skills_store_cli.py。若未安装会自动下载，并利用预配置的 Token 完成静默登录。
• 元数据补全：读取目标目录下的 SKILL.md，校验 slug、version 等必填字段。若缺失，技能会根据规则自动生成合规内容，例如将 name 转换为 kebab-case 格式的 slug，或补全默认版本号 1.0.0。
• 文件合规化：针对社区规范中禁止的 .bat 和 .ps1 文件，自动将其重命名为 .txt 后缀，并同步修正文档中的引用路径，避免上传被拒。
• 自动化提交：依据变更情况生成标准化的变更说明（如 feat: 新增功能），调用 API 接口执行发布，并实时解析返回结果。

适用场景与注意点

该方案特别适合在完成技能迭代后，希望快速同步至 SkillHub 的开发者。

需要注意的是，发布动作依赖于本地预配置的 Token。如果遇到 HTTP 401 或登录失效提示，需前往 SkillHub 官网重新生成凭证。此外，虽然技能会自动忽略 .git 和 node_modules 等目录，但建议在发布前确保代码库处于干净状态，以免无关文件占用包体大小。