El problema que realmente estás resolviendo

Has encontrado un prompt o una secuencia de pasos que funciona. La siguiente persona en tu equipo repite el experimento desde cero, o peor aún — terminas con cinco versiones ligeramente distintas del mismo flujo de trabajo dispersas por Slack y drives compartidos. Ese es el costo real de no tener skills reutilizables para agentes: tiempo perdido redescubriendo lo que ya funciona.

Los Skills de OpenAI y los de Claude se construyeron para solucionar exactamente esto. Permiten empaquetar un procedimiento probado — instrucciones, ejemplos, archivos de referencia, incluso scripts — en una unidad reutilizable que puedes instalar en diferentes agentes o contextos. Pero no son lo mismo, y la plataforma donde se ejecutan importa más que el formato.

Qué es realmente un skill

Un skill no es un prompt. Es un paquete estructurado que vive junto al código y al material de referencia del que depende. Como mínimo, contiene un manifiesto SKILL.md con un nombre, descripción e instrucciones. También puede incluir plantillas, ejemplos de salida, scripts y activos. El agente ve primero solo los metadatos — el nombre y la descripción — y solo carga las instrucciones completas cuando decide que el skill aplica. OpenAI llama a esto revelación progresiva, lo que evita que el contexto del agente se sature con cada procedimiento de tu biblioteca.

En la práctica, esto significa que el conocimiento operativo de tu equipo — cómo manejas las revisiones de renovación de clientes, las convenciones que sigue tu código, los pasos que das cuando falla un despliegue — se preserva en un formato que puede revisarse, versionarse e instalarse en otro lugar. Ese es el valor central: convertir el conocimiento tribal en algo durable.

Skills de OpenAI: un estándar multi-plataforma

OpenAI ha puesto los Skills disponibles en ChatGPT Business, Enterprise y Edu, así como en Codex y a través de la API de Responses. Un paquete de skill puede viajar entre estas superficies porque OpenAI sigue el estándar abierto Agent Skills. Los archivos son portátiles.

Pero hay una advertencia importante. Los archivos viajan; la frontera de confianza no. Un skill que se ejecuta dentro de un sandbox de Codex no lleva sus permisos de sandbox a la API. Una versión fija en la API no crea un registro de aprobación en el workspace de ChatGPT. OpenAI ha estandarizado el artefacto antes de unificar el plano de control. Los Skills son inmediatamente útiles, pero requieren una nueva disciplina: tratar los procedimientos del agente como software.

Los Skills son versionados. Puedes subir una versión nueva sin romper agentes fijados a una versión anterior. Estableces una versión por defecto que los nuevos agentes detectan automáticamente, y puedes fijarte explícitamente en un número de versión o en latest. Esto importa para quien ejecute agentes en producción — puedes actualizar un flujo de trabajo de forma segura sin interrumpir lo que ya funciona.

Trabajan en dos modos de ejecución. Las shells alojadas corren dentro de un contenedor gestionado por OpenAI, con skills adjuntados como referencias. Las shells locales corren en tu propia máquina, con skills apuntando a rutas de archivo. El modo local es útil para desarrollo: editas el SKILL.md, vuelves a ejecutar, y ves los cambios inmediatamente sin paso de subida.

Skills de Claude y el ecosistema más amplio

El enfoque de Claude para flujos de trabajo reutilizables sigue una lógica similar pero usa un modelo de empaquetado e integración diferente. En Claude Code y Claude CLI, los skills se expresan típicamente como prompts de sistema estructurados en lugar de paquetes comprimidos con manifiestos. La idea subyacente es la misma — capturar un procedimiento repetible una vez y reutilizarlo — pero el mecanismo es más ligero y más integrado con la arquitectura de prompts de Claude.

Esto tiene una consecuencia práctica para equipos multi-plataforma. Los Skills de OpenAI no son directamente portátiles a Claude CLI o OpenCode. La descomposición de tareas, los patrones de prompt, y los scripts embebidos se transfieren como conceptos, pero alguien tiene que empacararlos de nuevo en el formato objetivo. Si tu stack usa tanto OpenAI como Claude, mantendrás dos bibliotecas de skills paralelas a menos que abstraigas la lógica en algo agnóstico a la plataforma, como un servidor MCP.

Dónde se superponen skills y plugins — y dónde divergen

La línea entre un skill y un plugin es delgada, y confundirlos lleva a sobre-construir. Esta es la distinción que importa:

Un skill le dice al agente cómo hacer algo. Contiene instrucciones, ramas de decisión, conocimiento de manejo de errores, y a veces archivos de soporte o scripts. Es guía procedural superpuesta sobre las herramientas que el agente ya tiene acceso.

Un plugin le da al agente una nueva capacidad. A través de mecanismos como servidores MCP, un plugin proporciona herramientas — funciones que el agente puede llamar directamente. Leer desde un CRM, consultar una base de datos, disparar un webhook — estas son capacidades que el agente no tiene de forma nativa. Un plugin las añade.

En la práctica, un flujo de trabajo completo suele necesitar ambos. El plugin le da al agente acceso a tus herramientas. El skill le dice al agente el orden correcto para usarlas, qué errores esperar, y cómo manejar casos borde que tu equipo ya ha resuelto.

La regla general: crea un skill cuando el agente ya tiene las herramientas y necesitas preservar una secuencia probada. Crea un plugin cuando al agente le falta la herramienta directamente.

Cuándo elegir skills sobre plugins — un marco de decisión para fundadores

No necesitas sobre-ingeniar esto. Empieza con el dolor que estás resolviendo:

  • Si sigues reescribiendo el mismo prompt para el mismo tipo de tarea, necesitas un skill. Un flujo de seguimiento de CRM, un análisis de informe trimestral, una secuencia de triaje de bugs — cualquier cosa que siga un procedimiento conocido es candidata para empaquetarse como skill.

  • Si sigues pidiéndole al agente que haga algo que físicamente no puede porque la herramienta no existe, necesitas un plugin. Acceder a tu software de contabilidad, leer desde una API privada, empujar resultados a un canal de notificación — estos requieren añadir una nueva capacidad, no solo codificar una secuencia.

  • Si estás evaluando si invertir en skills, pregúntate: ¿la próxima persona en mi equipo redescubriría este flujo de trabajo desde cero? Si la respuesta es sí, empacararlo como skill le ahorra tiempo a todos Going forward.

Skills y plugins no son intercambiables. Los skills reducen la repetición. Los plugins expanden la capacidad. Las configuraciones de agente más inteligentes usan ambos, y las más sabias empiezan con skills porque requieren menos infraestructura y dan retornos inmediatos.

Construyendo tu primera biblioteca de skills

No necesitas un proceso formal para empezar. Elige un flujo de trabajo que tu equipo ejecute repetidamente — algo con entradas claras, una secuencia definida, y resultados que puedas verificar. Escribe el SKILL.md con una descripción concisa, las instrucciones paso a paso, y cualquier archivo de referencia o ejemplo que el agente necesite. Pruébalo en un entorno local si es posible, luego compártelo con la persona que habría reconstruido eso desde cero.

El control de versiones es esencial desde el principio. Los skills que viven en git son revisables, diferenciables, y mantenibles. Sin versionado, vuelves a las mismas bibliotecas de prompts fragmentadas que intentabas escapar.

Mantén el alcance estrecho. Un skill que intenta manejar diez escenarios diferentes se convierte en una carga de mantenimiento y un confusor para el agente. Un procedimiento bien definido por skill, y una biblioteca que crece orgánicamente a medida que surgen nuevos dolores.

FAQ

¿Puedo usar la misma biblioteca de skills en OpenAI y Claude? No. Los formatos no son compatibles. Puedes transferir la lógica subyacente y los patrones, pero alguien tiene que empacar cada skill para la plataforma objetivo.

¿Los skills reemplazan buenos prompts? No. Los skills son una forma estructurada de preservar buenos prompts y los procedimientos que los rodean. Un skill sin instrucciones claras sigue siendo solo un prompt en un recipiente diferente.

¿Los skills son solo para equipos técnicos? El empaquetado puede requerir algo de configuración, pero la propuesta de valor es universal: si una tarea se repite, vale la pena capturarla. Incluso los fundadores solitarios se benefician de codificar flujos de trabajo que actualmente viven en su cabeza.

¿Qué pasa cuando el modelo subyacente cambia? Los skills son paquetes de instrucciones, no código específico de modelo. Pueden necesitar revisión si un modelo nuevo interpreta instrucciones de forma diferente, pero la estructura permanece útil en actualizaciones de modelo.

¿Hay costo por usar skills? Los skills en sí son gratuitos de crear y usar dentro de las plataformas que los soportan. El costo viene del runtime del agente — las llamadas a API que el skill dispara — pero un skill bien construido debería reducir esas llamadas con el tiempo al hacer al agente más eficiente.

Fuentes