我想先做出一个最小可用 Skill
先把第一个 Skill 跑通，比先研究复杂字段更重要。
你学完这一章以后，应该达到什么状态
- 你知道 Skill 最少由什么组成，不会再把它和 Plugin 或 Tool 混在一起。
- 你能写出一个最小可用的
SKILL.md，并知道它该放在哪。 - 你知道什么时候该拆脚本、模板和资源，什么时候不该过度工程化。
- 你知道为什么第三方 Skill 要先做安全审查，再谈发布和复用。
Skill Development
这一章的目标，不是会装 Skill，而是会把经验沉淀成可复用能力。
很多人装过很多 Skill，却一直不会自己写。真正的分水岭在这里：你有没有把某个高频任务，整理成一个结构清楚、可加载、可调试、可分发的 Skill 目录。 这一章就解决这个问题。
先做最小闭环
先会写，再谈发布
结构和调试同样重要
Problem
这一章主要帮你解决什么问题
Skill 开发最常见的断层，不是“不会写代码”，而是不会把一段经验整理成结构稳定、能被系统识别的能力目录。
分不清 Skill 到底是什么
它不是单纯提示词，也不是另一个 Tool，而是一套带目录结构的任务方法层。
不知道 SKILL.md 最少要写什么
这一章会先用最小闭环跑通，再逐步补 metadata、脚本和资源。
改了 Skill 但当前会话不生效
这通常不是文案坏了，而是优先级、加载门控或会话快照没刷新。
本地能用，但不知道怎么发布
后面会把本地目录、ClawHub、共享和公开发布这条线收完整。
Three Layers
先把 Skill 的 3 层结构看懂
只要这三层理解顺了，后面写 Skill 就不会越来越乱。
说明层
SKILL.md是核心入口- 定义适用场景和执行规则
- 告诉模型什么时候该用它
资源层
- 脚本、模板、示例文件
- 让 Skill 从“会说”变成“能做”
- 越复杂越要收目录
配置层
metadata.openclaw.requiresskills.entries- 决定依赖、环境变量和可加载条件
Reading Path
最推荐的学习顺序
这一章最适合按“先写最小例子，再补结构，再接能力，最后学发布”的顺序往下走。
Quick Choice
如果你现在只想解决一个问题
直接按你当前卡住的地方跳过去，不必整章从头读完。
我总把 SKILL.md 写得很乱
这一篇最适合先把 name、description、metadata 和正文边界分清楚。
我不知道什么时候该拆目录
先从单文件开始，只有复杂度出现时再拆层，最不容易烂尾。
我想让 Skill 真的干活
把 Tool、脚本和外部 API 连接起来，Skill 才会从“会说”变成“能做”。
我改了 Skill 但不生效
优先看加载门控、目录优先级和会话快照，不要先怀疑自己文案全错了。
我已经准备发到 ClawHub
那就先把本地目录、依赖和发布前检查项走完。
Reference Ecosystem
外部 Skill 市场和参考生态，适合拿来做什么
它们更适合找灵感和看结构，不适合替代你的安全审查。
SkillsMP
适合按关键词和分类看别人怎么写 Skill 目录和说明。
skills.sh
适合快速对比不同 Skill 页面和社区写法。
Claude Skills 文档
适合学习结构化写法，但不能直接替代 OpenClaw 落地规范。
ClawHub
真正涉及安装、更新和发布时，还是要回到 OpenClaw 自己的生态入口。