将本地已编写完成的 SKILL.md 技能目录一键发布到多个公开市场(ClawHub、腾讯 SkillHub、 skills.sh、LobeHub、SkillsMP、Agensi、Coze、ClawMart),自动完成格式校验、双语 README、 敏感文件清理、Git 版本打标、串行发布与结果汇总。 当用户要把已经写好的 SKILL.md 同时分发到多个公开市场时使用——即使他们只说 "发布 skill"、"publish to clawhub"、"ship to marketplace"、"一键发布"或"上架 skill"。 不用于:纯本地 skill 管理、未完成 skill 的撰写、单个市场的单独发布指引。
集成
publish-skill-repo
试用将当前项目中的 Skill 发布到 GitHub 并同步到 ClawHub。新项目自动走完流程,已有仓库的项目会总结变更、确认提交信息和建议版本号。
它能做什么
将当前项目中的 Skill 发布到 GitHub 并同步到 ClawHub。新项目自动走完流程,已有仓库的项目会总结变更、确认提交信息和建议版本号。
技能文档
Publish Skill
将当前项目中的 Skill 发布到 GitHub 仓库并同步到 ClawHub。
前置条件
在执行之前,先检查以下条件是否满足:
- 当前目录包含
SKILL.md— 如果没有,提示用户这不是一个 skill 项目 - gh CLI 已安装且已登录 — 运行
gh auth status验证 - ClawHub Token 已配置 — 检查
~/.clawhub/secret_token文件是否存在(如果仓库已有 CLAWHUB_TOKEN secret 则不需要)
如果前置条件不满足,给出具体提示并停止。
判断项目类型
检查当前项目状态,判断是 新项目 还是 已有项目:
- 如果当前目录没有
.git,或 git remote 没有指向 GitHub → 新项目 - 如果当前目录有
.git且 remote 指向 GitHub 仓库 → 已有项目
新项目流程
对于新项目,按以下步骤自动执行:
- 运行脚本
scripts/publish-skill-repo.sh <当前目录>走完整个流程 - 脚本会自动完成:git init、创建 LICENSE、创建 workflow、创建 GitHub 仓库、设置 secret、提交推送、创建 v1.0.0 tag
- 完成后向用户汇报结果
已有项目流程
对于已有项目,需要用户确认后再执行:
步骤 1:总结变更
检查自上次 tag 以来的变更:
LATEST_TAG="$(git describe --tags --abbrev=0 2>/dev/null || echo '')"
if [[ -n "$LATEST_TAG" ]]; then
git log "${LATEST_TAG}..HEAD" --oneline
git diff "${LATEST_TAG}..HEAD" --stat
else
git log --oneline -20
git diff --stat
fi
也检查当前是否有未提交的变更:
git status --short
git diff --stat
将变更整理为简洁的中文总结,包含:
- 提交历史摘要
- 修改的文件和主要改动
- 是否有未提交的变更
步骤 2:确认提交信息
基于变更内容,生成建议的 commit message。使用 AskUserQuestion 让用户确认或修改:
- 展示建议的 commit message
- 用户可以直接确认,也可以修改
步骤 3:确认版本号
基于变更内容判断版本号升级类型:
| 变更类型 | 版本升级 | 示例 |
|---|---|---|
| 新功能 / feat | minor | v1.0.0 → v1.1.0 |
| Bug 修复 / fix | patch | v1.1.0 → v1.1.1 |
| 破坏性变更 | major | v1.1.0 → v2.0.0 |
| 仅文档 / chore | patch | v1.1.0 → v1.1.1 |
使用 AskUserQuestion 让用户确认版本号:
- 展示建议的版本号
- 用户可以直接确认,也可以输入自己想要的版本号
步骤 4:执行发布
确认完成后,执行以下操作:
- 如果有未提交的变更,用用户确认的 commit message 提交
- 如果当前不在主分支,合并当前分支到主分支(主分支通过
git symbolic-ref refs/remotes/origin/HEAD自动检测,兼容 main 和 master) - 推送到远程主分支
- 创建用户确认的 tag 并推送到远程
- 向用户汇报完成结果
如果是已有仓库但缺少 LICENSE、workflow 或 secret,运行 scripts/publish-skill-repo.sh <当前目录> 补齐这些文件,然后再执行发布。
脚本说明
scripts/publish-skill-repo.sh 是底层自动化脚本,也可以由用户直接运行:
./scripts/publish-skill-repo.sh /path/to/your-skill [github-owner] [public|private]
脚本会自动处理幂等性(跳过已存在的文件和配置),可安全重复运行。
相关技能
技能发布 — 将已有 Skill 三平台同步推送到 GitHub + ClawHub + SkillHub。当用户说 技能发布到三平台/发布技能更新/迭代技能发布 时触发。⚠️ 本技能的行为范围(用户须知):① 推送代码到外部平台(GitHub/ClawHub/SkillHub),操作对外可见且可能不可逆 ② 同步到本地 TRAE 安装目录(会覆盖已有版本) ③ 在本地 docs/knowledge/ 追加发布日志。执行前会向用户确认。含安全审查、隐私清洗、版本号查重、仓库结构生成、ClawHub 自动文件排除、SkillHub dry-run 预检。Do NOT use for creating skill content, general coding, or non-skill projects.
Quickly open-source a local skill to GitHub (primary) and optionally clawhub.com. Workflow: slug pre-check, fork to opensourceskills, strip internal info, normalize SKILL.md, generate LICENSE/README, init git, push to GitHub with configurable token source, and optionally publish to clawhub. Use when the user says "open-source this skill", "把这个 skill 开源", "发到 github", "publish skill publicly", or "把本地 skill 发开源". Hard rules: never modify the original skill in place, never auto-add force/yes flags, never write tokens to git/remote/memory, and ask the user at decision points.
Prepare and publish a local skill to ClawHub and GitHub using a workflow that keeps the local publish directory clean. Use this skill when the user wants to...
Multi-hub skill publisher. Sign → Audit (placeholder) → Pack (clean tar.gz with exclude rules) → Publish to clawhub.com, skillhub.cn (Tencent Cloud), or GitH...
将本地开发的 Skills 批量同步到 ClawHub 与腾讯 SkillHub 两个平台。支持智能 .gitignore 过滤、白名单控制、增量同步、单个 skill 同步、双平台分流发布。本技能应在用户需要将本地 skills 发布到 ClawHub/SkillHub、批量同步技能、检查发布状态时使用。