name: skill-creator-plus description: "创建、编辑、优化或审查 OpenClaw AgentSkills 技能。当创建新技能或修改现有技能时触发。提供完整的工作流程指引：技能结构设计、frontmatter 规范、_meta.json 格式、ClawHub scanner 规则、渐进式披露设计、validation checklist 及发布流程。输出：SKILL.md + _meta.json。" metadata: {"openclaw":{"emoji":"🛠️","requires":{"anyBins":[]}}}}

skill-creator-plus

创建符合 ClawHub 规范的 OpenClaw 技能。按以下规则执行，不要跳过章节，不要发明规范中未列出的约定。

未提供技能名和用途时，先询问用户。

关于 Skills

Skills 是模块化、自包含的包，通过提供专业化的工作流程、工具和知识来扩展 OpenClaw 的能力。可以把 Skill 看作特定领域或任务的"入职指南"——它们将 OpenClaw 从通用 agent 转变为具备专门处理流程的 specialized agent，而这是任何模型都无法完全拥有的能力。

Skills 能提供什么

1. 专业化工作流程 — 特定领域的多步骤流程
2. 工具集成 — 操作特定文件格式或 API 的指引
3. 领域专业知识 — 公司专属知识、Schema、业务逻辑
4. 打包资源 — 复杂重复任务的脚本、参考资料和资产文件

核心原则

简洁是关键

context window 是公共资源。Skills 与 OpenClaw 所需的其他内容共享 context window：system prompt、对话历史、其他 Skills 的元数据，以及实际的用户请求。

默认假设：OpenClaw 已经非常聪明。 只添加 OpenClaw 还没有的内容。每一条信息都要质疑："OpenClaw 真的需要这个解释吗？"以及"这个段落的 token 消耗值得吗？"

用简洁的例子替代冗长的解释。

设定适当的自由度

根据任务的脆弱性和可变性匹配具体的约束程度：

高自由度（基于文本的指令）：当多种方法都可行、决策依赖上下文或启发式方法引导方案时使用。

中自由度（伪代码或带参数的脚本）：当存在优选模式、可接受一定变化或配置影响行为时使用。

低自由度（特定脚本，参数少）：当操作脆弱易错、一致性至关重要或必须遵循特定顺序时使用。

可以把 OpenClaw 想象成在探索一条路径：狭窄的悬崖桥需要具体的护栏（低自由度），而开阔的场地允许多条路线（高自由度）。

文件结构

只生成两个文件——无 README.md、无 CHANGELOG.md、无辅助文档：

[skill-name]/
├── SKILL.md       (required)
└── _meta.json     (required)

技能的结构

每个技能由一个必需的 SKILL.md 文件和可选的打包资源组成：

skill-name/
├── SKILL.md（必需）
│   ├── YAML frontmatter 元数据（必需）
│   │   ├── name:（必需）
│   │   └── description:（必需）
│   └── Markdown 说明（必需）
└── 打包资源（可选）
    ├── scripts/      - 可执行代码（Python/Bash 等）
    ├── references/   - 文档，按需加载到 context 中
    └── assets/       - 输出中使用的文件（模板、图标、字体等）

SKILL.md（必需）

每个 SKILL.md 包含：

• Frontmatter（YAML）：包含 name 和 description 字段。这是 OpenClaw 判断技能何时被使用的唯一依据。
• Body（Markdown）：技能使用说明。仅在技能触发后加载（如果需要的话）。

打包资源（可选）

Scripts（scripts/）：可执行代码，用于需要确定性可靠性或被反复重写的任务。优势：token 高效、确定性、可不加载到 context 中执行。

References（references/）：文档和参考资料，按需加载。优势：保持 SKILL.md 精简，仅在 OpenClaw 判定需要时加载。

Assets（assets/）：不打算加载到 context 中的文件，而是用于 OpenClaw 生成的输出中（模板、图片、样板代码等）。

什么不应该包含

技能应只包含直接支持其功能的必要文件。不要创建：README.md、INSTALLATION_GUIDE.md、QUICK_REFERENCE.md、CHANGELOG.md 等。

渐进式披露设计原则

Skills 使用三级加载系统来高效管理 context：

1. 元数据（name + description） — 始终在 context 中（约100词）
2. SKILL.md 正文 — 技能触发时（<5000词）
3. 打包资源 — OpenClaw 按需加载（无限量）

保持 SKILL.md 正文简洁且在500行以内以减少 context 膨胀。内容接近此限制时分拆到单独文件。

核心原则：当技能支持多种变体、框架或选项时，只在 SKILL.md 中保留核心工作流和选择指引。将变体特有细节移到单独的 reference 文件。

理解 ClawHub Scanner

在写任何内容之前，先理解 scanner 的工作方式：

1. description 摘要是 scanner 唯一信任的信息。 _meta.json 字段（requiredConfigPaths、primaryCredential、requires）被存储但不会在 registry API 中显示。scanner 需要验证的一切必须在 description 中——而且是前 ~160 字符内（registry 截断点）。

2. scanner 是迭代的——每次修复暴露下一个问题。 每个 rejected 版本都计入技能历史。在 checklist 通过之前不要发布。

3. scanner 无法验证嵌套内容。 嵌入在 here-string 或其他代码块内的脚本会被标记为截断和无法验证。所有 scanner 需要读取的内容必须是扁平的、独立的。