Cómo crear un plugin para Claude Cowork y desarrollar tu propio empleado con IA (Curso completo)

La mayoría de la gente trata a Claude Cowork como un organizador de archivos inteligente.

Guarda esto :)

Pídele que ordene algunos archivos. Que convierta una hoja de cálculo. Que renombre una carpeta.

Esa es la versión junior de Cowork.

La versión senior es construir un plugin — un empleado de IA completo que conoce tu industria, sigue tu proceso exacto, produce tu formato de salida exacto y ejecuta tus flujos de trabajo de forma autónoma mientras tú haces otra cosa.

Un empleado de IA que se presenta cada día, nunca se enferma, nunca necesita capacitación dos veces y mejora cada semana.

Un plugin de Cowork es un paquete estructurado que contiene todo lo que Claude necesita para desempeñar un rol específico: las habilidades, los comandos, los materiales de referencia, las reglas y los controles de calidad. Lo instalas una vez y tienes un empleado.

Este es el curso completo para construir uno.

Qué es realmente un Plugin

Un plugin es una carpeta. Así de simple. Una carpeta con una estructura específica que le dice a Cowork exactamente qué hacer y cómo hacerlo.

Dentro de esa carpeta:

1my-plugin/
2├── .claude-plugin/
3│   └── plugin.json        ← Identidad: nombre, rol, descripción
4├── skills/
5│   └── primary-task/
6│       └── SKILL.md        ← El flujo de trabajo: proceso paso a paso
7├── commands/
8│   └── run-task.md         ← Comandos de barra: /prefijo:comando
9├── references/
10│   └── templates.md        ← Materiales de referencia: plantillas, benchmarks, ejemplos
11├── global-instructions.md  ← Órdenes permanentes: personalidad, preferencias, valores predeterminados
12└── folder-instructions.md  ← Contexto específico del proyecto

plugin.json le indica a Cowork que esta carpeta es un plugin, qué rol desempeña y cuándo activarse.

SKILL.md es el cerebro — el proceso paso a paso que tu empleado de IA sigue para cada tarea. Este es el archivo más importante. Hazlo bien y todo lo demás funciona.

Commands son disparadores de comandos de barra. Escribe /prefijo:comando y se ejecuta todo el flujo de trabajo.

References son las plantillas, benchmarks, datos de la industria y ejemplos que tu empleado necesita para hacer bien su trabajo.

Global instructions son las órdenes permanentes: personalidad, estilo de comunicación, estándares de calidad y suposiciones predeterminadas.

Folder instructions son el contexto específico del proyecto — qué hay en esta carpeta, cuáles son las prioridades actuales y cómo manejar los datos específicos aquí.

Fase 1: Investiga el Rol (30 Minutos)

Antes de escribir un solo archivo, necesitas saber exactamente qué hace tu empleado de IA.

Abre Claude y usa este prompt:

"Investiga el flujo de trabajo profesional completo para un [ROL] en [INDUSTRIA]. Incluye: el proceso paso a paso que siguen, las herramientas y fuentes de datos que utilizan, las métricas clave y criterios de decisión, los formatos de salida comunes y los casos límite y errores típicos a nivel experto. Sé exhaustivo — estoy construyendo un flujo de trabajo automatizado a partir de esto."

Lee la salida con atención. Este es el material bruto del que se construirá tu archivo de habilidad.

Ahora entrévistate a ti mismo. ¿Cómo es TU versión de este proceso? ¿Qué atajos tomas? ¿Qué controles de calidad ejecutas siempre? ¿Qué errores vigilas siempre? ¿Cómo se ve "bueno" versus "malo"?

Los mejores empleados de IA no se construyen a partir de mejores prácticas genéricas. Se construyen a partir de TU experiencia específica.

Fase 2: Escribe el Archivo de Habilidad (60 Minutos)

El archivo SKILL.md es el cerebro de tu empleado de IA. Todo lo que sabe sobre cómo hacer su trabajo vive aquí.

Esta es la estructura:

name: [nombre-de-habilidad]

description: [¿Cuándo debería activarse esto? Sé agresivo con las frases de activación.

"Usa esta habilidad cuando el usuario diga: [lista de 5 a 7 frases].

NO la uses para: [lista de cosas que suenan similares pero son diferentes]."]

Resumen

[Un párrafo: qué hace esta habilidad y qué produce]

Proceso

[Pasos numerados. Cada paso es específico, comprobable y sin ambigüedades.

No "analiza los datos" sino "compara el período actual con el período anterior

y calcula el cambio porcentual para cada métrica."]

1. [Paso con instrucción específica]
2. [Paso con instrucción específica]
3. [Paso con instrucción específica] ...

Formato de Salida

[Exactamente cómo se ve el entregable]

• Formato del título
• Encabezados de sección en orden
• Restricciones de longitud
• Requisitos de formato

Reglas

[Tus estándares de calidad no negociables]

• [Regla 1]
• [Regla 2]
• [Regla 3]

Casos Límite

[Qué hacer cuando las cosas no son sencillas]

• Si [situación]: [acción específica]
• Si [situación]: [acción específica]

Lista de Control de Calidad

[Ejecuta esto antes de entregar cualquier salida]

• [ ] [Verificación 1]
• [ ] [Verificación 2]
• [ ] [Verificación 3]

El campo de descripción en el frontmatter YAML es la parte más crítica. Si es demasiado vago, la habilidad nunca se activa. Si es demasiado amplio, secuestra conversaciones no relacionadas. Enumera de 5 a 7 frases de activación específicas Y límites negativos explícitos.

Fase 3: Construye los Archivos de Soporte (30 Minutos)

El plugin.json:

{

"name": "mi-empleado-ia",

"description": "Un [ROL] que [QUÉ HACE] para [QUIÉN]",

"version": "1.0"

}

El comando de barra:

Crea un archivo markdown en /commands/ que active tu flujo de trabajo:

/empleado:ejecutar

Ejecuta la habilidad [tarea-principal] sobre los datos en la carpeta actual.

Pasos:

1. Lee todos los archivos relevantes en el directorio de trabajo
2. Ejecuta la habilidad siguiendo cada paso en SKILL.md
3. Ejecuta la lista de control de calidad antes de entregar
4. Guarda la salida en [formato] en la carpeta actual
5. Proporciona un breve resumen de lo que se produjo

Instrucciones globales:

Eres un [ROL] con [AÑOS] de experiencia en [INDUSTRIA].

Órdenes Permanentes:

• Empieza con la recomendación, explica después
• Usa siempre números específicos, nunca descripciones vagas
• Si faltan datos o son ambiguos, márcalo — nunca adivines
• Formato de salida predeterminado: [TU PREFERENCIA]
• Estilo de comunicación: [DIRECTO/COLOQUIAL/FORMAL]
• Ante la duda, pregunta en lugar de asumir

Archivos de referencia:

Agrega cualquier plantilla, dato de referencia, estándar de la industria o ejemplo que tu empleado necesite. Cuanto más específicos sean tus materiales de referencia, más experto será el resultado.

Fase 4: Instala, Prueba y Refina

Instala la carpeta del plugin en tu entorno de Claude Cowork. Usa este prompt en Cowork:

"Tengo una carpeta de plugin en [RUTA]. Verifica que la estructura sea válida — revisa plugin.json, el frontmatter de SKILL.md y los archivos de comando. Instálalo y ejecuta una prueba rápida con el comando de barra más simple."

Ahora pruébalo con trabajo real. No con datos de muestra. Datos reales de tu flujo de trabajo real.

Ejecútalo 5 veces con diferentes entradas. Después de cada ejecución, evalúa:

• ¿Siguió cada paso en SKILL.md?
• ¿Siguió las reglas?
• ¿La salida coincidió con la especificación de formato?
• ¿Usarías esta salida tal cual o necesita una edición significativa?

Cada vez que algo no cumpla con el objetivo, actualiza SKILL.md. Agrega una regla. Ajusta un paso. Agrega un ejemplo que muestre cómo se ve lo bueno versus lo malo.

Este ciclo de refinamiento es lo que convierte a un empleado de IA mediocre en uno excepcional. Para la ejecución 10, la calidad de la salida será dramáticamente superior a la de la ejecución 1.

Fase 5: Escala a tu Empleado de IA

Una vez que tu habilidad principal funcione de manera confiable, expande las capacidades del empleado.

Agrega una segunda habilidad. Tu analista de investigación ahora también puede hacer monitoreo competitivo. Tu estratega de contenido ahora también puede reutilizar contenido. Cada nueva habilidad es un nuevo SKILL.md en la carpeta de skills.

Agrega flujos de trabajo automatizados. Encadena múltiples habilidades en procesos de varios pasos activados por un solo comando de barra. Investigación → análisis → informe → distribución. Un comando, cuatro habilidades, cero pasos manuales.

Agrega tareas programadas. Tu empleado de IA ejecuta el informe semanal todos los viernes a las 4pm. Procesa la bandeja de entrada diaria cada mañana a las 7am. Escanea a los competidores todos los lunes. Verdadera operación autónoma.

Agrega sub-agentes. Para flujos de trabajo complejos, tu empleado de IA puede activar múltiples sub-agentes que trabajan en paralelo. Cinco archivos procesados simultáneamente en lugar de secuencialmente. La mejora en velocidad se acumula con cada sub-agente adicional.

El Sistema de Revisión de Desempeño

Esto es lo que separa a quienes construyen un empleado de IA decente de quienes construyen uno excelente.

Cada semana, revisa las salidas. Anota lo que funcionó perfectamente, lo que necesitó correcciones y lo que tuviste que rehacer manualmente. Luego actualiza SKILL.md.

Esto toma 15 minutos por semana. El efecto compuesto en dos meses es masivo.

Para la semana 1, tu empleado es funcional. Para la semana 4, es bueno. Para la semana 8, está produciendo un trabajo que le llevaría meses de capacitación a un empleado junior humano igualar.

La herramienta no mejora por sí sola. Tus instrucciones mejoran. Y tus instrucciones están completamente bajo tu control.

Por Dónde Empezar Ahora Mismo

Elige la tarea en la que pasas más tiempo cada semana. La que temes. La que sigue el mismo proceso cada vez.

Dedica 2 horas a construir el plugin siguiendo este curso.

Para esta noche tendrás un empleado de IA que maneja tu tarea más tediosa. Para el próximo mes te preguntarás cómo lo hacías manualmente.

La mayoría de la gente seguirá haciéndolo todo ella misma porque construir un empleado de IA "suena complicado".

Quienes dediquen 2 horas hoy tendrán un empleado de IA autónomo trabajando para ellos cada día durante el resto del año.

Sígueme @eng_khairallah1 para más arquitecturas de automatización, diseños de flujos de trabajo y manuales de IA para negocios.

espero que te haya sido útil, Khairallah ❤️