Skill Publisher

自动化完成 OpenClaw 技能的完整发布生命周期：打包 → GitHub → ClawHub。

前置条件

• gh CLI 已完成身份验证（运行 gh auth status 可确认）
• npx clawhub CLI 已完成身份验证（运行 npx clawhub whoami 可确认）
• 存在一个包含有效 SKILL.md 的技能文件夹

快速开始

完整流程（打包 + GitHub + ClawHub）

# 从技能目录执行
scripts/publish.sh /path/to/skill-folder --repo owner/repo-name --version 1.0.0

分步执行

# 1. 仅校验与打包
scripts/validate.sh /path/to/skill-folder

# 2. 推送至 GitHub
scripts/push-github.sh /path/to/skill-folder --repo owner/repo-name

# 3. 发布至 ClawHub
npx clawhub publish /path/to/skill-folder --version 1.0.0 --slug skill-name

工作流程

步骤 1：准备技能文件夹

确保技能文件夹中包含以下内容：

skill-name/
├── SKILL.md          （必需 — 含 YAML frontmatter 的 Markdown 文件）
├── LICENSE           （推荐 — MIT 协议）
├── examples/         （可选 — 使用示例）
├── scripts/          （可选 — 辅助脚本）
├── references/       （可选 — 参考文档）
└── assets/           （可选 — 模板、图片、字体等资源）

SKILL.md 的 frontmatter 必须包含以下字段：

---
name: skill-name
description: 清晰描述该技能的功能及其触发场景
---

步骤 2：推送至 GitHub

cd /path/to/skill-folder

# 如尚未初始化 Git 仓库，则执行初始化
git init
git add -A
git commit -m "feat: initial release of skill-name"

# 创建远程仓库并推送代码
gh repo create owner/repo-name --public --source=. --push

若远程仓库已存在，请执行：

git remote add origin https://github.com/owner/repo-name.git 2>/dev/null || true
git push -u origin main

步骤 3：发布至 ClawHub

# 如未登录，先执行登录（将自动打开浏览器）
npx clawhub login

# 指定版本号发布
npx clawhub publish /path/to/skill-folder 
  --version 1.0.0 
  --slug skill-name 
  --name "Display Name" 
  --tags "tag1,tag2"

# 验证发布结果
npx clawhub inspect skill-name

注意： ClawHub 在发布后会自动执行安全扫描。技能通过扫描后即可被搜索到（通常耗时数分钟）。

常见任务

更新已有技能

# 1. 修改技能文件夹中的内容

# 2. 推送至 GitHub
cd /path/to/skill-folder
git add -A && git commit -m "fix: description of changes"
git push

# 3. 向 ClawHub 发布新版本
npx clawhub publish /path/to/skill-folder --version 1.1.0

复刻已有技能

npx clawhub publish /path/to/skill-folder 
  --version 1.0.0 
  --slug my-fork-name 
  --fork-of original-skill@1.0.0

检查发布状态

npx clawhub inspect skill-name
npx clawhub search skill-name

故障排查

命名规范

• Slug：全小写，仅允许使用短横线（例如：figma-plugin-writer）
• Repo：应与 slug 保持一致（例如：openclaw-figma-plugin-writer）
• Version：遵循语义化版本规范（例如：1.0.0、1.2.3）