[AI/Skill] SkillHub 选型 + 发布自定义 Skill 完整流程

0 序

• 撰写本篇的契机：如何将自己的 skill 公开到 公开的 skillhub 上？推荐用哪一个 skillhub？

接续: [AI应用] AI Agent Skill 综述：告别Prompt炼丹，把AI的“经验”封装成可复用的工程资产 - 博客园/数据知音

• 先上最终效果，看看昨晚刚发布的2个skill在 https://clawhub.ai 的情况

1 SkillHub选型 + 发布自定义Skill完整流程

背景：主流分OpenClaw生态ClawHub（全球官方）、腾讯SkillHub（国内镜像分发）、其他开源SkillHub，针对OpenClaw/WorkBuddy/QClaw生态，优先区分你的目标受众：面向全球开发者选ClawHub；面向国内中文用户优先腾讯SkillHub。

1.1 主流公开SkillHub对比（2026）

平台	地址	定位	优缺点	适合人群
ClawHub.ai（OpenClaw官方）	https://clawhub.ai	OpenClaw原生官方公开技能市场，全球最大技能库	✅原生支持、社区最大、CLI原生publish；❌国内访问慢、英文界面、中文搜索弱、审核宽松，安全风险需要自己负责	面向全球开发者，有海外网络，开发OpenClaw Skill
ClawHub镜像站(字节/火山引擎)	https://cn.clawhub-mirror.com/	ClawHub的国内镜像站，Agents的Skill仓库。	这是OpenClaw 官方中国镜像站（火山引擎提供基础设施），只能下载 / 搜索 skill，不能直接在这里发布 skill。 类比：npmmirror 淘宝镜像，只能加速下载，不能在淘宝镜像发布 npm 包，必须发布到 npmjs 官方源，镜像站自动同步过来。
腾讯SkillHub	https://skillhub.tencent.com	国内本土化ClawHub镜像分发平台，同步ClawHub，支持独立提交原创skill	✅国内高速、中文界面、安全审计、中文搜索；❌是分发平台，技能会二次审核，不会直接同步到ClawHub源	国内开发者，希望国内用户方便下载你的skill
龙蜥SkillHub	https://skillhub.openanolis.cn	Anolis OS AI Agent技能枢纽，Gitee PR提交模式	✅完全开源仓库驱动，PR合并即上线；❌生态受众偏小	操作系统/运维方向skill开发者
科大讯飞SkillHub	https://skill.xfyun.cn/ + github开源Repo:iflytek/skillhub/	私有化部署的企业内部技能注册中心，不对外公开集市	✅RBAC权限、审计日志；❌没有公开对外的skill市场	企业内部私有技能管理，不适合对外公开分享

✅推荐优先级

1. 想要全球曝光：主发布 ClawHub.ai
2. 想要国内用户友好访问：同时提交到 腾讯SkillHub（国内分发）
3. 只做运维/Linux方向：龙蜥SkillHub

注意：讯飞SkillHub只能自己部署，不能把skill公开到互联网集市，不要选它做公开分享。

1.2 发布Skill到ClawHub（官方源，完整步骤）

• https://agentskills.io/specification

1. Skill目录规范（必须、必读）

my‑awesome‑skill/
└── SKILL.md   # 核心文件，YAML frontmatter元数据 + skill正文

SKILL.md头部元数据示例：

---
name: my‑awesome‑skill
description: "这里写技能功能描述"
license: MIT
metadata:
    version: 1.0.0
    author: your‑github‑id
tags:
  - xx
categories: ["dev","tool"]
platforms: ["openclaw"]
---
# 下面写skill提示词、触发规则、工作流程

可以增加scripts/、assets/放脚本、模板资源，最终打包为zip包。

2. 两种发布方式（必读）

方式A：clawhub CLI（推荐开发者）

• 推荐文档:

• [AI/Agent/Hub] ClawHub : OpenClaw 开源生态的官方技能与插件注册中心 —— AI Agent 的 "npm" - 博客园/数据知音

# 安装cli
npm i -g clawhub

# 登录，跳转github授权
clawhub login

# 发布前自检 / 校验skill目录格式是否合法 (`--dry-run`)
clawhub skill publish "C:\Users\Johnny\.agents\skills\jz-research-target-software-project\" \
  --slug jz-research-target-software-project \
  --name "调研指定的软件项目Skill" \
  --version 1.0.0 \
  --changelog "Initial release" \
  --tags latest \
  --dry-run

# 直接发布到 clawhub.ai 公开市场
clawhub skill publish "C:\Users\Johnny\.agents\skills\jz-research-target-software-project\" \
  --slug jz-research-target-software-project \
  --name "调研指定的软件项目Skill" \
  --version 1.0.0 \
  --changelog "Initial release" \
  --tags latest

发布后分配唯一slug，所有人可以clawhub install <slug>安装。

方式B：网页上传

访问 https://clawhub.ai 登录github账号 → Publish Skill → 上传skill zip包，填写元数据提交。

1.3 发布到腾讯SkillHub（国内分发）

1. 访问 https://skillhub.tencent.com ，登录，完成实名认证（国内发布强制）
2. 两种提交方式：

• 网页端：上传skill zip，填写名称、版本、分类、支持平台，提交安全审核；审核通过上架国内市场。
• CLI：skillhub login → skillhub push → skillhub publish>

注意：腾讯SkillHub不会自动同步到ClawHub；如果你想全球+国内都可用，两边分别提交。

1.4 龙蜥SkillHub（Gitee PR模式）

1. fork gitee anolis‑skills仓库
2. 在skills目录新建你的skill文件夹，放SKILL.md和资源
3. 提交PR，审核合并后自动上线到 https://skillhub.openanolis.cn ；也可以网页直接上传zip无需git操作。

1.5 发布最佳实践

1. 命名：避免重名，建议作者名_skill功能；版本号遵循语义化版本x.y.z
2. 安全：禁止硬编码密钥；脚本尽量最小权限；不做高危系统操作；否则审核会驳回
3. 文档：description写清楚用途，写使用示例，定义触发词；提升别人使用意愿
4. 双分发策略：
   • 全球可见：发布ClawHub
   • 国内用户无痛下载：同步提交腾讯SkillHub
5. 测试：发布前本地clawhub validate校验格式，本地OpenClaw实测skill可以正常运行。

1.X 补充说明

如果你使用Dify、Dify‑skill，那是Dify自有技能集市，不属于OpenClaw的Agent SkillHub生态，发布流程完全独立。

Z FAQ for SkillHub

Q: cn.clawhub‑mirror.com 的特别说明

这是OpenClaw官方中国镜像站（由【火山引擎】提供基础设施），只能下载/搜索skill，不能直接在这里【发布】skill。
类比：npmmirror淘宝镜像，只能加速下载，不能在淘宝镜像发布npm包，必须发布到npmjs官方源，镜像站自动同步过来。

核心区别

站点	性质	能否publish（发布skill）	说明
clawhub.ai（海外主站）	官方源，全球Skill仓库	✅可以publish	唯一真正提交新skill的源头，发布后镜像站会同步你的skill
cn.clawhub‑mirror.com	国内镜像加速节点	❌不能publish	只做缓存同步；你在主站发布成功，过一段时间镜像站就会刷出你的skill，国内用户用这个地址高速下载你的skill
skillhub.tencent.com	腾讯独立分发集市	✅可以独立提交	一套独立审核，不会自动同步clawhub.ai，两边是两套库

完整流程（想要国内镜像站能看到你的skill）

1. 使用clawhub publish发布到 clawhub.ai（海外主站）（必须这一步）
2. 等待镜像站同步（一般几分钟‑几小时）
3. 国内开发者指定registry就可以高速安装你的skill：

clawhub search your‑skill‑name --registry=https://cn.clawhub‑mirror.com
clawhub install your‑skill‑name --registry=https://cn.clawhub‑mirror.com

⚠️注意：不要拿cn.clawhub‑mirror.com当做publish的registry，CLI会报错，镜像站不接收上传写入请求，只提供读/下载。

现在综合推荐优先级（2026）

1. 主发布：clawhub.ai（唯一官方发布入口，发布后火山镜像cn.clawhub‑mirror.com自动同步，国内用户就可以高速拉取你的skill）
2. 如果你希望同时在腾讯SkillHub曝光：额外单独提交一份到 skillhub.tencent.com（独立审核，不会自动同步主站）
3. 运维方向可选龙蜥SkillHub。

最佳实践：只需要发布一次到 clawhub.ai，cn.clawhub‑mirror.com 自动拿到你的skill，不需要重复上传两份。

Y 推荐文献

• [AI应用] AI Agent Skill 综述：告别Prompt炼丹，把AI的“经验”封装成可复用的工程资产 - 博客园/数据知音

X 参考文献