skill 文件是openclaw中面向ai与人的结构化任务说明书，核心为skill.md，含yaml前言（定义身份、权限等）和markdown正文（描述场景、步骤等），决定技能能否加载与执行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw 的 SKILL 文件不是传统插件，也不是后台服务程序，它本质上是一份给 AI 看的“任务说明书”——用自然语言写成、带结构化元数据、可被智能体直接解析执行的操作指南。
SKILL 文件的核心是 SKILL.md
每个 Skill 必须包含一个名为 SKILL.md 的 Markdown 文件，它由两部分组成：
-
YAML 前言（Frontmatter）：位于文件最开头，用
---包裹，定义技能身份与权限，例如：name: file-search<br>description: 在指定目录中模糊查找文件<br>version: 1.0.0<br>tags: ["file", "search"]<br>permissions: ["file-system"]<br>gates:<br> - os: ["linux", "darwin"]
- Markdown 正文：说明使用场景、触发条件、执行步骤、输入输出示例。LLM 对这种格式理解稳定，比 JSON 或 YAML 更易读、易改、易调试。
为什么用 Markdown 而不是代码文件？
这不是技术限制，而是工程选择：
- 大模型在训练中大量接触 GitHub 文档、技术博客等 Markdown 内容，对标题、列表、代码块等结构识别准确率高；
- 纯自然语言描述 + 轻量结构，让非开发者也能看懂、编辑、复用技能；
- 避免 JSON/YAML 的语法错误导致加载失败，降低入门门槛和维护成本。
SKILL 文件不只是说明书，还决定能否运行
OpenClaw 启动时会扫描所有 Skill 目录，只做一件事：先校验 SKILL.md 是否存在且 YAML 前言合法。只有通过这关，才会继续加载后续逻辑（如 scripts/ 下的脚本或 index.ts）。换句话说：
- 没有 SKILL.md → 不是 Skill；
- YAML 格式错或 permissions 缺失 → 加载失败或功能受限；
- 正文写得清楚 → AI 执行更准、出错更少。
它和 plugin.json、index.ts 是什么关系？
在进阶 Skill 中，你可能会看到这三个文件共存：
- SKILL.md：面向 AI 和人的“说明书”，决定“做什么”和“何时做”；
- plugin.json：面向 OpenClaw 运行时的“身份证”，声明权限、配置结构、兼容性等系统级信息；
- index.ts/js：面向机器的“执行体”，提供工具函数、API 调用等具体逻辑。
三者分工明确：SKILL.md 是入口和大脑，plugin.json 是通行证，index.ts 是手脚。新手从 SKILL.md 开始就足够启动一个可用技能。
