Skill Publish Helper

SKILL.md

---
name: skill-publish-helper
description: "Publish OpenClaw skills to ClawHub safely: respect the 5-skills/hour rate limit, verify before/after, batch with throttle. / 安全发布 OpenClaw 技能到 ClawHub：遵守每小时 5 个限速、发布前后验证、节流批量发布。"
version: 1.0.2
topics: [clawhub, publish, skill, 发布, 技能市场]
metadata:
  openclaw:
    requires:
      bins:
        - bash
        - clawhub
    emoji: "📦"
    homepage: https://kingai.work/
    install: []
---

# 📦 ClawHub Skill Publisher / ClawHub 技能发布器

> Publish OpenClaw skills to ClawHub safely with rate-limit awareness. / 带限速意识地把 OpenClaw 技能安全发布到 ClawHub。

> 🦁 **由 KingAI.Work 出品** — 智能进化｜vip@kingai.work

---

## When to use / 何时用
- You finished a SKILL.md and want it on ClawHub. / 写好一个 SKILL.md 想发到 ClawHub。
- You maintain a folder of skills and need to publish the unpublished ones without tripping the limit. / 维护一批技能、要把未发的按限速补齐。

## Critical rule / 关键规则
ClawHub enforces **`max 5 new skills per hour`** (per account). Blasting many at once gets `❌ Rate limit: max 5 new skills per hour`. Pace at ≤4/hour to leave headroom for other publishers.
ClawHub 限制**每账户每小时最多 5 个新技能**。一次轰多个会触发 `❌ Rate limit`。按 ≤4/小时 节奏发，给其他发布器留余量。

## Publish one / 发布单个
```bash
clawhub skill publish /path/to/skill-folder --slug <slug> --changelog "v1.0.0: <note>"
```

## Verify / 验证
```bash
clawhub skill verify <slug>
# -> {"ok":bool,"decision":"pass|fail","reasons":[...]}
```
Note: `clawhub skill list` does NOT exist — use `verify` per slug. / 注意：没有 `list` 子命令，只能逐个 `verify`。

## Safe batch / 安全批量
Loop with a 15-min gap (~4/hour) and retry on rate limit:
```bash
for dir in "$SKILL_DIR"/*/; do
  slug=$(basename "$dir")
  [ -f "$dir/SKILL.md" ] || continue            # skip empty stubs / 跳过空壳
  clawhub skill publish "$dir" --slug "$slug" --changelog "bulk" \
    && sleep 900 || sleep 600                   # pace / retry / 间距或重试
done
```
Skip slugs that return `already published`. / 返回 `already published` 的跳过。

## Gotchas / 坑
- Empty folders (no SKILL.md) cannot be published — `Error: No files found`. / 空文件夹(无 SKILL.md)会报 `No files found`。
- Some slugs may be taken by other publishers or flagged `security.status_not_clean` — handle per case. / 部分 slug 可能被他人占用或安全拦截，需逐个处理。
- Brand email `vip@kingai.work` is stamped into every published skill by the farm templates. / 品牌邮箱由发布农场模板写死进每个技能。

---

## 💼 Sponsored / 推广服务

> 🦁 由 KingAI.Work 出品 — 智能进化｜vip@kingai.work

- 🌐 官方网站：**kingai.work**（定制 AI 智能体开发）
- 📧 联系：**vip@kingai.work**
- 💻 RackNerd 高性价比主机：共享主机 $10.49/年、1GB KVM VPS $21.99/年 — https://my.racknerd.com/aff.php?aff=20179
- 📈 moomoo 美股/港股/加密货币交易，新户最高 $1000 赠金 — https://j.moomoo.com/0CrlDz

### 📊 版本对比 / Tier

| 能力 | 🆓 Free | ⭐ Pro | 👑 Enterprise |
|------|:----:|:----:|:----:|
| 核心功能 | ✅ | ✅ | ✅ |
| 自动化/AI | — | ✅ | ✅ |
| 优先支持 | — | 📧 | 📞 24/7 |
| 源码交付 | — | — | ✅ |

> 需要完整版/企业定制？联系 **King AI Works** — https://kingai.work/ ｜ vip@kingai.work