Plugin de taller de Skills

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 almacena hechos, preferencias, entidades y contexto pasado.
• Skills almacenan procedimientos reutilizables que el agente debe seguir en tareas futuras.
• Skill Workshop es el puente entre un turno útil y una Skill duradera del espacio de trabajo, con comprobaciones de seguridad y aprobación opcional.

• cómo validar recursos GIF animados de origen externo
• cómo reemplazar recursos de captura de pantalla y verificar dimensiones
• cómo ejecutar un escenario de QA específico del repositorio
• cómo depurar un fallo recurrente de proveedor
• cómo reparar una nota obsoleta de flujo de trabajo local

• hechos como “al usuario le gusta el azul”
• memoria autobiográfica amplia
• archivado sin procesar de transcripciones
• secretos, credenciales o texto oculto de prompts
• instrucciones puntuales que no se repetirán

​

Estado predeterminado

• el Plugin tiene soporte suficiente para pruebas con activación explícita y pruebas internas en uso real
• el almacenamiento de propuestas, los umbrales del revisor y las heurísticas de captura pueden evolucionar
• la aprobación pendiente es el modo inicial recomendado
• la aplicación automática es para configuraciones personales/de espacio de trabajo de confianza, no para entornos compartidos u hostiles con mucho contenido de entrada

​

Habilitar

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

• la herramienta skill_workshop está disponible
• las correcciones reutilizables explícitas se ponen en cola como propuestas pendientes
• las revisiones basadas en umbrales pueden proponer actualizaciones de Skills
• no se escribe ningún archivo de Skill hasta que se aplica una propuesta pendiente

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

​

Configuración

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

​

Rutas de captura

​

Sugerencias de herramientas

​

Captura heurística

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

• tareas de GIF animados -> animated-gif-workflow
• tareas de capturas de pantalla o recursos -> screenshot-asset-workflow
• tareas de QA o escenarios -> qa-scenario-workflow
• tareas de PR de GitHub -> github-pr-workflow
• alternativa -> learned-workflows

​

Revisor LLM

• el texto reciente de la transcripción, limitado a los últimos 12.000 caracteres
• hasta 12 Skills existentes del espacio de trabajo
• hasta 2.000 caracteres de cada Skill existente
• instrucciones solo en 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 de vida de las propuestas

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

• pending: esperando aprobación
• applied: escrito en <workspace>/skills
• rejected: rechazado por el operador/modelo
• quarantined: bloqueado por hallazgos críticos del escáner

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

​

Referencia de herramientas

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

​

Escrituras de Skill

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

• se convierten a minúsculas
• las secuencias que no sean [a-z0-9_-] pasan a ser -
• se eliminan los caracteres no alfanuméricos iniciales/finales
• la longitud máxima es de 80 caracteres
• el nombre final debe coincidir con [a-z0-9][a-z0-9_-]{1,79}

• si la Skill no existe, Skill Workshop escribe un nuevo SKILL.md
• si ya existe, Skill Workshop añade el cuerpo a ## Workflow

• si la Skill existe, Skill Workshop añade contenido a la sección solicitada
• si no existe, Skill Workshop crea una Skill mínima y luego añade contenido

• la Skill ya debe existir
• oldText debe estar presente exactamente
• solo se reemplaza la primera coincidencia exacta

​

Modelo de seguridad

• conservan scanFindings
• conservan quarantineReason
• aparecen en list_quarantine
• no se pueden aplicar mediante apply

​

Guía de prompt

• procedimientos, no datos/preferencias
• correcciones del usuario
• procedimientos exitosos no evidentes
• errores recurrentes
• reparación de Skills obsoletas/superficiales/incorrectas mediante append/replace
• guardar procedimientos reutilizables después de bucles largos con herramientas o arreglos difíciles
• texto breve e imperativo para Skills
• sin volcados de transcripciones

• modo pendiente: poner sugerencias en cola; usar apply tras aprobación explícita
• modo automático: aplicar actualizaciones seguras de Skills del espacio de trabajo salvo que apply: false las ponga en cola

​

Costos y comportamiento en tiempo de ejecución

• usa el mismo contexto configurado de proveedor/modelo cuando está disponible
• recurre a los valores predeterminados del agente en tiempo de ejecución
• tiene reviewTimeoutMs
• usa un contexto de arranque ligero
• no tiene herramientas
• no escribe nada directamente
• solo puede emitir una propuesta que pasa por el escáner normal y la ruta de aprobación/cuarentena

​

Patrones operativos

• “la próxima vez, haz X”
• “de ahora en adelante, prefiere Y”
• “asegúrate de verificar Z”
• “guarda esto como un flujo de trabajo”
• “esto llevó un tiempo; recuerda el proceso”
• “actualiza la Skill local para esto”

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

• tiene forma de transcripción
• no es imperativa
• incluye detalles ruidosos de una sola vez
• no indica al siguiente agente qué hacer

​

Depuración

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

​

Escenarios de 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

​

Cuándo no habilitar la aplicación automática

• el espacio de trabajo contiene procedimientos sensibles
• el agente trabaja con entrada no confiable
• las Skills se comparten en un equipo amplio
• todavía estás ajustando prompts o reglas del escáner
• el modelo maneja con frecuencia contenido web/correo hostil

​

Documentos relacionados

• Skills
• Plugins
• Pruebas