Construí un repositorio en torno a las Agent Skills — Esta es la razón por la que importa
Si ahora mismo estás construyendo con agentes de IA, probablemente te has topado con la misma pared:
Sigues repitiendo las mismas instrucciones — y tu agente sigue olvidándolo.
Ese es exactamente el problema que las Agent Skills intentan resolver. Así que monté un repositorio para explorar la idea en la práctica:
👉 github.com/andreab67/agent-skills
¿Qué son las Agent Skills?
Las Agent Skills son una idea simple pero poderosa: empaquetar cómo hacer algo en instrucciones reutilizables que tu agente de IA pueda cargar bajo demanda.
Técnicamente, no son más que carpetas que contienen un archivo SKILL.md más scripts, plantillas y material de referencia opcionales. Conceptualmente, son experiencia portable para agentes de IA.
Por qué esto importa
La mayoría de los flujos de trabajo de IA de hoy se parecen a esto:
- Copiar y pegar prompts
- Reescribir el contexto cada vez que inicias una sesión
- Esperar que el modelo se comporte de forma consistente
Las Agent Skills le dan la vuelta a eso:
- Define un flujo de trabajo una sola vez. Escribe las instrucciones, ejemplos y restricciones una sola vez — y bien.
- Reutilízalo entre proyectos y herramientas. La skill vive en un repositorio, no en tu portapapeles.
- Cárgalo solo cuando haga falta. Sin sobrecarga de contexto — los agentes incorporan solo la skill relevante para la tarea en cuestión.
Ese modelo de "carga bajo demanda" es la idea clave. Los agentes no necesitan todo por adelantado. Necesitan la capacidad adecuada en el momento adecuado.
De qué trata el repositorio
El repositorio agent-skills es mi forma de explorar esta idea en la práctica:
- Cómo estructurar las skills para que sean realmente reutilizables
- Qué separa una skill útil de un prompt prolijo metido en una carpeta
- Cómo crear flujos de trabajo componibles para tareas reales y recurrentes
Piénsalo como un espacio de pruebas para convertir prompts repetidos en sistemas reutilizables.
La visión general
Estamos avanzando por una progresión clara:
prompts → herramientas → agentes → ecosistemas de skills
Las Agent Skills ocupan una nueva capa en esa pila:
- Más estructuradas que los prompts en bruto
- Más reutilizables que las instrucciones personalizadas incrustadas en un system prompt
- Más ligeras que levantar un agente personalizado completo
Son algo así como micro-plugins para el comportamiento de la IA — y eso es una abstracción realmente útil.
Un vistazo a la realidad
No todas las skills son iguales. A partir de experimentar con esto:
- Las malas skills son prompts prolijos disfrazados — largos, genéricos y difíciles de acotar
- Las buenas skills son claras, específicas y accionables — definen la tarea, las restricciones y el resultado esperado
- Las grandes skills realmente cambian los resultados — codifican experiencia real, no solo instrucciones
La diferencia entre la segunda y la tercera es la especificidad y la base en el mundo real. Una skill que diga "escribe código limpio" no es una skill. Una skill que diga "cuando refactorices un componente React, comprueba estos cinco patrones concretos, en este orden, y corrige solo lo que se ha pedido" — eso sí es útil.
La conexión con el yoga y la arquitectura cloud
En yoga hay un principio: la secuencia importa tanto como las posturas. Puedes conocer cada asana y aun así construir una práctica que lesione a personas si el orden y las transiciones están mal. Aquí ocurre lo mismo.
Las Agent Skills tratan realmente de codificar la secuencia y el criterio — no solo el conocimiento. Qué hacer, cuándo hacerlo y qué omitir. Eso es lo que las diferencia de un prompt más largo.
En arquitectura cloud a esto lo llamamos un runbook. La idea es la misma: documenta el criterio, no solo los pasos.
Hacia dónde va esto
El futuro a corto plazo es:
- Marketplaces de skills donde los equipos comparten y versionan capacidades de agentes
- Flujos de trabajo componibles donde las skills se encadenan para tareas complejas
- Agentes de IA que aprenden tu proceso, no solo tus prompts
Si estás construyendo con agentes, merece la pena explorar esto pronto. Empieza por algo sencillo: toma una tarea que repites a menudo, escribe un SKILL.md para ella y reutilízalo entre sesiones. La mejora es inmediata.
El repositorio es abierto y agradezco contribuciones: