skill-creator

Skill Creator

Skill 是轻量化的可触发工作流。元数据（Metadata）始终可见；正文仅在触发后加载；参考文档（references）、脚本（scripts）和静态资源（assets）仅在按需时加载。

硬性规则

• 在 Agent 会话中创建或更新需要持久保存的 OpenClaw Skill 时，必须通过 skill_workshop 创建或修改待生效的提案（pending proposal）。切勿直接用 shell 命令或辅助脚本去脚手架化（scaffold）或应用生效中的 SKILL.md 文件。
• 保持 SKILL.md 精简干净；Codex 本身能力已经足够强大。
• 在 frontmatter 的 description 中只保留触发所必需的关键事实。
• frontmatter 中的 description 必须加双引号。
• frontmatter 必须包含 name 和 description；本地 OpenClaw Skill 还可以使用 metadata、homepage、allowed-tools、user-invocable、license。
• description 优先使用名词短语；写成简短通用的触发短语，不要写成完整的工作流说明。
• 把长示例和冗长文档移到 references/；脚本移到 scripts/；模板与媒体资源移到 assets/。
• Skill 内部不要放额外的 README/changelog/setup 等文档，除非它们是实际的任务参考资料。
• 编辑修改后必须校验 YAML frontmatter。

目录结构

skill-name/
  SKILL.md
  scripts/      可选的确定性辅助脚本
  references/   可选的参考文档（仅按需加载）
  assets/       可选的输出资源/模板
  agents/       可选的 UI 元数据

优秀的 SKILL.md 示例

---
name: pdf-tools
description: "Inspect, split, merge, OCR, redact, or convert PDFs with local CLI tools."
---

# PDF tools

用于处理和操作 PDF。修改页面时优先使用确定性脚本。

## 工作流

1. 检查文件信息与总页数。
2. 确定具体的操作类型。
3. 除非用户另有要求，否则将输出文件保存在输入文件同级目录下。
4. 渲染或校验修改后的页面。

编辑工作流

1. 阅读现有的 Skill 以及周边相关的资源名称。
2. 起草拟议的 SKILL.md 内容。
3. 如果修改需要作为 OpenClaw Skill 持久化保存，请通过 skill_workshop 创建或修改待生效提案。
4. 删掉基座模型已经掌握的通用废话与常识。
5. 务必保留易错/脆弱的命令语法、鉴权注意事项、安全规则以及校验步骤。
6. 尽量将表格替换为无序列表，除非该场景明显更适合使用表格。
7. 表达可以从简，使用短句或无主句即可。
8. 校验 frontmatter 并运行所有受影响的脚本测试。

校验

python skills/skill-creator/scripts/quick_validate.py skills/<name>
python - <<'PY'
from pathlib import Path
import yaml
for p in Path("skills").glob("*/SKILL.md"):
    text=p.read_text()
    if not text.startswith("---\n"):
        raise SystemExit(f"missing frontmatter: {p}")
    fm=text.split("---",2)[1]
    yaml.safe_load(fm)
print("ok")
PY

quick_validate.py 的校验规则相对保守；仓库本地的 frontmatter 可能会允许超出公开 Skill 包范围的字段 Key。