Qué es una skill en agentes de IA y cómo las usamos
Qué es una skill en agentes de IA: una carpeta con instrucciones que el agente carga cuando hace falta. Su estructura en Claude Code y cómo las usamos.
Fundador de JustSEO, agencia chilena que trabaja con IA todos los días desde 2019
Publicado el
6 min de lectura
En este artículo
- ¿Qué es una skill en agentes de IA?
- ¿Cómo funciona una skill por dentro?
- ¿Cómo es una skill en Claude Code?
- ¿Dónde se guardan las skills y cómo se invocan?
- ¿En qué se diferencia una skill de otras piezas de Claude Code?
- ¿Cómo usamos las skills en JustSEO?
- ¿Qué precauciones hay con las skills?
- ¿Qué ángulo tiene para una pyme chilena?
- Preguntas frecuentes
- Fuentes
Una skill en agentes de IA es una carpeta con instrucciones, y a veces scripts y documentos, que el agente carga solo cuando tu pedido coincide con su descripción. Sirve para enseñarle un procedimiento una vez y no repetirlo en cada conversación. En Claude Code, una skill es una carpeta con un archivo SKILL.md.
Vigente al 11 de noviembre de 2026.
Una skill es un paquete reutilizable que le enseña a un agente de IA cómo hacer una tarea específica: lleva un nombre, una descripción de cuándo usarla, las instrucciones y, si hace falta, archivos de apoyo y scripts.
¿Qué es una skill en agentes de IA?
Anthropic las describe como recursos que dan al agente conocimiento especializado: flujos de trabajo, contexto y buenas prácticas que convierten a un agente general en un especialista. A diferencia de un prompt, que vale para una conversación puntual, una skill se carga a pedido, y no hay que repetir la misma guía en cada chat (Agent Skills, documentación de Anthropic, 11 de noviembre de 2026).
Piensa en el manual de procedimientos que le darías a una persona nueva en la empresa: cómo se redacta una propuesta, cómo se revisa un cambio, qué pasos seguir y qué no. Una skill es ese manual escrito para el agente.
Claude y Claude Code son marcas de Anthropic. JustSEO no está afiliada ni patrocinada por ella.
¿Cómo funciona una skill por dentro?
Funciona por niveles: el agente solo ve el nombre y la descripción, y el resto lo lee cuando lo necesita. Anthropic lo llama carga progresiva y lo divide en tres niveles:
| Nivel | Cuándo se carga | Qué contiene |
|---|---|---|
| 1. Metadatos | Siempre, al iniciar | Nombre y descripción; unos 100 tokens por skill |
| 2. Instrucciones | Cuando tu pedido coincide con la descripción | El cuerpo de SKILL.md; menos de 5.000 tokens |
| 3. Recursos y código | Solo si las instrucciones los piden | Documentos de apoyo y scripts; los scripts se ejecutan y solo su resultado entra al contexto |
La ventaja es que puedes tener muchas skills instaladas sin llenar la memoria del agente: hasta que una se activa, solo ocupan su nombre y su descripción. Los scripts, además, dan resultados repetibles, porque el agente los ejecuta en vez de reescribir el código cada vez.
¿Cómo es una skill en Claude Code?
Una carpeta con un archivo SKILL.md obligatorio y, opcionalmente, archivos de apoyo y scripts (skills en Claude Code, 11 de noviembre de 2026):
mi-skill/
├── SKILL.md (obligatorio: encabezado + instrucciones)
├── reference.md (opcional: se carga si hace falta)
├── examples.md (opcional: se carga si hace falta)
└── scripts/
└── helper.py (opcional: se ejecuta, no se carga)
El archivo SKILL.md tiene un encabezado en YAML entre dos líneas ---, seguido de las instrucciones en Markdown. Un ejemplo propio, de una skill imaginaria:
---
name: revisar-pagina
description: Revisa una página web antes de publicarla y lista problemas de títulos, enlaces rotos e imágenes sin texto alternativo. Úsala cuando pidan revisar o auditar una página.
---
## Instrucciones
1. Lee la página y lista los títulos y subtítulos.
2. Comprueba que cada imagen tenga texto alternativo.
3. Entrega una lista con los problemas, ordenados por gravedad.
La documentación indica que todos los campos del encabezado son opcionales, pero recomienda description porque Claude la usa para decidir cuándo cargar la skill. Estos son los más usados:
| Campo | Para qué sirve |
|---|---|
name | Nombre del comando; por defecto, el de la carpeta |
description | Qué hace y cuándo usarla; lo principal va primero |
disable-model-invocation | Si es true, Claude no la carga solo: solo la lanzas tú |
allowed-tools | Herramientas que Claude puede usar sin pedir permiso durante el turno que invoca la skill |
context | Con el valor fork, la skill corre en un subagente |
Para la plataforma de Anthropic, name admite hasta 64 caracteres entre minúsculas, números y guiones, y description hasta 1.024 caracteres.
¿Dónde se guardan las skills y cómo se invocan?
Según el alcance que quieras (skills en Claude Code, 11 de noviembre de 2026):
| Alcance | Ruta |
|---|---|
| Personal (todos tus proyectos) | ~/.claude/skills/<nombre>/SKILL.md |
| Proyecto (se comparte con git) | .claude/skills/<nombre>/SKILL.md |
| Plugin | <plugin>/skills/<nombre>/SKILL.md |
| Organización | En la configuración administrada de la empresa |
| Cuenta de claude.ai | Las skills activadas en tu cuenta |
Hay dos formas de invocarlas. Claude la carga solo cuando tu pedido coincide con la descripción, o tú la lanzas escribiendo /nombre-de-la-skill, con argumentos si hacen falta. Las skills activadas en tu cuenta de claude.ai también se cargan en las sesiones de terminal donde inicias sesión con esa cuenta; Claude Code las descarga a la carpeta ~/.claude/skills/synced/.
¿En qué se diferencia una skill de otras piezas de Claude Code?
Cada pieza resuelve algo distinto, y se combinan. Resumen según la documentación de Anthropic:
| Pieza | Qué es | Cuándo actúa |
|---|---|---|
| CLAUDE.md | Instrucciones permanentes del proyecto | Se carga en cada sesión |
| Skill | Procedimiento reutilizable | Se carga cuando hace falta |
| Subagente | Un asistente con su propio contexto | Cuando Claude le delega una tarea |
| MCP | Conexión a herramientas y datos externos | Cuando Claude usa esa herramienta; ver qué es MCP |
| Hook | Un comando que se ejecuta antes o después de una acción | Siempre, sin depender del modelo |
La documentación de mejores prácticas hace una distinción útil: una instrucción en CLAUDE.md o en una skill es no determinista, porque el modelo decide qué hacer con ella; un hook, una regla de denegación o una prueba son deterministas, porque Claude Code los ejecuta siempre (mejores prácticas, 11 de noviembre de 2026). Y para gastar menos, recomienda mover a skills las instrucciones específicas de CLAUDE.md, porque se cargan solo al invocarlas (costos, 11 de noviembre de 2026).
¿Cómo usamos las skills en JustSEO?
JustSEO es una agencia chilena que monta sitios desde 2019 (más de 200) y trabaja con IA todos los días. Usamos Claude Code con skills propias para el blog (rastreo de temas, validación del texto y resumen de revisión), la prospección por LinkedIn y por correo, y la edición de video, además de subagentes en paralelo y conectores MCP.
En el blog, la skill le dice al agente qué hacer y un validador hecho con un script revisa cada artículo después: el script corre siempre, no depende de que el modelo se acuerde. Una segunda lectura coteja hechos, y Yamil Alfonzo revisa y firma lo que se publica.
Si quieres aplicar el mismo orden a tu empresa, el primer paso es anotar los procedimientos que tu equipo repite. Para ver el mapa de herramientas, mira la guía para programar con IA y el directorio de herramientas de IA; para empezar con la herramienta, cómo instalar y usar Claude Code.
¿Qué precauciones hay con las skills?
Una skill funciona como instalar un programa. Anthropic recomienda usar solo skills que escribiste tú o que vienen de Anthropic, y auditar todos los archivos de cualquier otra antes de usarla: una skill maliciosa puede dirigir al agente a ejecutar código o usar herramientas de forma distinta a lo que dice su descripción (Agent Skills, 11 de noviembre de 2026).
Dos precauciones más. No guardes claves ni contraseñas dentro de una skill. Y mantén SKILL.md corto: la documentación sugiere menos de 500 líneas, con el detalle en archivos aparte.
¿Qué ángulo tiene para una pyme chilena?
Una skill sirve para cualquier proceso repetible: redactar propuestas con tu formato, revisar fichas de producto, ordenar planillas antes de cargarlas. Escribir una no exige programar: es un texto con instrucciones claras. Cuida qué datos de clientes le muestras al agente. El cobro de la herramienta es en dólares; el detalle está en cuánto cuesta Claude Code al mes.
Para armar las primeras skills de tu equipo con procesos reales, tenemos capacitación en IA.
Redactado con apoyo de IA y revisado por una persona. Cómo escribimos.
Preguntas frecuentes
¿Qué es una skill en un agente de IA?
Es un paquete reutilizable de instrucciones, y a veces de scripts y documentos, que el agente carga solo cuando la tarea lo pide. Anthropic las describe como recursos que convierten a un agente general en un especialista. Se guardan como una carpeta con un archivo SKILL.md, que lleva un nombre, una descripción y las instrucciones.
¿Cuál es la diferencia entre una skill y un prompt?
Un prompt es una instrucción dentro de una conversación, para una tarea puntual, y hay que repetirlo. Una skill se escribe una vez, queda guardada y el agente la carga solo cuando lo que pides coincide con su descripción. Además puede traer archivos de apoyo y scripts, cosa que un prompt suelto no tiene.
¿Dónde se guardan las skills en Claude Code?
En una carpeta con un archivo SKILL.md. Las personales van en ~/.claude/skills/ y valen para todos tus proyectos; las de proyecto van en .claude/skills/ dentro del repositorio y se comparten con el equipo mediante git. También pueden venir dentro de un plugin. Es lo que dice la documentación de Anthropic al 11 de noviembre de 2026.
¿Una skill es lo mismo que CLAUDE.md?
No. CLAUDE.md se carga completo al inicio de cada sesión, así que sirve para reglas que valen siempre. Una skill carga su contenido solo al usarse, por eso conviene para procedimientos específicos, como revisar un PR o publicar un artículo. Anthropic recomienda mover a skills las instrucciones que solo importan en parte del trabajo.
¿Es seguro instalar skills de otras personas?
Solo si confías en la fuente. Anthropic advierte que una skill maliciosa puede dirigir al agente a ejecutar código o usar herramientas de forma distinta a lo que dice su descripción. Usa skills que escribiste tú o que vienen de Anthropic, y si debes usar otra, revisa todos sus archivos antes.
Fuentes
Escrito por
Yamil Alfonzo
Fundador de JustSEO, agencia chilena que trabaja con IA todos los días desde 2019
Ver perfil en LinkedIn
