SkillHub 技能发布器
> 由 未迟AI笔记（公众号：未迟AI笔记）维护并分享。关注获取更多 WorkBuddy 提效实战技巧。
把本地 skill 发布 / 更新到 SkillHub 的完整流程，封装成一条命令。
何时使用
- 用户说「把 XXX skill 上传到 skillhub」「发布到 SkillHub」「更新 SkillHub 上的技能」。
- 前提：用户已拥有 SkillHub 账号，并能提供 API Token（
skh_开头）。
核心机制（重要）
SkillHub 官方提供 CLI skills_store_cli.py，支持 auth login --token skh_xxx 与
publish <path>。本环境 HTTPS 链路带自签代理证书，Python 默认会校验证书链并抛
CERTIFICATE_VERIFY_FAILED，因此用 skillhub_cli_wrapper.py 在本进程内关闭证书校验后
再启动官方 CLI（不修改 CLI 本体）。
- 官方 CLI 下载：
https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/latest.tar.gz
（解压后 CLI 位于cli/skills_store_cli.py） - API host：
https://api.skillhub.cn - Token 形态：
skh_开头；通过auth login --token使用，不是会话 Bearer，也不是技能 ID。
使用步骤
-
确认要发布的 skill 目录 / zip：
- 目录或 zip 内必须含SKILL.md（frontmatter 需有name/slug/version/
category/agent_created等字段，见下方规范）。
- 隐私脱敏：发布前检查包内不得出现个人路径（C:\Users\xxx）、邮箱、APPID、电话、
住址等；可保留用户授权的公众号 / 品牌名（如「未迟AI笔记」）用于宣传。
- 占位文件注意：SkillHub 不允许.gitkeep等非常规扩展名，空目录占位改用
README.md。 -
运行发布助手（在本 skill 的
scripts/下）：
python3 scripts/publish_skill.py \
--token skh_你的token \
--path /绝对路径/到/你的-skill目录或.zip \
--changelog "本次更新说明"
可选参数：
- --version 1.2.0：覆盖 SKILL.md 中的 version。
- --dry-run：仅本地预检（校验 metadata + 打包），不发起 HTTP，先用来排错。
- --json：JSON 输出，便于程序解析。
- 助手会自动：下载官方 CLI（首次）→
auth login→publish。返回ok:true即创建新版本，
状态contentAuditStatus / reviewStatus / securityScanStatus = pending表示进入审核，
属正常流程。slug已存在则视为更新到新版本。
SKILL.md frontmatter 规范（发布必须）
---
name: your-skill # 技能目录名（小写中划线）
slug: your-skill # SkillHub 唯一标识；已存在则更新
displayName: 你的技能名
description: >- # 一句话 + 触发场景
描述…
agent_created: true # 由 agent 创建的技能置 true
version: 1.0.0
category: 开发工具 # 中文分类，如 视频处理 / 开发工具 / 效率工具
platforms:
- WorkBuddy
---
常见问题
[SSL: CERTIFICATE_VERIFY_FAILED]：本环境代理证书自签，已被 wrapper 关闭校验；
若你直接跑官方 CLI 报此错，请用 wrapper（即publish_skill.py）而不是直接python3 skills_store_cli.py。不允许的文件类型: .../.gitkeep：SkillHub 拒收非常规扩展名，把占位文件换成README.md。未找到 skills_store_cli.py：检查SKILLHUB_CLI环境变量，或把 CLI 放到
scripts/cli/skills_store_cli.py（助手会自动下载到这里）。- 登录失败：确认 token 是
skh_开头、未过期、属于目标账号。
Pitfalls（踩坑记录）
skh_xxx看起来像技能 ID 或会话 token，但它是 SkillHub API Token，用法
auth login --token skh_xxx；workbuddy_marketplace_skill工具只有 search/install，
没有发布能力，发布必须走官方 CLI。- 发布是作者后端写操作，需
skh_token；读接口（社区搜索镜像 lightmake.site）无需鉴权，
但仅最终一致，发布后短暂仍显示旧版，不以此判成败。 - 隐私红线：绝不可把含个人口播视频 / 日志的本地 skill 目录直接打包发布；发布前务必排除
workspace/等个人数据，仅保留干净的代码与文档。
