Skills: enseñarle
cosas nuevas a tu agente
Qué vas a poder hacer al terminar
- Explicar con tus palabras qué es una skill y cómo la ejecuta el agente.
- Instalar una skill de otra persona de forma segura (leyendo permisos primero).
- Crear tu propia skill y que tu agente la recuerde para siempre.
- Usar el Skill Workshop nuevo para revisar y revertir cambios.
Dónde venís
En la Clase 04 tu agente dejó de ser un desconocido: ya sabe quién sos, tiene personalidad y memoria. Le hablás y te entiende. Pero te chocaste con una pared: le pediste algo y te dijo "no puedo hacer eso". O peor: dijo que sí… y te entregó un invento.
Eso pasa porque el modelo, solo, tiene límites. Una skill es la forma de romper esos límites. Es, literalmente, cómo le enseñás a tu agente a hacer algo que antes no sabía.
¿Qué es una skill, en serio?
Una skill es un archivo de texto que le enseña a tu agente a hacer algo. Nada más misterioso que eso. Es un documento (normalmente llamado SKILL.md) que describe, en lenguaje claro, un procedimiento o una capacidad nueva.
Pensalo como la diferencia entre un empleado talentoso pero nuevo (el modelo) y el manual de "cómo hacemos las cosas acá" (la skill). El talento ya estaba; la skill le da el paso a paso y las herramientas.
Hay dos tipos de skills
- Procedimientos: una receta de pasos que el agente sigue usando herramientas que ya tiene. Ejemplo: "para armar un brief matinal, primero buscá noticias, después resumí, después mandámelo por Telegram".
- Potenciadores de capacidad: le dan al agente la habilidad de usar un servicio externo para hacer algo que solo no podía. Ejemplo: generar imágenes reales con un modelo de imágenes.
El problema que las skills resuelven
Los modelos de IA siempre dicen que pueden. Si le pedís "generá una imagen", te va a decir "¡claro!" y va a improvisar un truco (un script, un dibujo en código) en vez de usar un modelo de imágenes de verdad. La skill lo obliga a hacerlo bien y a no alucinar.
¿Cómo se ejecuta una skill?
Acá está la magia: no ejecutás nada a mano. El agente lee la descripción de cada skill que tiene disponible y, cuando una conversación encaja, la "carga" y la sigue. Vos solo hablás normal.
Por dentro pasa esto:
- Le pedís algo en lenguaje natural ("armame un carrusel sobre esto").
- El agente mira sus skills disponibles y reconoce que una aplica.
- Carga ese
SKILL.mden su contexto (por eso son eficientes en tokens: solo carga lo que necesita, cuando lo necesita). - Sigue los pasos, pidiendo permiso para las acciones sensibles.
Por qué importa que sea "bajo demanda"
Si todas las instrucciones de todas las skills estuvieran siempre cargadas, el agente se saturaría (la ventana de contexto es como un escritorio: si hay demasiados papeles, se caen). Las skills se cargan solo cuando hacen falta. Esa es la clave de que puedas tener decenas sin que el agente se vuelva tonto.
Permisos: lo que SÍ o SÍ tenés que entender
Una skill puede pedir acceso a cosas: tu navegador, tus archivos, una API key, internet. Antes de instalar cualquier skill de un tercero, esta es la regla de oro:
Leé el SKILL.md antes de instalar
En los marketplaces hay gente que mete malware adentro de skills. Una skill maliciosa puede pedir permisos excesivos para robarte credenciales. Nunca instales una skill sin leer qué permisos pide. Si una skill de "convertir PDF" te pide acceso a tu gestor de contraseñas, algo huele mal.
Tres hábitos de seguridad con skills (los profundizamos en la Clase 10):
- Mínimo privilegio: una skill solo debería pedir lo justo para su tarea.
- Rotá tus keys: si le pasaste una API key para probar, revocala/rotala después, como se hace en el curso con cada demo.
- Usá un verificador: podés instalar una skill tipo
skill-guardque audita otras skills antes de dejarlas correr.
Antes de instalar cualquier skill, leé su SKILL.md y decime: qué permisos pide, a qué servicios externos accede y si algo parece excesivo para lo que dice hacer. Si tengo skill-guard instalada, pasala por ahí también.
Ejemplo de punta a punta: darle "ojos creativos"
Hagamos la skill más clásica: que tu agente genere imágenes de verdad. Por defecto no puede; le vamos a enseñar a usar un modelo de imágenes (Nano Banana Pro, vía la API de Gemini).
Paso 1 — Comprobá el límite
Generá una imagen de una infografía que explique qué es una skill. Después contame exactamente qué herramienta usaste para crearla.
Vas a ver que "lo logra"… pero cuando preguntás cómo, confiesa que armó un script casero, no un modelo de imágenes. Ese es el límite.
Paso 2 — Dale la capacidad y pedile que la guarde como skill
Esta es mi API key de Gemini: [PEGÁS-LA-ACÁ]. Usá Nano Banana Pro para generar una imagen real de lo que es una skill. Cuando funcione, empaquetá este procedimiento como una skill tuya para que en el futuro siempre uses un modelo de imágenes de verdad, y subila a GitHub.
Rotá la key apenas termines
En el ejemplo le pasás una API key en el chat. Apenas la skill funcione, andá al panel del proveedor y revocá/rotá esa key. Nunca dejes una key "viva" en una conversación.
Paso 3 — Ahora es permanente
A partir de acá, cada vez que pidas una imagen, el agente recuerda que tiene esa skill y la usa. No más inventos. Acabás de subir el primer escalón: ahora podés componer skills una sobre otra para armar sistemas robustos.
Novedad reciente: el Skill Workshop
Revisar y revertir skills, sin miedo
Las versiones recientes de OpenClaw suman el Skill Workshop: cuando el agente quiere crear o modificar una skill, te lo deja como una propuesta pendiente que vos revisás y aprobás (o rechazás) desde el panel o el chat. Además guarda metadata de rollback: si una skill empeora las cosas, la revertís a la versión anterior con un click.
Esto cambia el flujo: antes confiabas y rezabas; ahora tenés un paso de revisión y un botón de "deshacer". Es seguridad real para cuando empieces a tener muchas skills o construir para clientes.
Y además: instalación gobernada (operator install policy)
La versión actual reemplazó el viejo "escáner de código peligroso" por una operator install policy: una política nativa que decide qué skills y plugins se pueden instalar y bajo qué condiciones, en lugar de confiar en un escaneo al que se le podía escapar algo. Sumada a leer el SKILL.md y a skill-guard, te da tres capas antes de que una skill ajena corra en tu máquina.
Caso de uso real
Un creador de contenido instala una skill de "brief matinal" (la vemos en la Clase 09): alguien ya hizo el trabajo duro y lo empaquetó. Él solo la descarga, le pasa las keys y la pone en un horario. En vez de doom-scrollear 2 horas buscando tendencias, recibe cada mañana un resumen accionable. Eso es el poder de las skills: reutilizar el trabajo de otros y el tuyo.
Ejercicio: hacelo ahora (15 min)
- Pedile a tu agente que genere una imagen y después que te diga cómo la hizo. Confirmá el límite.
- Dale acceso a un modelo de imágenes con una API key de prueba y pedile que empaquete el procedimiento como skill.
- Pedile que te muestre el
SKILL.mdresultante y leelo: ¿qué permisos quedó pidiendo? - Rotá la API key. Volvé a pedir una imagen y verificá que ahora usa el modelo correcto.
- Bonus: activá el Skill Workshop y revisá la propuesta antes de aceptarla.
Lo que te falta ahora → Clase 06
Ya sabés crear skills. Pero hacer cada una a mano es lento. ¿Y si pudieras descargar skills ya hechas para casi cualquier cosa? Existe un marketplace entero: ClawHub. Y para conectar tu agente a apps que ni siquiera tienen skill, están los MCPs. Eso es lo que sigue.
Profundizá en el manual
Referencia: Skills (la pieza técnica) y la pestaña Skills del dashboard.