Skill Refiner

在工作区中查找所有 Skill，依据 skill-creator 规范逐个审计，并自动修复不合规的 Skill。

工作流

步骤 1 — 发现所有 Skill

bash scripts/find_skills.sh [workspace_dir]

该命令在整个工作区（而不仅限于 skills/ 目录）中搜索 SKILL.md 文件。未遵循 skill-creator 规范创建的 Skill 可能位于任意位置。

步骤 2 — 审计每个 Skill

python3 scripts/audit_skill.py 

输出 JSON 格式结果，包含以下字段：

• issues — 致命问题，必须修复
• warnings — 建议性改进建议
• compliant — 仅当 issues 为空时为 true

对步骤 1 返回的每个路径依次执行该命令。批量运行示例：

bash scripts/find_skills.sh | while read dir; do
  python3 scripts/audit_skill.py "$dir"
done

步骤 3 — 汇总审计结果

以表格形式汇总结果：

步骤 4 — 修复不合规的 Skill

针对存在 issues 的每个 Skill，按如下顺序进行修复：

1. 缺失或格式错误的 frontmatter — 添加或修正 --- 包裹的 YAML frontmatter，且仅保留 name 和 description 两个字段
2. 多余的 frontmatter 字段 — 删除除 name 和 description 外的所有字段
3. 描述薄弱 — 重写 description，明确说明该 Skill 的功能及触发条件（例如：“Use when...”）
4. 冗余文件 — 删除 README.md、INSTALLATION_GUIDE.md、CHANGELOG.md 等非必需文件
5. 位置错误 — 若 Skill 不在 skills/ 目录下，则将其移至 ~/.openclaw/workspace/skills//
6. 命名违规 — 将目录名重命名为小写字母、数字与短横线（lowercase-hyphen-case）组合的形式

对于 warnings（建议性提示），可参考以下改进方式：

• SKILL.md 过长（>500 行）：将详细内容提取至 references/ 子目录下的独立文件，并在 SKILL.md 中添加对应链接
• 引用文件未被链接：在 SKILL.md 正文中补充对 references/ 中各文件的链接
• 描述薄弱：优化触发条件的表述语言

步骤 5 — 验证修复结果

对每个已修复的 Skill 重新运行 audit_skill.py，确认其输出中 "compliant": true。

（可选）使用以下命令打包 Skill：

python3 /opt/homebrew/lib/node_modules/openclaw/skills/skill-creator/scripts/package_skill.py 

合规性检查清单

一个合规的 Skill 必须满足以下全部条件：

• 在具名目录的根路径下存在 SKILL.md 文件
• YAML frontmatter 中仅包含且必须包含 name 和 description 两个字段（不可多、不可少）
• description 需同时说明该 Skill 的功能和适用触发场景
• 目录名仅允许小写字母、数字和短横线；长度不超过 64 个字符
• 不得包含冗余文件（如 README.md、CHANGELOG.md 等）
• 所有资源文件仅可置于 scripts/、references/ 或 assets/ 子目录中
• references/ 下所有文件均需在 SKILL.md 正文中被显式链接
• SKILL.md 正文行数 ≤500 行（超出部分应拆分至 references/）