Las skills son paquetes de instrucciones que enseñan a un agente de IA a ejecutar una tarea específica de la manera correcta. En general, cada skill queda en una carpeta con un archivo de texto y, si hace falta, scripts y plantillas de apoyo.

Como funciona

El agente no carga todas las skills a la vez. Ve una lista corta con el nombre y la descripción de cada una. Cuando la tarea coincide con una descripción, abre la skill completa y sigue el paso a paso.

Esto ahorra espacio en la ventana de contexto, porque solo entra lo que es necesario en el momento. El formato exacto cambia de herramienta a herramienta, así que revisa la documentación de la que uses.

Una skill suele tener:

  • Un nombre y una descripción de cuándo usarla.
  • Las instrucciones en Markdown.
  • Archivos de apoyo, como ejemplos y scripts.

Exemplo prático

Tienes una forma fija de publicar posts en el blog de tu empresa: título corto, resumen de hasta 155 caracteres, imagen de portada y revisión final. En lugar de repetirlo cada vez en el prompt, creas una skill.

Markdown · skills/publicar-post/SKILL.md
---
name: publicar-post
description: Use quando for publicar um post no blog.
---

1. Escreva o título com até 60 caracteres.
2. Crie um resumo de até 155 caracteres.
3. Confira a imagem de capa antes de publicar.

Ahora, cada vez que pidas un post, el agente encuentra la skill y sigue el proceso.

Para que serve

Las skills sirven para:

  • Estandarizar tareas repetidas, como revisar código, escribir documentos o ejecutar deploys.
  • Compartir la forma de trabajar del equipo sin depender de que cada persona lo recuerde todo.
  • Mantener el prompt principal corto, dejando los detalles para cuando sean necesarios.

En flujos con varios agentes, como los que orquesta bridgecode, cada agente puede usar las skills correctas para su rol.

Cuidados

Una skill es una instrucción que el agente va a seguir, y puede incluir scripts. Usa solo skills de fuentes confiables y lee el contenido antes de instalar, pues una skill maliciosa puede inducir al agente a hacer algo indebido.

Diferença entre skills e AGENTS.md

El AGENTS.md trae reglas generales del proyecto, leídas desde el inicio. Las skills tratan tareas específicas y solo se abren cuando son necesarias. Los dos se complementan: reglas generales en un archivo, procedimientos especializados en skills.