Piensa en la última vez que le pediste algo a Claude. Probablemente tuviste que explicarle el contexto: cómo se estructura ese tipo de informe, qué tipografía usa el cliente, en qué orden va cada sección, qué no debe hacer nunca. Y al día siguiente, con otro cliente, lo explicaste otra vez.
Las Skills existen para eso. Son la diferencia entre una herramienta genérica y una que conoce tu forma de trabajar.
Qué es exactamente una Skill
Una Skill es una carpeta con un archivo SKILL.md dentro, que contiene instrucciones y, opcionalmente, scripts, plantillas y documentación de apoyo. Claude la carga automáticamente cuando detecta que es relevante para lo que le has pedido.
La estructura mínima es esta:
mi-skill/ ├── SKILL.md # Las instrucciones (obligatorio) ├── scripts/ # Código ejecutable (opcional) ├── references/ # Documentación adicional (opcional) └── assets/ # Plantillas y recursos (opcional)
La diferencia con un prompt es el alcance. Un prompt vale para una conversación. Una Skill la escribes una vez y se aplica sola cada vez que hace falta, sin que tengas que acordarte de nada.
Por qué no te infla el contexto
Aquí está el detalle técnico que hace que todo esto funcione, y se llama progressive disclosure. Claude no carga tus Skills enteras al empezar una conversación: solo lee los metadatos, es decir, el nombre y la descripción de cada una. El cuerpo completo de la Skill se carga únicamente cuando la tarea encaja.
Eso significa que puedes tener veinte Skills instaladas sin penalizar cada conversación. Y también significa que la descripción lo es todo: es lo único que Claude lee para decidir si tu Skill aplica. Si es vaga, no se activará nunca. Si es demasiado amplia, se activará cuando no toca.
Skills y MCP no son lo mismo
Es la confusión más habitual, y la distinción es simple: MCP conecta a Claude con tus herramientas y tus datos; las Skills le enseñan qué hacer con ellos. Un conector de MCP le da acceso a tu WordPress o a tu Google Drive. Una Skill le dice cómo tiene que redactar ese informe una vez tiene los datos delante.
Se complementan. De hecho, las combinaciones más útiles son justamente esas: conector que trae los datos, Skill que impone tu criterio sobre ellos.
Cómo se construye un SKILL.md
El archivo abre con un frontmatter en YAML con dos campos obligatorios: name, con un máximo de 64 caracteres, y description, con un máximo de 200. Debajo, las instrucciones en Markdown.
El error típico al escribir la descripción es contar qué hace la Skill. Lo que hay que contar es cuándo debe usarse, y con las palabras que tú usarías al pedirlo. No «genera informes de posicionamiento», sino algo que incluya los términos con los que realmente vas a formular la petición.
En el cuerpo, escribe procedimiento, no filosofía. Orden de pasos, formato de salida, qué comprobar antes de dar algo por bueno, qué no hacer nunca. Piensa en cómo se lo explicarías a alguien que entra nuevo en el equipo y tiene que sacar el trabajo el primer día.
Dónde se usan
- En claude.ai: subes tu Skill como archivo zip desde Ajustes → Funciones. Está disponible en los planes Pro, Max, Team y Enterprise con la ejecución de código activada.
- En Claude Code: es todo sistema de archivos, sin subir nada. La carpeta va en
~/.claude/skills/si es personal, o en.claude/skills/dentro del proyecto si es de equipo y quieres versionarla en el repositorio. - En la API: indicas el
skill_idcorrespondiente junto a la herramienta de ejecución de código.
Un ejemplo de agencia
En una agencia hay procesos que se repiten idénticos mes tras mes y cliente tras cliente: los informes trimestrales, las auditorías de contenido, los guiones de vídeo con una estructura fija, las fichas de producto. Todos tienen algo en común: el criterio ya está decidido, lo que cuesta es aplicarlo sin desviarse.
Ese es el candidato perfecto para una Skill. Una vez escrita, el proceso deja de vivir en tu cabeza o en un documento que nadie abre, y pasa a ejecutarse igual siempre. Para un equipo pequeño, el valor no está tanto en la velocidad como en la consistencia: el trabajo sale igual lo haga quien lo haga.
Mi consejo para empezar: no diseñes tu primera Skill sobre un proceso que aún no tienes claro. Coge uno que ya hagas bien a mano y limítate a escribirlo. La Skill no inventa criterio, lo replica.
Una advertencia antes de instalar Skills de terceros
Una Skill puede llevar scripts ejecutables dentro, así que instalar una de un repositorio ajeno no es lo mismo que copiar un prompt. Antes de añadirla, ábrela y revisa todos los archivos: el SKILL.md, los scripts y el resto de recursos. Busca cosas que no encajen con lo que la Skill dice hacer, como llamadas de red inesperadas o accesos a archivos raros.
Ten especial cuidado con las que descargan contenido de URLs externas, porque lo que llega de fuera puede traer instrucciones dentro. Es el mismo criterio que aplicarías con un plugin de WordPress de origen dudoso, y por las mismas razones.
Por dónde empezar
Elige la tarea que más veces has explicado este mes. Escribe en un documento cómo la haces, paso a paso, incluyendo lo que no hay que hacer. Guárdalo como SKILL.md con su nombre y su descripción, súbelo y pruébalo tres o cuatro veces con casos reales.
La primera versión se quedará corta, y eso es normal. Las Skills se afinan usándolas: cada vez que el resultado no sale como querías, sabes exactamente qué línea añadir. Y esa línea ya no la vuelves a escribir nunca más.
