Plugin d’atelier 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

• Mémoire stocke des faits, des préférences, des entités et du contexte passé.
• Skills stockent des procédures réutilisables que l’agent doit suivre lors de tâches futures.
• Skill Workshop est le pont entre un échange utile et un Skill d’espace de travail durable, avec des contrôles de sécurité et une approbation facultative.

• comment valider des ressources GIF animées provenant de sources externes
• comment remplacer des ressources de capture d’écran et vérifier les dimensions
• comment exécuter un scénario QA propre au dépôt
• comment déboguer une défaillance récurrente de fournisseur
• comment réparer une note de workflow local obsolète

• des faits comme « l’utilisateur aime le bleu »
• une mémoire autobiographique générale
• l’archivage brut de transcriptions
• des secrets, des identifiants ou du texte de prompt masqué
• des instructions ponctuelles qui ne se répéteront pas

​

État par défaut

• le Plugin est suffisamment pris en charge pour les tests opt-in et le dogfooding
• le stockage des propositions, les seuils de révision et les heuristiques de capture peuvent évoluer
• l’approbation en attente est le mode de départ recommandé
• l’application automatique est destinée aux configurations personnelles ou d’espace de travail de confiance, pas aux environnements partagés ou hostiles recevant beaucoup d’entrées

​

Activer

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

• l’outil skill_workshop est disponible
• les corrections réutilisables explicites sont mises en file comme propositions en attente
• les passes de révision basées sur des seuils peuvent proposer des mises à jour de Skills
• aucun fichier de Skill n’est écrit tant qu’une proposition en attente n’est pas appliquée

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

​

Configuration

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

​

Chemins de capture

​

Suggestions d’outils

​

Capture heuristique

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

• tâches de GIF animés -> animated-gif-workflow
• tâches de capture d’écran ou de ressources -> screenshot-asset-workflow
• tâches QA ou de scénario -> qa-scenario-workflow
• tâches de PR GitHub -> github-pr-workflow
• repli -> learned-workflows

​

Réviseur LLM

• le texte récent de la transcription, limité aux 12 000 derniers caractères
• jusqu’à 12 Skills d’espace de travail existants
• jusqu’à 2 000 caractères de chaque Skill existant
• des instructions JSON uniquement

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

​

Cycle de vie des propositions

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

• pending - en attente d’approbation
• applied - écrit dans <workspace>/skills
• rejected - rejeté par l’opérateur/le modèle
• quarantined - bloqué par des résultats critiques du scanner

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

​

Référence de l’outil

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

​

Écritures de Skills

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

• convertis en minuscules
• les séquences non [a-z0-9_-] deviennent -
• les caractères non alphanumériques de début/fin sont supprimés
• la longueur maximale est de 80 caractères
• le nom final doit correspondre à [a-z0-9][a-z0-9_-]{1,79}

• si la skill n’existe pas, Skill Workshop écrit un nouveau SKILL.md
• si elle existe déjà, Skill Workshop ajoute le corps à ## Workflow

• si la skill existe, Skill Workshop ajoute à la section demandée
• si elle n’existe pas, Skill Workshop crée une skill minimale puis ajoute le contenu

• la skill doit déjà exister
• oldText doit être présent exactement
• seule la première correspondance exacte est remplacée

​

Modèle de sécurité

• conservent scanFindings
• conservent quarantineReason
• apparaissent dans list_quarantine
• ne peuvent pas être appliquées via apply

​

Conseils de prompt

• les procédures, pas les faits/préférences
• les corrections de l’utilisateur
• les procédures réussies non évidentes
• les pièges récurrents
• la réparation des skills obsolètes/minces/erronées via append/replace
• l’enregistrement d’une procédure réutilisable après de longues boucles d’outils ou des corrections difficiles
• un texte de skill court et impératif
• aucun vidage de transcription

• mode pending : mettre les suggestions en file d’attente ; utiliser apply après approbation explicite
• mode auto : appliquer les mises à jour de skills d’espace de travail sûres, sauf si apply: false les met plutôt en file d’attente

​

Coûts et comportement d’exécution

• utilise le même contexte fournisseur/modèle configuré lorsqu’il est disponible
• se rabat sur les valeurs par défaut de l’agent d’exécution
• possède reviewTimeoutMs
• utilise un contexte d’amorçage léger
• n’a aucun outil
• n’écrit rien directement
• ne peut qu’émettre une proposition qui passe par le chemin normal d’analyse et d’approbation/quarantaine

​

Schémas d’utilisation

• « la prochaine fois, fais X »
• « à partir de maintenant, préfère Y »
• « assure-toi de vérifier Z »
• « enregistre ceci comme workflow »
• « cela a pris du temps ; mémorise le processus »
• « mets à jour la skill locale pour ceci »

## 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.

• en forme de transcription
• non impérative
• inclut des détails ponctuels bruyants
• n’indique pas au prochain agent quoi faire

​

Débogage

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

​

Scénarios 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

​

Quand ne pas activer l’application automatique

• l’espace de travail contient des procédures sensibles
• l’agent travaille sur une entrée non fiable
• les skills sont partagées au sein d’une grande équipe
• vous ajustez encore les prompts ou les règles de l’analyseur
• le modèle traite fréquemment du contenu web/e-mail hostile

​

Docs associés

• Skills
• Plugins
• Tests