skill-creator

Skill Creator

Skill 是精簡且可觸發的工作流程。Metadata 隨時可見；正文僅在觸發後載入；references/scripts/assets 則按需載入。

硬性規則

• 若要在 Agent Session 中持久建立或更新 OpenClaw Skill，請使用 skill_workshop 建立或修改待處理的提案。請勿直接透過 Shell 指令或輔助腳本搭建或套用即時生效的 SKILL.md 檔案。
• 保持 SKILL.md 精簡；Codex 本身已具備足夠能力。
• frontmatter 的 description 僅放置觸發關鍵的必要資訊。
• frontmatter 的 description 必須加上雙引號。
• frontmatter 需包含 name + description；本機 OpenClaw Skill 亦可使用 metadata、homepage、allowed-tools、user-invocable、license。
• 描述句優先使用名詞短語；採用簡短通用的觸發詞，而非完整工作流程描述。
• 將長篇範例/文件移至 references/；腳本移至 scripts/；範本/多媒體檔案移至 assets/。
• Skill 內部除非是實際的任務參考資料，否則無需附帶額外的 README/changelog/setup 等文件。
• 編輯後請驗證 YAML frontmatter 的格式。

結構

skill-name/
  SKILL.md
  scripts/      可選的確定性輔助腳本
  references/   可選，僅在需要時載入的文件
  assets/       可選的輸出資源/範本
  agents/       可選的 UI Metadata

優良 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. 移除基底模型（Base model）已經掌握的通用建議。
5. 保留嚴格的命令語法、驗證注意事項、安全規則與驗證步驟。
6. 除非明顯需要表格，否則將表格替換為項目符號列表。
7. 語氣放鬆；使用短語片段（fragments）亦可。
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 包的鍵值（keys）。