Plugin del workshop Skill

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

• Memoria archivia fatti, preferenze, entità e contesto passato.
• Skills archivia procedure riutilizzabili che l’agente dovrebbe seguire nelle attività future.
• Skill Workshop è il ponte tra un turno utile e una Skill durevole del workspace, con controlli di sicurezza e approvazione opzionale.

• come validare asset GIF animati provenienti da fonti esterne
• come sostituire asset di screenshot e verificare le dimensioni
• come eseguire uno scenario QA specifico del repository
• come eseguire il debug di un errore ricorrente di un provider
• come riparare una nota di workflow locale obsoleta

• fatti come “all’utente piace il blu”
• memoria autobiografica ampia
• archiviazione grezza delle trascrizioni
• segreti, credenziali o testo di prompt nascosto
• istruzioni una tantum che non si ripeteranno

​

Stato predefinito

• il plugin è supportato a sufficienza per test opt-in e dogfooding
• l’archiviazione delle proposte, le soglie del revisore e le euristiche di acquisizione possono evolvere
• l’approvazione pending è la modalità iniziale consigliata
• l’applicazione automatica è destinata a configurazioni personali/workspace attendibili, non ad ambienti condivisi o ostili con molti input

​

Abilitare

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

• lo strumento skill_workshop è disponibile
• le correzioni riutilizzabili esplicite vengono accodate come proposte pending
• i passaggi del revisore basati su soglie possono proporre aggiornamenti delle Skills
• nessun file Skill viene scritto finché una proposta pending non viene applicata

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

​

Configurazione

// 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",
}

​

Percorsi di acquisizione

​

Suggerimenti degli strumenti

​

Acquisizione euristica

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

• attività con GIF animate -> animated-gif-workflow
• attività con screenshot o asset -> screenshot-asset-workflow
• attività QA o di scenario -> qa-scenario-workflow
• attività PR GitHub -> github-pr-workflow
• fallback -> learned-workflows

​

Revisore LLM

• il testo della trascrizione recente, limitato agli ultimi 12.000 caratteri
• fino a 12 Skills del workspace esistenti
• fino a 2.000 caratteri da ciascuna Skill esistente
• istruzioni solo JSON

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

​

Ciclo di vita delle proposte

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

• pending - in attesa di approvazione
• applied - scritto in <workspace>/skills
• rejected - rifiutato dall’operatore/modello
• quarantined - bloccato da rilievi critici dello scanner

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

​

Riferimento dello strumento

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

​

Scritture Skill

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

• convertiti in minuscolo
• le sequenze non [a-z0-9_-] diventano -
• i caratteri non alfanumerici iniziali/finali vengono rimossi
• la lunghezza massima è 80 caratteri
• il nome finale deve corrispondere a [a-z0-9][a-z0-9_-]{1,79}

• se la skill non esiste, Skill Workshop scrive un nuovo SKILL.md
• se esiste già, Skill Workshop aggiunge il corpo a ## Workflow

• se la skill esiste, Skill Workshop aggiunge alla sezione richiesta
• se non esiste, Skill Workshop crea una skill minima e poi aggiunge

• la skill deve esistere già
• oldText deve essere presente esattamente
• viene sostituita solo la prima corrispondenza esatta

​

Modello di sicurezza

• conservano scanFindings
• conservano quarantineReason
• compaiono in list_quarantine
• non possono essere applicate tramite apply

​

Guida ai prompt

• procedure, non fatti/preferenze
• correzioni dell’utente
• procedure riuscite non ovvie
• insidie ricorrenti
• riparazione di skill obsolete/sottili/errate tramite append/replace
• salvataggio di procedure riutilizzabili dopo lunghi cicli di strumenti o correzioni difficili
• testo skill breve e imperativo
• nessun dump di trascrizioni

• modalità pending: accoda suggerimenti; usa apply dopo approvazione esplicita
• modalità auto: applica aggiornamenti sicuri delle skill del workspace, a meno che apply: false non li accodi invece

​

Costi e comportamento runtime

• usa lo stesso contesto provider/modello configurato quando disponibile
• ripiega sui valori predefiniti dell’agente runtime
• ha reviewTimeoutMs
• usa un contesto bootstrap leggero
• non ha strumenti
• non scrive nulla direttamente
• può solo emettere una proposta che passa attraverso il normale scanner e il percorso di approvazione/quarantena

​

Schemi operativi

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

• ha forma di trascrizione
• non è imperativa
• include dettagli rumorosi e una tantum
• non dice al prossimo agente cosa fare

​

Debug

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

​

Scenari 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

​

Quando non abilitare l’applicazione automatica

• il workspace contiene procedure sensibili
• l’agente sta lavorando su input non attendibile
• le skills sono condivise in un team ampio
• stai ancora regolando prompt o regole dello scanner
• il modello gestisce spesso contenuti web/email ostili

​

Documentazione correlata

• Skills
• Plugins
• Testing