Skill Creator — 技能创建者

OpenClaw 技能创建器 创建、改进和维护 OpenClaw AgentSkills。本指南涵盖了从模式提取到测试的整个生命周期。

为什么存在这个技能 OpenClaw 技能不仅仅是简单的提示文件。为 OpenClaw 的架构设计的技能——3 层加载（描述 → 正文 → 参考资料）、子代理上下文注入、第 0 阶段分析——显著提高了代理质量。本技能系统化了这些设计原则，并提供了 5 种类型（管道、单任务、工具集成、代码生成、文档转换）的验证示例。

语言政策 SKILL.md 正文：始终使用英语——这确保技能在所有语言环境中都可以使用 参考资料/：默认为英语。可以提供本地化副本，例如 filename.ko.md、filename.ja.md、filename.zh.md 描述关键词：在所有目标语言中（英语、韩语、日语、中文）包含关键词 生成技能：遵循相同的政策——英语正文、多语言关键词

关键优势 OpenClaw 原生模式——针对 OpenClaw 架构优化：子代理上下文 fork、参考资料/延迟加载、第 0 阶段结构分析 5 种验证类型——示例/包括每种类型的实际生成技能和案例分析 风格指南中心——技能指定“保留什么”和“压缩什么”以确定代理质量 技能审计集成——使用技能审计验证生成技能以获取 0-100 分和改进建议 捆绑技能移植——将现有的基于 Codex 的捆绑技能移植到 OpenClaw 模式的检查清单

OpenClaw 技能解剖 skill-name/ ├── SKILL.md # 必需。前置内容 + 指令。 ├── references/ # 可选。代理按需加载。 │ ├── output-format.md # 输出规范 │ └── subagent-prompt-templates.md # 子代理提示模板 ├── scripts/ # 可选。可执行代码（Python/Bash 等）。 │ ├── extract_epub.py │ └── extract_pdf.py ├── assets/ # 可选。输出中使用的文件，不加载到上下文中。 │ └── template.html └── examples/ # 可选。参考示例文件。 不要创建：README.md、CHANGELOG.md、INSTALLATION_GUIDE.md、QUICK_REFERENCE.md、LICENSE 或类似的辅助文档。

前置内容（必需） --- name: skill-name description: > 该技能的作用和触发时机。包含多语言关键词。 Keywords: keyword1, keyword2, 키워드1, 키워드2。 --- name：小写，仅使用连字符。少于 64 个字符。首选短小的、以动词开头的名称。 description：这是主要的触发机制。OpenClaw 读取此内容以决定何时加载技能。包括： 该技能的作用 何时使用（触发器、上下文） 所有相关语言的关键词（本地化 + 英语） 不要将“何时使用”信息放在正文中——它仅在触发后加载。

加载架构 OpenClaw 以三层加载技能： 元数据（名称 + 描述）——始终在上下文中。每个技能约 100 个字。 SKILL.md 正文——在技能触发时加载。保持在 500 行以内。 references/——在代理决定需要时按需加载。 含义：描述中的每个字都始终会花费令牌。保持简洁。SKILL.md 中的每个字在技能触发时都会花费令牌。保持精简。

技能创建：5 步过程 步骤 1：分析“做得好”的结果 在编写任何内容之前，分析代理在没有技能的情况下执行任务的示例。问： 输出的结构是什么？ 代理保留了什么（示例、隐喻、引用、数据）？ 代理压缩了什么（重复、冗长的解释）？ 代理做了什么判断（分组、优先级、重构）？ 为什么代理做出了这些判断？ 此分析成为风格指南。这是最重要的步骤。仅指定格式而不指定风格的技能会产生枯燥、平庸的结果。

步骤 2：分析“失败”的结果（如果可用） 如果子代理或以前的技能版本产生了坏结果，找出到底出了什么问题： 症状 可能的原因 输出枯燥/平淡 缺少风格指南——没有“保留什么”规则 流程断开 独立处理块——缺少第 0 阶段上下文注入 重复很多 缺少合并/重构指令 风格不一致 没有在子代理提示中添加风格规则 子代理忽略指令 子代理提示缺少第 0 阶段的上下文 每个失败都映射到要添加到技能的特定指令。

步骤 3：编写风格指南 先编写风格指南，然后编写工作流程。工作流程是“什么顺序”——风格指南是“如何判断”。

风格指南

本质

• 该任务的核心是什么？（例如，“总结是重构，而不是压缩。”）
• 代理应该采取什么视角？

保留标准（永远不要丢弃）

• 具体示例，附有“为什么”

压缩标准（什么需要减少）

• 指定要减少的内容