Saltar al contenido principal

Cómo crear un plugin en Cowork desde cero (Guía 2026)

· 5 min de lectura
Claude Dev
Claude Dev
Claude Dev

Si quieres que Cowork haga trabajo real por ti, los plugins son la palanca clave.

Al 2026-02-28, el camino oficial ya está claro:

  • Anthropic presentó Cowork el 2026-01-14
  • La creación y compartición de plugins personalizados se anunció el 2026-01-20
  • Las actualizaciones del directorio para empresas llegaron el 2026-02-24
  • La documentación de ayuda de plugins se actualizó el 2026-02-25

Esta guía combina ese flujo oficial con lecciones prácticas de la comunidad para que construyas tu primer plugin útil desde cero.

Qué debería hacer tu plugin de Cowork (antes de abrir la UI)​

Un buen primer plugin resuelve una tarea estrecha y repetitiva.

Mala primera idea:

  • “Haz toda mi estrategia de marketing”

Mejores primeras ideas:

  • “Convertir notas de reunión en acciones semanales con responsables y fechas”
  • “Resumir logs de incidentes y devolver una tabla de triaje de riesgo”
  • “Revisar perfiles de candidatos y devolver una scorecard estructurada”

Antes de construir, escribe este contrato de una línea:

Input: qué le das al plugin.
Output: qué debe devolver siempre.

Si no puedes definir esto con claridad, el prompt se va a desviar.

Paso 1) Crea la base del plugin en Cowork​

En Cowork, abre el área de plugins y crea uno nuevo.

Según documentación/soporte oficial, normalmente puedes:

  • Crear desde cero en la UI de Cowork
  • Importar desde archivos locales
  • Instalar desde el plugin directory (plugins existentes)

Para tu primer build, elige desde cero.

Paso 2) Nombre y descripción: aquí empieza la precisión​

Constructores de la comunidad repiten lo mismo: la selección correcta del plugin depende mucho del nombre y la descripción.

Formato recomendado:

  • Nombre: rol concreto (Incident Triage Reporter)
  • Descripción: disparador + alcance (Use when user asks to triage ops incidents from raw logs into severity, owner, and next action.)

Evita descripciones vagas como “general assistant plugin”.

Por qué importa:

  • Cowork debe decidir cuándo tu plugin es relevante
  • Descripciones ambiguas causan activación incorrecta o nula

Paso 3) Escribe un contrato de prompt estricto​

Las instrucciones del plugin deben parecer un runbook de producción.

Estructura mínima útil:

  1. Rol y objetivo
  2. Inputs obligatorios
  3. Formato de salida (secciones fijas/tabla/esquema tipo JSON)
  4. Reglas de decisión y prioridad
  5. Límites de seguridad y qué hacer con incertidumbre

Ejemplo de esqueleto:

You are Incident Triage Reporter.

Goal:
- Convert raw incident notes into a priority triage report.

Required inputs:
- incident_log
- service_name
- report_time

Output format:
- Severity: P0/P1/P2/P3
- Impact summary (max 3 bullets)
- Suspected root cause
- Immediate next action
- Owner recommendation

Rules:
- If evidence is weak, state uncertainty explicitly.
- Never invent metrics not present in input.
- Ask one clarifying question if critical context is missing.

Lección de comunidad: prompts cortos y acotados suelen rendir mejor que prompts largos de “haz todo”.

Paso 4) Diseña para salida predecible, no para salida “creativa”​

Si el plugin forma parte del workflow, la consistencia vale más que el estilo.

Checks prácticos:

  • ¿El equipo puede leer el resultado en 10 segundos?
  • ¿La automatización downstream puede parsearlo?
  • ¿El formato se mantiene estable con 5 inputs muy distintos?

Si no, ajusta reglas y reduce alcance.

Paso 5) Prueba casos límite reales antes de compartir​

No pruebes solo el “happy path”.

Ejecuta al menos estos 5 tests:

  1. Input limpio y completo
  2. Falta un campo clave
  3. Datos contradictorios
  4. Input muy largo/con ruido
  5. Input fuera del alcance del plugin

Comportamiento esperado en #5: rechazo explícito + sugerencia de redirección.

Paso 6) Comparte con seguridad en tu workspace​

El rollout oficial para equipos enfatiza compartición controlada y gobernanza del workspace.

Antes de publicar internamente:

  • Agrega “When to use / When not to use”
  • Agrega ejemplos de input/output
  • Define owner y expectativas de mantenimiento
  • Versiona el prompt (v0.1, v0.2, etc.) con changelog corto

Así evitas que se convierta en un “plugin misterioso” tras unas semanas.

Paso 7) Itera con señales de uso reales​

Después del lanzamiento, revisa ejecuciones reales cada semana:

  • Calidad de activación (¿se invoca en el momento correcto?)
  • Tasa de corrección (¿cuánto reescriben los usuarios?)
  • Patrones de fallo (contexto faltante, supuestos erróneos)

En cada iteración cambia solo una variable:

  • Texto de descripción
  • Regla del prompt
  • Esquema de salida

Cambios pequeños y controlados superan a reescrituras completas.

Guía oficial vs comunidad: en qué confiar primero​

Orden recomendado:

  1. Producto y soporte oficial de Cowork (comportamiento, permisos, rollout)
  2. Tutoriales/referencia oficiales de plugins (formato y detalles de implementación)
  3. Ejemplos de comunidad (muy útiles para edge cases y heurísticas prácticas)

El contenido comunitario aporta mucho, pero puede quedar desactualizado rápido.

Conclusión​

Tu primer plugin de Cowork debería ser simple, acotado y confiable.

Si aciertas estas tres cosas:

  • descripción de activación clara
  • contrato de salida estricto
  • casos de prueba disciplinados

…obtendrás valor real rápido, y tu segundo plugin será mucho más fácil.

Fuentes (verificadas el 2026-02-28)​

Oficiales​

Comunidad​