Habilidades de configuración y de archivos múltiples
Una habilidad básica solo necesita nombre y descripción. Pero con unos pocos campos más y una buena organización puedes crear habilidades mucho más potentes, seguras y fáciles de mantener.
🌐 Este vídeo es el original de Anthropic, en inglés. Para seguirlo en español, dale al play al audio 🎬 «Sigue el vídeo en español» de aquí abajo — es la traducción exacta de lo que se dice.
Sigue el vídeo en español
Escucha la lección
Campos del encabezado
Una habilidad básica solo necesita nombre y descripción. Pero el encabezado admite más campos:
| Campo | ¿Obligatorio? | Para qué sirve |
|---|---|---|
| name | ✅ Sí | Identifica la habilidad. Solo minúsculas, números y guiones (máx. 64). Debe coincidir con el nombre de la carpeta. |
| description | ✅ Sí | Le dice a Claude cuándo usarla. Es el campo más importante (máx. 1024 caracteres). |
| allowed-tools | No | Restringe las herramientas que Claude puede usar con la habilidad activa. |
| model | No | Indica qué modelo de Claude usar para esta habilidad. |
Cómo escribir buenas descripciones
Si alguien te dijera "tu trabajo es ayudar con los documentos", no sabrías qué hacer exactamente. A Claude le pasa igual. Una buena descripción responde siempre a dos preguntas: qué hace la habilidad y cuándo debería usarla Claude.
Si tu habilidad no se activa cuando esperas, añade más palabras clave que coincidan con la forma en que pides las cosas. La descripción es el único criterio que usa Claude para decidir si es relevante.
Restringir herramientas con allowed-tools
A veces quieres que una habilidad solo lea archivos, sin modificarlos: auditorías, revisiones de código o flujos de alta seguridad. Con allowed-tools le dices exactamente qué puede usar.
En este ejemplo, con la habilidad activa Claude solo puede leer y buscar (Read, Grep, Glob, Bash) — no puede editar ni escribir. Si omites allowed-tools, no se restringe nada.
Divulgación progresiva para habilidades complejas
Cuando Claude activa una habilidad, carga su contenido en el contexto. Si lo metes todo en un archivo de 2000 líneas, ocupa demasiado espacio y cuesta mantenerlo. La solución: deja en el SKILL.md solo lo esencial y guarda el material de referencia en archivos aparte que Claude consultará solo cuando haga falta.
Una estructura recomendada para la carpeta de una habilidad:
- ›SKILL.md — las instrucciones esenciales (máx. 500 líneas)
- ›scripts/ — código ejecutable
- ›references/ — documentación adicional
- ›resources/ — imágenes, plantillas, archivos de datos
En el SKILL.md enlazas a esos archivos con instrucciones claras de cuándo cargarlos. Por ejemplo: "lee architecture-guide.md solo cuando alguien pregunte por el diseño del sistema". Si nadie lo pregunta, ese archivo no se carga nunca.
Regla general: mantén el SKILL.md por debajo de 500 líneas. Si lo superas, divide el contenido en archivos de referencia.
Uso eficiente de scripts
Los scripts de tu carpeta pueden ejecutarse sin cargar su contenido en el contexto: solo la salida consume tokens, no el código. La clave: dile a Claude que ejecute el script, no que lo lea. Ideal para validar el entorno, para transformaciones de datos que deben salir siempre igual, o para operaciones más fiables como código ya probado.
¿No programas? Te lo explico fácil · sin tecnicismos
Esta lección añade "extras" a las recetas. Te lo cuento fácil:
"Solo mirar, no tocar"
Puedes decirle a una habilidad qué tiene permitido hacer. Por ejemplo, que solo pueda leer y no cambie nada — como dar una copia para consultar en vez del original.
No lo cargues todo de golpe
Si una receta es muy larga, no hace falta tenerla entera abierta siempre. Dejas lo esencial a la vista y los detalles en "anexos" que solo se abren cuando hacen falta. Así Claude no se satura.
Maquinitas (scripts)
Puedes incluir "maquinitas" que hacen un paso siempre igual. Claude las pone en marcha y se queda solo con el resultado, sin tener que leerse cómo funcionan por dentro.
En una frase: limita lo que puede hacer, guarda los detalles en anexos que se abren solo cuando hacen falta, y usa maquinitas para lo que tenga que salir siempre igual.
Glosario
Metadatos (encabezado)
Los campos del principio del SKILL.md (name, description, allowed-tools, model) que identifican y configuran la habilidad.
La ficha de arriba del archivo, con el nombre, para qué sirve y sus ajustes.
allowed-tools
Campo opcional que limita las herramientas que Claude puede usar mientras la habilidad está activa (por ejemplo, solo Read y Grep).
Una lista de lo que la habilidad tiene permitido hacer; sirve para decir "solo mirar, no tocar".
model
Campo opcional que indica qué modelo de Claude usar para esa habilidad.
Eliges qué "cerebro" de Claude usa esa habilidad.
Divulgación progresiva
Organizar la habilidad para que el SKILL.md guarde solo lo esencial y enlace a archivos de referencia que se cargan únicamente cuando se necesitan.
No cargar todo de golpe: lo básico siempre, y los detalles solo cuando hacen falta.
Script
Archivo de código ejecutable dentro de la habilidad; se ejecuta y solo su salida consume contexto, no su código.
Una "maquinita" que hace un paso por ti; Claude la usa y se queda con el resultado.
Fuentes oficiales de Anthropic