github-to-clawhub

# GitHub → ClawHub 一键转化发布

把任意 GitHub 开源项目转化为 OpenClaw skill，发布到 clawhub.com。

---

## 前置要求

| 条件 | 说明 |
|------|------|
| **GitHub URL** | 目标项目的 GitHub 链接 |
| **clawhub token** | 格式：`clh_xxx`，在 clawhub.com → Profile → API Keys 获取 |
| **exec 权限** | OpenClaw 需要能执行 shell 命令（本地部署默认有） |

如果用户还没提供 token，**先询问 token，再继续**。

---

## 执行流程

### Step 1：读取原项目信息

```
web_fetch https://raw.githubusercontent.com/{owner}/{repo}/main/README.md
```

提取以下信息：
- 项目的核心功能（一句话）
- 技术路径（调 API / 本地计算 / 多 Agent / 纯提示词）
- 是否依赖外部服务、本地 GPU、特殊硬件
- License 类型（MIT / Apache / GPL 等）

**排除标准**（遇到这些直接告知用户不适合做 skill）：
- 需要本地 GPU / 大 VRAM
- 纯前端/移动端 UI 项目，无 API 可调
- 需要复杂本地服务部署才能运行
- 涉及敏感/违规内容

### Step 2：clawhub 查重

```
knot_skills search "{关键词1} {关键词2}"
```

搜索 2-3 次，覆盖不同角度的关键词。

判断标准：
- **完全重复**（功能完全相同）→ 告知用户，询问是否换 slug 继续，或放弃
- **部分重叠**（有相似但不完全相同）→ 说明差异，继续发布
- **空白地带**（无相似 skill）→ 直接继续

### Step 3：确定 skill 元信息

与用户确认（如果未提供）：
- `slug`：URL 友好名称，全小写 + 连字符，如 `opinion-analyzer`
- `displayName`：展示名称，如 `Opinion Analyzer — 多视角舆情分析助手`
- `tags`：逗号分隔，如 `analysis,sentiment,research`

**Slug 命名规则：**
- 全小写 + 连字符，无空格
- 不能和已有 slug 完全重复（Step 2 查重时会发现）
- 描述性词汇优先（`jd-interview-prep` 比 `interview` 好）

### Step 4：撰写 SKILL.md

这是核心步骤，决定 skill 质量。

**SKILL.md 结构：**

```markdown
---
name: {slug}
description: >
  {触发场景描述，包含5-10个触发词，这决定了 AI 什么时候加载这个 skill}
author: {作者}
version: 1.0.0
---

# {displayName}

灵感来源：[{原项目名}]({GitHub URL}) ⭐ {star 数}

{一句话核心价值}

---

## 使用方式
{2-3 个调用示例}

---

## 执行流程
{分步骤，具体到"做什么、怎么做"}

---

## 输出格式
{交付物的结构模...