Clawhub Publish

ClawHub 发布助手

指导你将 skill 发布到 ClawHub.ai 的完整流程。

---

工作流程

准备 → 安装CLI → 登录 → 准备目录 → 发布 → 验证

---

1. 安装 CLI

npm install -g clawhub

验证安装：

clawhub --version

2. 登录

clawhub login --device

会输出一个链接和验证码，打开浏览器访问并输入即可。验证登录：

clawhub whoami

3. 准备 skill 目录

发布目录结构示例：

my-skill/
├── SKILL.md          # 技能定义（必须有 name: 和 invoke:）
├── _meta.json        # 元数据（slug, version）
└── scripts/          # 配套脚本（可选但推荐）
    └── my-script.mjs

SKILL.md 示例：

---
name: my-skill
description: 技能描述
invoke: /my-skill
---

_meta.json 示例：

{
  "slug": "my-skill",
  "version": "1.0.0"
}

4. 发布

clawhub skill publish \
  --slug my-skill \
  --name "My Skill" \
  --version 1.0.0 \
  ./path/to/skill-dir

必传参数： | 参数 | 说明 | 示例 | |------|------|------| | --slug | 全局唯一标识，安装时用这个 | my-skill | | --name | 展示名称，不传会乱生成 | "My Skill" | | --version | 语义化版本号 | 1.0.0 |

可选参数： | 参数 | 说明 | |------|------| | --changelog | 版本说明 | | --tags | 标签，默认 latest |

5. 验证

clawhub inspect my-skill

确认 Moderation: CLEAN 表示通过安全扫描。

---

已知问题

展示名自动生成 bug

不传 --name 时 CLI 会从 slug 自动生成奇怪的名字（如 fork-it 变成 Fork It Publish）。 解决：发布时始终传 --name。

漏传脚本文件

skill 目录中如果有 scripts/ 等附属文件，CLI 会全部打包上传。确保发布前目录结构完整。

版本已存在

同一版本不能重复发布。更新内容时递增版本号即可。

---

常用命令速查

| 命令 | 用途 | |------|------| | clawhub search | 搜索已有 skill | | clawhub inspect | 查看 skill 详情 | | clawhub install | 安装 skill | | clawhub list | 查看已安装 skill | | clawhub whoami | 查看当前登录 | | clawhub skill publish | 发布 skill | | clawhub login --device | 设备码登录 |

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: GDWhisper
• Source: GDWhisper/fork-it.skill
• License: MIT

Install and usage instructions live in the source repository linked above.