为什么要创建 Skill？
ClawHub 已拥有 70,100+ Skills、180K 用户、39M+ 下载量。创建自己的 Skill 不仅能扩展 Agent 的能力，还能为社区做出贡献。一个好的 Skill 可以被全球数万用户使用。
💡 你知道吗？ClawHub 上排名靠前的 Skill 作者可以获得社区认可、技术影响力，甚至商业合作机会。
Skill 基础结构
每个 Skill 的核心是一个 SKILL.md 文件，它告诉 Agent 如何使用这个技能：
my-awesome-skill/
├── SKILL.md # 核心指令文件（必须）
├── scripts/ # 辅助脚本（可选）
│ ├── setup.sh
│ └── run.sh
├── templates/ # 模板文件（可选）
│ └── output.html
└── README.md # 说明文档（推荐）
SKILL.md 文件详解
基本结构
# Skill Name
简短描述这个 Skill 的用途。
## 触发条件
描述何时应该使用这个 Skill。
## 使用方法
1. 第一步做什么
2. 第二步做什么
3. ...
## 工具依赖
列出需要的工具和 API。
## 示例
提供实际使用示例。
完整示例：SEO 分析 Skill
# SEO Analyzer Skill
分析网页的 SEO 指标并生成优化建议报告。
## 触发条件
当用户要求分析网页 SEO、检查 meta 标签、
或生成 SEO 报告时使用此 Skill。
## 使用方法
### 1. 获取页面内容
使用 `web_fetch` 工具获取目标页面的 HTML 内容：
```
web_fetch url="https://example.com" extractMode="text"
```
### 2. 分析关键指标
检查以下 SEO 要素：
- title 标签长度（建议 50-60 字符）
- meta description（建议 150-160 字符）
- H1 标签数量（应为 1 个）
- 图片 alt 属性覆盖率
- 内部/外部链接数量
### 3. 生成报告
将分析结果写入 HTML 报告文件。
## 工具依赖
- `web_fetch` - 获取页面内容
- `write` - 生成报告文件
- `exec` - 执行分析脚本
## 示例输出
分析 https://example.com 的 SEO 指标：
- ✅ Title: 52 字符（合格）
- ⚠️ Description: 缺失（需优化）
- ❌ H1: 3 个（应为 1 个）
高级功能
工具集成
SKILL.md 中可以引用 OpenClaw 的所有内置工具：
| 工具 | 用途 | 示例 |
|---|---|---|
| web_fetch | 获取网页内容 | 抓取 API 数据 |
| web_search | 搜索信息 | 查找最新资讯 |
| exec | 执行命令 | 运行脚本 |
| write | 写入文件 | 生成报告 |
| browser | 浏览器控制 | 自动化测试 |
脚本集成
# 在 SKILL.md 中引用脚本
## 安装步骤
运行安装脚本：
```
bash scripts/setup.sh
```
## 执行分析
运行主分析脚本：
```
python3 scripts/analyze.py --url $TARGET_URL
```
发布到 ClawHub
1准备发布
# 确保目录结构正确
ls -la my-awesome-skill/
# 应该看到 SKILL.md 在根目录
# 检查 SKILL.md 格式
head -5 my-awesome-skill/SKILL.md
2发布命令
# 使用 ClawHub CLI 发布
clawhub publish my-awesome-skill/
# 或使用 OpenClaw 内置命令
openclaw skill publish my-awesome-skill/
3版本管理
# 更新版本号
clawhub version my-awesome-skill 1.1.0
# 发布更新
clawhub publish my-awesome-skill/ --version 1.1.0
最佳实践
✅ DO:
- SKILL.md 开头清晰说明用途
- 提供完整的使用示例
- 列出所有依赖工具
- 使用 Markdown 格式化
- 添加错误处理说明
❌ DON'T:
- 不要在 SKILL.md 中硬编码 API Key
- 不要依赖未声明的外部服务
- 不要忽略错误情况
- 不要使用过于复杂的触发条件
社区优秀 Skill 案例
| Skill 名称 | 下载量 | 特点 |
|---|---|---|
| github-trending | 50K+ | 简洁的触发条件，完善的错误处理 |
| seo-analyzer | 30K+ | 详细的分析指标，可视化报告 |
| weather | 80K+ | 极简设计，多数据源支持 |
| notion | 45K+ | 完整的 API 集成，模板丰富 |