Skill-Workshop-Plugin

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

• Gedächtnis speichert Fakten, Präferenzen, Entitäten und früheren Kontext.
• Skills speichern wiederverwendbare Verfahren, die der Agent bei zukünftigen Aufgaben befolgen sollte.
• Skill Workshop ist die Brücke von einem nützlichen Durchlauf zu einem dauerhaften Workspace-Skill, mit Sicherheitsprüfungen und optionaler Genehmigung.

• wie extern bezogene animierte GIF-Assets validiert werden
• wie Screenshot-Assets ersetzt und Abmessungen verifiziert werden
• wie ein repo-spezifisches QA-Szenario ausgeführt wird
• wie ein wiederkehrender Provider-Fehler debuggt wird
• wie eine veraltete lokale Workflow-Notiz repariert wird

• Fakten wie „der Benutzer mag Blau“
• breite autobiografische Erinnerung
• rohe Transkriptarchivierung
• Secrets, Anmeldedaten oder versteckten Prompt-Text
• einmalige Anweisungen, die sich nicht wiederholen werden

​

Standardzustand

• das Plugin wird ausreichend für Opt-in-Tests und Dogfooding unterstützt
• Vorschlagsspeicherung, Reviewer-Schwellenwerte und Erfassungsheuristiken können sich weiterentwickeln
• ausstehende Genehmigung ist der empfohlene Startmodus
• automatische Anwendung ist für vertrauenswürdige persönliche oder Workspace-Setups gedacht, nicht für gemeinsam genutzte oder feindliche Umgebungen mit viel Eingabe

​

Aktivieren

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

• ist das Tool skill_workshop verfügbar
• werden explizite wiederverwendbare Korrekturen als ausstehende Vorschläge eingereiht
• können schwellenwertbasierte Reviewer-Durchläufe Skill-Updates vorschlagen
• wird keine Skill-Datei geschrieben, bis ein ausstehender Vorschlag angewendet wird

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

​

Konfiguration

// Conservative: explicit tool use only, no automatic capture.
{
  autoCapture: false,
  approvalPolicy: "pending",
  reviewMode: "off",
}

// Review-first: capture automatically, but require approval.
{
  autoCapture: true,
  approvalPolicy: "pending",
  reviewMode: "hybrid",
}

// Trusted automation: write safe proposals immediately.
{
  autoCapture: true,
  approvalPolicy: "auto",
  reviewMode: "hybrid",
}

// Low-cost: no reviewer LLM call, only explicit correction phrases.
{
  autoCapture: true,
  approvalPolicy: "pending",
  reviewMode: "heuristic",
}

​

Erfassungspfade

​

Tool-Vorschläge

​

Heuristische Erfassung

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

• Aufgaben mit animierten GIFs -> animated-gif-workflow
• Screenshot- oder Asset-Aufgaben -> screenshot-asset-workflow
• QA- oder Szenarioaufgaben -> qa-scenario-workflow
• GitHub-PR-Aufgaben -> github-pr-workflow
• Fallback -> learned-workflows

​

LLM-Reviewer

• den aktuellen Transkripttext, begrenzt auf die letzten 12.000 Zeichen
• bis zu 12 vorhandene Workspace-Skills
• bis zu 2.000 Zeichen aus jedem vorhandenen Skill
• reine JSON-Anweisungen

• 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."
}

​

Vorschlagslebenszyklus

• id
• createdAt
• updatedAt
• workspaceDir
• optionalem agentId
• optionalem sessionId
• skillName
• title
• reason
• source: tool, agent_end oder reviewer
• status
• change
• optionalen scanFindings
• optionalem quarantineReason

• pending - wartet auf Genehmigung
• applied - nach <workspace>/skills geschrieben
• rejected - vom Operator/Modell abgelehnt
• quarantined - durch kritische Scanner-Befunde blockiert

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

​

Tool-Referenz

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-Schreibvorgänge

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

• in Kleinbuchstaben umgewandelt
• Folgen von Nicht-[a-z0-9_-] werden zu -
• führende/abschließende Nicht-Alphanumerika werden entfernt
• die maximale Länge beträgt 80 Zeichen
• der endgültige Name muss [a-z0-9][a-z0-9_-]{1,79} entsprechen

• wenn der Skill nicht existiert, schreibt Skill Workshop eine neue SKILL.md
• wenn er bereits existiert, hängt Skill Workshop den Body an ## Workflow an

• wenn der Skill existiert, hängt Skill Workshop an den angeforderten Abschnitt an
• wenn er nicht existiert, erstellt Skill Workshop einen minimalen Skill und hängt dann an

• der Skill muss bereits existieren
• oldText muss exakt vorhanden sein
• nur der erste exakte Treffer wird ersetzt

​

Sicherheitsmodell

• behalten scanFindings
• behalten quarantineReason
• erscheinen in list_quarantine
• können nicht über apply angewendet werden

​

Prompt-Anleitung

• Verfahren, nicht Fakten/Präferenzen
• Korrekturen durch Benutzer
• nicht offensichtliche erfolgreiche Verfahren
• wiederkehrende Fallstricke
• Reparatur veralteter/dünner/falscher Skills durch Anhängen/Ersetzen
• Speichern wiederverwendbarer Verfahren nach langen Tool-Schleifen oder schwierigen Korrekturen
• kurze imperative Skill-Texte
• keine Transkript-Dumps

• Pending-Modus: Vorschläge in die Warteschlange stellen; apply nach ausdrücklicher Genehmigung verwenden
• Auto-Modus: sichere Workspace-Skill-Aktualisierungen anwenden, sofern nicht apply: false stattdessen in die Warteschlange stellt

​

Kosten und Laufzeitverhalten

• verwendet den gleichen konfigurierten Provider-/Modellkontext, wenn verfügbar
• fällt auf Runtime-Agent-Standards zurück
• hat reviewTimeoutMs
• verwendet leichtgewichtigen Bootstrap-Kontext
• hat keine Tools
• schreibt nichts direkt
• kann nur einen Vorschlag ausgeben, der den normalen Scanner- und Genehmigungs-/Quarantänepfad durchläuft

​

Betriebsmuster

• “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.

• transkriptförmig
• nicht imperativ
• enthält störende einmalige Details
• sagt dem nächsten Agent nicht, was zu tun ist

​

Debugging

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-Szenarien

• 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

​

Wann Auto-Anwendung nicht aktiviert werden sollte

• der Workspace sensible Verfahren enthält
• der Agent mit nicht vertrauenswürdiger Eingabe arbeitet
• Skills in einem breiten Team geteilt werden
• Sie Prompts oder Scanner-Regeln noch abstimmen
• das Modell häufig feindliche Web-/E-Mail-Inhalte verarbeitet

​

Zugehörige Dokumentation

• Skills
• Plugins
• Testing