ClawHub Publish - Skill 发布助手

帮助用户将 Claude Code skills 发布到 ClawHub (clawhub.ai) 并管理版本更新。

核心能力

• 发布新 Skill: 首次发布到 ClawHub
• 更新版本: 发布新版本（自动递增版本号、生成 changelog）
• 检查状态: 验证 CLI 安装、登录状态、已发布技能列表
• 规范校验: 检查 SKILL.md 是否符合 ClawHub 要求

前置检查

执行任何命令前，自动检查：

1. clawhub CLI 安装: clawhub --version
2. 登录状态: clawhub whoami
3. SKILL.md 存在: 目标目录是否有 SKILL.md
4. frontmatter 完整: name / description / version 是否齐全

缺少时自动引导修复。

常用命令

工作流程

首次发布

1. 检查 CLI & 登录状态
2. 检查 SKILL.md 规范
3. 询问版本号（默认 1.0.0）
4. 询问 changelog
5. 执行 clawhub publish
6. 返回发布链接

版本更新

1. 检查当前已发布版本
2. 建议新版本号（自动递增 patch）
3. 询问 changelog（自动生成 diff 摘要辅助）
4. 更新 SKILL.md 中的 version
5. 执行 clawhub publish
6. 返回更新链接

ClawHub 规范要求

SKILL.md 必须包含

• frontmatter: name, description, version
• metadata (推荐): openclaw.requires.env, openclaw.requires.bins
• description: 决定触发时机，需清晰全面

目录结构

skill-name/
├── SKILL.md          # 必须
├── README.md         # 推荐
├── scripts/          # 可选
├── prompts/          # 可选
├── references/       # 可选
├── templates/        # 可选
└── requirements.txt  # Python 依赖

安装依赖

npm i -g clawhub
clawhub login