Openclaw每日技巧|Skill创建规范

Skill创建规范

什么是 Skill

Skill 是一个装着指令的文件夹，包含某类任务的工作流程说明。AI 按需加载、即学即用，实现写一次、到处用。

Skill vs 工具 vs MCP vs 子代理

组件	作用	特点
Skill	教会 AI 怎么做某类任务	按需加载，动态加载
Tool（工具）	提供基础能力	固定在上下文窗口中
MCP	连接外部系统（数据库、API）	提供数据访问能力
子代理	独立上下文执行专门任务	可并行工作

核心区别：

MCP 提供访问能力，Skill 提供专业知识
Tool 是固定能力，Skill 是可扩展的专业知识
Skill 可以增强主 Agent 和所有子代理

SKILL.md 文件规范

Skill 的核心是 SKILL.md 文件，格式如下：

1. 文件头（Front Matter）

---name: skill-name           # 唯一标识，英文 kebab-casedescription: 简短描述...  # 触发条件说明---

2. 元数据字段

字段	必填	说明
name	✅	唯一标识，英文，kebab-case
description	✅	简短描述，触发条件
author	❌	作者信息
version	❌	版本号
triggers	❌	触发关键词列表

3. 主标题和核心内容

# Skill 名称简短的功能描述## 核心功能...## 使用方式...## 工作流程...

4. 常用章节

根据任务类型组织内容：

触发条件 — 何时使用这个 Skill
输入格式 — 支持什么类型的输入
工作流程 — 具体的操作步骤
输出格式 — 返回结果的格式要求
脚本说明 — 如果有脚本工具，列出用法
注意事项 — 边界条件和限制
参考资料 — 相关文档链接

目录结构建议

skill-name/├── SKILL.md           # 核心文件（必须）├── scripts/           # 脚本文件夹│   ├── main.py│   └── utils.sh├── references/       # 参考资料├── assets/           # 静态资源└── README.md         # 可选

OpenClaw 特有变量

{baseDir} — Skill 安装目录路径，脚本中替换为实际路径

# 正确用法python3 {baseDir}/scripts/fetch.py"url"# 错误用法（会被直接执行）python3 /root/.openclaw/skills/skill-name/scripts/fetch.py"url"

描述编写技巧

好的描述格式：

[动词] + [对象] + [场景/条件]

示例：

✅ "生成学习练习题，基于讲义内容测试学生理解"
✅ "抓取网页内容为干净 Markdown，用于 AI 阅读"
❌ "这是一个很厉害的 Skill"

Anthropic 官方最佳实践

1. 清晰的输入定义

列出所有支持的文件格式和处理方式。

2. 结构化的工作流

分步骤说明，每个步骤有明确目标。

3. 质量标准

定义什么是好的输出（Quality Criteria）。

4. 输出模板

提供具体的输出格式模板或示例。

5. 参考资料

包含 examples、references 等子文件夹。

实际示例：Smart Web Fetch

---name: smart-web-fetchdescription: 智能网页抓取技能 - 替代内置 web_fetch...---# Smart Web Fetch## 核心功能- 四级降级策略## 使用方式### 命令行### Agent 使用## 降级策略1. Jina Reader (首选)2. markdown.new (降级)3. defuddle.md (降级)4. 原始内容 (最终兜底)## 优势- Token 节省 50-80%- 自动容错- 零成本

更多资源

Anthropic 官方课程：https://github.com/https-deeplearning-ai/sc-agent-skills-files
OpenClaw Skill 市场：https://clawhub.com
Skill 创建指南：https://agentskills.io