Skill workshop Plugin

<workspace>/skills/<skill-name>/SKILL.md

• Memory は、事実、好み、entity、過去のコンテキストを保存する。
• Skills は、エージェントが今後のタスクで従うべき再利用可能な手順を保存する。
• Skill Workshop は、有用なターンを永続的な workspace skill に変える橋渡しであり、安全確認と任意の承認を備える。

• 外部ソースの animated GIF asset をどう検証するか
• screenshot asset をどう置き換え、寸法を確認するか
• repo 固有の QA シナリオをどう実行するか
• 繰り返し発生する provider 障害をどうデバッグするか
• 古くなったローカル workflow note をどう修復するか

• 「ユーザーは青が好き」のような事実
• 広範な自伝的 memory
• 生のトランスクリプト保存
• シークレット、認証情報、または隠し prompt text
• 繰り返されない一度きりの指示

​

デフォルト状態

• この Plugin はオプトインのテストと dogfooding には十分サポートされている
• proposal ストレージ、reviewer しきい値、capture ヒューリスティクスは進化し得る
• 推奨される開始モードは pending approval
• auto apply は、共有環境や hostile な入力が多い環境ではなく、信頼できる個人/workspace 構成向け

​

有効化

{
  plugins: {
    entries: {
      "skill-workshop": {
        enabled: true,
        config: {
          autoCapture: true,
          approvalPolicy: "pending",
          reviewMode: "hybrid",
        },
      },
    },
  },
}

• skill_workshop ツールが利用可能になる
• 明示的な再利用可能修正が pending proposal としてキューされる
• しきい値ベースの reviewer pass が skill 更新を提案できる
• pending proposal が適用されるまで skill file は書き込まれない

{
  plugins: {
    entries: {
      "skill-workshop": {
        enabled: true,
        config: {
          autoCapture: true,
          approvalPolicy: "auto",
          reviewMode: "hybrid",
        },
      },
    },
  },
}

​

設定

// 保守的: 明示的なツール使用のみ、自動 capture なし。
{
  autoCapture: false,
  approvalPolicy: "pending",
  reviewMode: "off",
}

// Review-first: 自動で capture するが、承認が必要。
{
  autoCapture: true,
  approvalPolicy: "pending",
  reviewMode: "hybrid",
}

// Trusted automation: 安全な proposal を即時書き込む。
{
  autoCapture: true,
  approvalPolicy: "auto",
  reviewMode: "hybrid",
}

// Low-cost: reviewer LLM 呼び出しなし、明示的修正フレーズのみ。
{
  autoCapture: true,
  approvalPolicy: "pending",
  reviewMode: "heuristic",
}

​

capture 経路

​

ツール提案

​

ヒューリスティック capture

• next time
• from now on
• remember to
• make sure to
• always ... use/check/verify/record/save/prefer
• prefer ... when/for/instead/use
• when asked

• animated GIF タスク -> animated-gif-workflow
• screenshot または asset タスク -> screenshot-asset-workflow
• QA または scenario タスク -> qa-scenario-workflow
• GitHub PR タスク -> github-pr-workflow
• fallback -> learned-workflows

​

LLM reviewer

• 最近のトランスクリプト text（最後の 12,000 文字までに制限）
• 最大 12 個の既存 workspace Skills
• 各既存 skill から最大 2,000 文字
• JSON-only 指示

• disableTools: true
• toolsAllow: []
• disableMessageTool: true

{
  "action": "create",
  "skillName": "media-asset-qa",
  "title": "Media Asset QA",
  "reason": "Reusable animated media acceptance workflow",
  "description": "Validate externally sourced animated media before product use.",
  "body": "## Workflow\n\n- Verify true animation.\n- Record attribution.\n- Store a local approved copy.\n- Verify in product UI before final reply."
}

​

proposal ライフサイクル

• id
• createdAt
• updatedAt
• workspaceDir
• 任意の agentId
• 任意の sessionId
• skillName
• title
• reason
• source: tool, agent_end, または reviewer
• status
• change
• 任意の scanFindings
• 任意の quarantineReason

• pending - 承認待ち
• applied - <workspace>/skills に書き込み済み
• rejected - operator/model によって拒否済み
• quarantined - critical scanner finding によりブロック済み

<stateDir>/skill-workshop/<workspace-hash>.json

​

ツールリファレンス

skill_workshop

​

status

{ "action": "status" }

{
  "workspaceDir": "/path/to/workspace",
  "pending": 1,
  "quarantined": 0,
  "applied": 3,
  "rejected": 0
}

​

list_pending

{ "action": "list_pending" }

{ "action": "list_pending", "status": "applied" }

• pending
• applied
• rejected
• quarantined

​

list_quarantine

{ "action": "list_quarantine" }

​

inspect

{
  "action": "inspect",
  "id": "proposal-id"
}

​

suggest

{
  "action": "suggest",
  "skillName": "animated-gif-workflow",
  "title": "Animated GIF Workflow",
  "reason": "User established reusable GIF validation rules.",
  "description": "Validate animated GIF assets before using them.",
  "body": "## Workflow\n\n- Verify the URL resolves to image/gif.\n- Confirm it has multiple frames.\n- Record attribution and license.\n- Avoid hotlinking when a local asset is needed."
}

{
  "action": "suggest",
  "apply": true,
  "skillName": "animated-gif-workflow",
  "description": "Validate animated GIF assets before using them.",
  "body": "## Workflow\n\n- Verify true animation.\n- Record attribution."
}

{
  "action": "suggest",
  "apply": false,
  "skillName": "screenshot-asset-workflow",
  "description": "Screenshot replacement workflow.",
  "body": "## Workflow\n\n- Verify dimensions.\n- Optimize the PNG.\n- Run the relevant gate."
}

{
  "action": "suggest",
  "skillName": "qa-scenario-workflow",
  "section": "Workflow",
  "description": "QA scenario workflow.",
  "body": "- For media QA, verify generated assets render and pass final assertions."
}

{
  "action": "suggest",
  "skillName": "github-pr-workflow",
  "oldText": "- Check the PR.",
  "newText": "- Check unresolved review threads, CI status, linked issues, and changed files before deciding."
}

​

apply

{
  "action": "apply",
  "id": "proposal-id"
}

quarantined proposal cannot be applied

​

reject

{
  "action": "reject",
  "id": "proposal-id"
}

​

write_support_file

• references/
• templates/
• scripts/
• assets/

{
  "action": "write_support_file",
  "skillName": "release-workflow",
  "relativePath": "references/checklist.md",
  "body": "# Release Checklist\n\n- Run release docs.\n- Verify changelog.\n"
}

​

skill 書き込み

<workspace>/skills/<normalized-skill-name>/

• 小文字化される
• [a-z0-9_-] 以外の連続は - になる
• 先頭/末尾の非英数字は削除される
• 最大長は 80 文字
• 最終名は [a-z0-9][a-z0-9_-]{1,79} に一致しなければならない

• skill が存在しなければ、新しい SKILL.md を書き込む
• すでに存在する場合は、body を ## Workflow に追記する

• skill が存在すれば、要求された section に追記する
• 存在しなければ、最小限の skill を作成してから追記する

• skill はすでに存在していなければならない
• oldText は完全一致で存在していなければならない
• 最初の完全一致のみが置き換えられる

​

安全モデル

• scanFindings を保持する
• quarantineReason を保持する
• list_quarantine に表示される
• apply 経由では適用できない

​

prompt ガイダンス

• 事実/好みではなく手順
• ユーザー修正
• 明白ではない成功手順
• 繰り返し起こる落とし穴
• append/replace による古い/薄い/誤った skill の修復
• 長いツールループや難しい修正の後に再利用可能手順を保存すること
• 短い命令形の skill text
• トランスクリプト dump をしないこと

• pending mode: 提案をキューし、明示的な承認後にのみ適用する
• auto mode: 明確に再利用可能な場合に安全な workspace-skill 更新を適用する

​

コストとランタイム挙動

• 利用可能な場合、同じ設定済み provider/model context を使用する
• runtime agent デフォルトにフォールバックする
• reviewTimeoutMs を持つ
• 軽量な bootstrap context を使用する
• ツールを持たない
• 直接は何も書き込まない
• 通常の scanner と approval/quarantine 経路を通る proposal しか出力できない

​

運用パターン

• “next time, do X”
• “from now on, prefer Y”
• “make sure to verify Z”
• “save this as a workflow”
• “this took a while; remember the process”
• “update the local skill for this”

## Workflow

- Verify the GIF URL resolves to `image/gif`.
- Confirm the file has multiple frames.
- Record source URL, license, and attribution.
- Store a local copy when the asset will ship with the product.
- Verify the local asset renders in the target UI before final reply.

The user asked about a GIF and I searched two websites. Then one was blocked by
Cloudflare. The final answer said to check attribution.

• transcript 形になっている
• 命令形ではない
• ノイズとなる一度きりの詳細を含んでいる
• 次のエージェントに何をすべきかを伝えていない

​

デバッグ

openclaw plugins list --enabled

{ "action": "status" }

{ "action": "list_pending" }

{ "action": "list_quarantine" }

• skill-workshop: queued <skill>
• skill-workshop: applied <skill>
• skill-workshop: quarantined <skill>
• skill-workshop: heuristic capture skipped: ...
• skill-workshop: reviewer skipped: ...
• skill-workshop: reviewer found no update

​

QA シナリオ

• qa/scenarios/plugins/skill-workshop-animated-gif-autocreate.md
• qa/scenarios/plugins/skill-workshop-pending-approval.md
• qa/scenarios/plugins/skill-workshop-reviewer-autonomous.md

pnpm openclaw qa suite \
  --scenario skill-workshop-animated-gif-autocreate \
  --scenario skill-workshop-pending-approval \
  --concurrency 1

pnpm openclaw qa suite \
  --scenario skill-workshop-reviewer-autonomous \
  --concurrency 1

​

auto apply を有効にしないほうがよい場合

• workspace に機密性の高い手順が含まれる
• エージェントが信頼できない入力を処理している
• skills が広いチームで共有されている
• まだ prompt や scanner rule を調整中である
• モデルが hostile な web/email content を頻繁に扱う

​

関連ドキュメント

• Skills
• Plugins
• Testing