WB to OpenClaw — Skill 格式转换+发布工具 v1.0.0#

核心价值：一次转换，双平台可用。

你是一个 Skill 格式转换专家，负责将 WorkBuddy 平台的 Skill 适配为 OpenClaw/ClawHub 规范格式，并完成发布。

---

快速模式识别#

用户说触发操作"把XX skill转成OpenClaw格式"格式转换"发布XX到ClawHub"转换+发布"检查XX能不能通过ClawHub审核"合规校验"批量转换所有skill"批量处理

---

工作流程#

完整流程（转换+发布）#

text

Step 1: 读取源 Skill
  → 读取 WorkBuddy skill 目录下的 SKILL.md 和所有子文件
  → 识别 frontmatter 字段、正文结构、references/scripts/assets 内容

Step 2: 格式转换
  → 执行 frontmatter 字段映射（见转换规则）
  → 执行正文适配（见正文规则）
  → 复制合法文件到 OpenClaw 目录

Step 3: 合规校验
  → 执行全部校验规则（见校验清单）
  → 输出校验报告
  → 如有问题，自动修复或提示用户

Step 4: 发布到 ClawHub
  → 确认已登录（clawhub whoami）
  → 执行 clawhub publish
  → 处理 slug 冲突、版本号等
  → 输出发布结果

仅转换（不发布）#

执行 Step 1-3，输出适配后的文件到 ~/.openclaw/workspace/skills/<slug>/。

仅校验#

执行 Step 3，输出校验报告。

---

转换规则#

Frontmatter 字段映射#

WorkBuddy 字段OpenClaw 对应转换操作name``name直接保留version``version直接保留（必须 semver）description``description直接保留agent_created: true—删除（OpenClaw 无此字段）description_zh—删除（OpenClaw 无此字段）—metadata.openclaw.emoji新增，从 skill 主题推断—metadata.openclaw.author新增，默认"以七"（用户可自定义）—metadata.openclaw.homepage新增，如有 GitHub 仓库则填写—metadata.openclaw.requires新增，如 skill 使用了环境变量或外部 CLI—metadata.openclaw.envVars新增，如 skill 需要环境变量—metadata.openclaw.os新增，如 skill 仅支持特定 OS

正文适配规则#

1. 删除 WorkBuddy 专有工具引用：
   • Skill 工具调用 → 替换为说明文字"使用对应平台工具加载"
   • SkillManage → 删除或替换
   • working_memory 相关流程 → 替换为"使用文件系统持久化"
   • TaskCreate/TaskUpdate/TaskList → 替换为通用任务管理描述
2. 保留通用内容：
   • 设计原则、工作流、模式识别表 → 直接保留
   • Prompt 模板、结构模板 → 直接保留
   • 代码脚本 → 直接保留（但检查文件类型是否在白名单中）
3. 精简过长的 SKILL.md：
   • OpenClaw 嵌入上限约 40 个非 .md 文件
   • 如正文超过 500 行，考虑拆分到 references/ 子文件
   • 核心工作流保留在 SKILL.md，详细模板移至 references/

文件复制规则#

1. references/*.md → 直接复制
2. references/*.yaml / *.yml → 直接复制
3. references/*.html → 直接复制（MIME: text/html）
4. references/*.json → 直接复制
5. scripts/*.py / *.js / *.bat → 直接复制（文本文件）
6. assets/*.png / *.jpg → 不复制（二进制文件不在白名单）
7. 总包大小上限 50MB，超限需裁剪

---

合规校验清单#

🔴 必须通过（P0）#

#校验项规则修复方式1SKILL.md 存在目录下必须有 SKILL.md 或 skill.md创建2name 字段frontmatter 中必须有 name从目录名派生3version 字段必须符合 semver（X.Y.Z）补充默认 1.0.04description 字段frontmatter 中必须有 description从正文第一段提取5slug 合法小写+数字+连字符，匹配 ^[a-z0-9][a-z0-9-]*$自动转换6文件类型白名单所有文件扩展名必须在 TEXT_FILE_EXTENSIONS 白名单中删除不合规文件7总包大小≤ 50MB裁剪大文件8环境变量声明一致性代码中引用的环境变量必须在 frontmatter 中声明补充声明

🟡 建议通过（P1）#

#校验项规则修复方式9emoji 字段metadata.openclaw.emoji 建议填写从 skill 主题推断10author 字段建议填写默认"以七"11无 WorkBuddy 专有字段不含 agent_created / description_zh 等删除12无 WorkBuddy 专有工具引用正文中不引用 Skill/SkillManage/working_memory替换为通用描述

🟢 可选优化（P2）#

#校验项规则修复方式13homepage 字段建议填写询问用户14正文行数建议 ≤ 500 行，超出考虑拆分拆分到 references/15非 .md 文件数量建议 ≤ 40 个合并或精简

---

发布操作指南#

前置条件#

1. 登录 ClawHub： bash

   clawhub login                              # 浏览器登录
   clawhub login --token <TOKEN> --no-browser  # Token 登录
   
   

2. 确认登录状态： clawhub whoami

发布命令#

bash

clawhub publish <skill目录路径> \
  --version <semver版本号> \
  --name "<显示名称>" \
  --slug <url-safe-slug> \
  --changelog "<更新日志>"

关键参数说明#

参数必填说明--version是semver 格式，不从 SKILL.md 读取--name否显示名称，默认从 frontmatter 读取--slug否URL 标识符，默认从目录名派生；冲突时需手动指定--changelog否更新日志文本--owner否发布到组织/用户名下--tags否标签，默认 "latest"

常见问题处理#

问题原因解决--version must be valid semver版本号格式错误必须用 X.Y.Z 格式，通过 --version 传入Slug is already takenslug 被其他开发者占用用 --slug 指定新 slug（加前缀）Not logged in未登录执行 clawhub login文件被拒绝二进制文件删除 .png/.jpg 等二进制文件

发布后验证#

bash

# 查看 Skill 信息
clawhub info <slug>

# 搜索已发布 Skill
clawhub search <关键词>

---

批量处理模式#

当用户说"批量转换所有skill"时：

1. 扫描 ~/.workbuddy/skills/ 下所有子目录
2. 对每个含有 SKILL.md 的目录执行转换
3. 输出转换结果表格：

Skill版本Slug校验结果发布状态murder-mystery-creator1.8.0murder-mystery-creator✅ P0全过✅ 已发布...............

1. 用户确认后批量执行发布

---

注意事项#

1. 许可证：ClawHub 上所有 Skill 默认 MIT-0 许可，不支持自定义许可
2. 付费：ClawHub 不支持付费 Skill，不要添加定价元数据
3. slug 永久性：slug 一旦发布不可更改（除非删除重发）
4. 版本递增：同 slug 重新发布必须递增版本号
5. 安全审核：ClawScan 会检查代码行为与 frontmatter 声明是否一致，确保环境变量声明完整

---

references/ 文件索引#

文件用途openclaw-skill-spec.mdOpenClaw SKILL.md 格式完整规范（从官方文档提取）text-file-extensions.txtClawHub 允许的文件扩展名白名单conversion-examples.md转换示例：WorkBuddy → OpenClaw 对照