SKILL.md 优化工具 / optimize-skill-md

简介

一键对照《Skills MD 标准书写格式》，对任意 SKILL.md 进行描述质量、章节结构、内容简洁度与格式规范的全方位优化，让技能文档更规范、更易被 Agent 准确匹配。

核心价值

描述提质：自动修复 YAML description，确保第三人称、WHAT + WHEN、触发词齐全，提升 Agent 触发准确率。
结构规范：强制简介 + 功能特性 + 鉴权章节开头，重组/合并/删除空壳章节，文档层次清晰。
降本增效：精简冗余科普与重复说明，降低 token 开销，保持主体 ≤ 500 行。

适用对象

🛠️ Skill 开发者 — 快速将手写或历史 SKILL.md 规范化，省去逐条对照检查的时间。
📦 技能维护者 — 批量统一术语、格式与章节结构，保持技能库整体一致性。
🆕 新手 Skill 作者 — 首次编写 SKILL.md 时获得结构引导，避免常见反模式。

功能特性

核心功能

YAML 描述修复：自动补全第三人称描述、触发场景与触发词，控制 1024 字符以内。
章节结构重组：强制「📝 简介 + ✨ 功能特性 + 🔑 鉴权」开头，合并短章节、拆分长章节、删除空壳章节。
冗余内容精简：删除基础知识科普、重复说明、冗余修饰词，保留核心业务规则与约束。
格式统一规范：术语全文一致、代码块标注语言类型、路径使用正斜杠、表格对齐。
渐进式重构：超过 500 行时自动建议将详细信息外移至 references/ 目录，主体保持精简。
鉴权章节检查：缺失「🔑 鉴权」章节时自动按标准模板插入，确保 API Key 配置说明可见。

密钥获取与安全说明

本技能内置公共 API Key，约 10000 次免费额度，零配置直接用。
额度用完后，前往红狐 hub 注册获取个人 REDFOX_API_KEY。
配置方式：终端执行 export REDFOX_API_KEY="ak_xxxx..."，或写入配置文件（如 ~/.openclaw/openclaw.json）。
禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。

使用指南

直接用自然语言描述你的优化需求即可，无需记忆命令。

常用说法速查

| 意图 | 示例话术 | 效果 | |------|---------|------| | 优化指定技能 | 「帮我优化 xxx 技能的 SKILL.md」 | 读取目标 SKILL.md，全面评估并输出优化版本 | | 检查格式规范 | 「检查一下这个 SKILL.md 是否符合标准格式」 | 按维度逐项核对，列出问题清单并给出修改建议 | | 修复描述字段 | 「这个 skill 的 description 太笼统，帮我改好」 | 重写为第三人称 + WHAT + WHEN + 触发词格式 | | 补全鉴权章节 | 「SKILL.md 缺少鉴权说明，帮我加上」 | 自动在功能特性之后插入标准鉴权章节模板 |

使用场景

| 场景 | 角色 | 示例问法 | 收益 | |------|------|---------|------| | 新技能首版打磨 | Skill 开发者 | 「我刚写好了 SKILL.md，帮我检查并优化」 | 首次提交前即符合标准，减少返工 | | 历史技能批量治理 | 技能维护者 | 「这几个老 skill 的 SKILL.md 需要统一格式」 | 批量对齐规范，技能库整体质量提升 | | 描述字段专项修复 | Skill 开发者 | 「description 触发率太低，帮我优化」 | 补全触发词，提升 Agent 匹配准确率 | | 文档瘦身 | Skill 开发者 | 「SKILL.md 超过 500 行了，帮我精简」 | 外移详细信息，主体保持精简可控 |