Agent Skills
返回列表
SkillHub 发布助手

SkillHub 发布助手

开发编程 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_7db0c006/skillhub-cli-publish。

技能介绍

解决什么问题

把本地 skill 发布到 SkillHub 社区源时，常见失败点不是“调用 API”，而是路径、打包、版本、鉴权等工程细节：Git Bash 的 /c/Users/... 被脚本当作相对路径，临时文件和运行态文件被打进包，SKILL.md frontmatter 缺字段，同 slug 同版本重发触发 409，大目录导致上传超限。SkillHub 发布助手 用 Python 标准库封装这些步骤，使发布与更新更像一个可复核的流程。

如何工作

  • 零 CLI 依赖：脚本调用 SkillHub 社区发布 API，使用 Bearer Token 鉴权；可复用 ~/.skillhub/credentials.json，也支持 SKILLHUB_TOKEN。
  • 发布前预检：先执行 dry-run 校验 metadata 与打包结果，通过后再正式 publish；可用 --bump patch/minor 提升版本，避免同版本覆盖。
  • 自动排除：默认排除 node_modules、venv、__pycache__、.env、日志、锁、会话等运行态文件；也可用 .skillhubignore 声明技能级例外，适合钩子或守护进程生成的本地文件。
  • 体积检查：打包后扫描顶层大目录，对未排除的 >50MB 资源给出告警，降低触发 SkillHub 体积限制的概率。

注意边界

该助手面向 SkillHub 社区源的 发布 / 更新，不负责删除或下架；平台没有 CLI 删除能力时仍需后台处理。若发布后 install 或搜索仍拉旧版，才需要后台把版本设为 current；正常情况下发布即生效。首次使用前需完成注册、实名认证并创建 API Token。

使用场景

  • 本地技能修改完 metadata 和版本后，执行 dry-run 预检，再通过脚本覆盖更新到 SkillHub。
  • 本地钩子生成会话和日志文件，需要写入 .skillhubignore，确保发布包只包含必要技能内容。
  • 准备发布含资源目录的技能，打包后让脚本扫描大目录并告警，避免触发 SkillHub 413 超限。
  • 换到 Windows Python 环境发布旧项目，需要助手转换 C:/ 绝对路径并复用已有 Token 凭证。

适合人员

  • 维护本地技能包、发布前需要自动排除临时文件和运行态文件的工程师。
  • 负责把 AI 技能更新到社区源、希望先 dry-run 再覆盖同 slug 版本的使用者。
  • 在 Windows Python 环境发布脚本、需要处理绝对路径和 Token 凭证复用的开发者。
  • 发布含模型或资源目录的技能、需要体积预检避免 413 超限的技能作者。