Cómo instalar Agent Skills en Claude Code y claude.ai
Dónde colocar el SKILL.md, cuándo conviene instalarla en el proyecto y cuándo en tu usuario, cómo comprobar que se activa de verdad y qué revisar cuando el agente la ignora.
Dónde va el archivo
Una skill es una carpeta con el nombre de la skill que contiene un archivo llamado SKILL.md. Esa carpeta va dentro del directorio de skills, y dónde esté ese directorio determina quién puede usar la skill.
Si la pones en el proyecto, la skill viaja con el repositorio y la tiene todo el equipo que trabaje en él. Si la pones en tu directorio personal, la tienes tú en todos tus proyectos pero nadie más. Es la misma decisión que tomas con cualquier configuración de herramienta.
Estructura de carpetas en Claude Code
# Skill del proyecto: la ve todo el equipo, va al repositorio
mi-proyecto/
└── .claude/
└── skills/
└── revision-contratos/
└── SKILL.md
# Skill personal: la tienes tú en todos tus proyectos
~/.claude/
└── skills/
└── modelo-130-autonomos/
└── SKILL.mdInstalar en Claude Code
Crea la carpeta de la skill
Dentro de .claude/skills/ en tu proyecto, o de ~/.claude/skills/ si la quieres para todo. El nombre de la carpeta debe coincidir con el campo name del frontmatter: si no coinciden, es la primera cosa que revisar cuando algo no funcione.
Guarda el archivo como SKILL.md
El nombre del archivo importa y va en mayúsculas. Si compraste la skill en MundoPrompt, puedes copiar el contenido con un clic desde la ficha o descargar el archivo ya listo.
Reinicia la sesión
Las skills se leen al arrancar. Si tenías Claude Code abierto mientras copiabas el archivo, ciérralo y vuelve a abrirlo o no la verá.
Comprueba que está cargada
Pídele directamente que liste las skills disponibles. Si aparece la tuya, el archivo está bien colocado y el frontmatter es válido; si no aparece, el problema es de ubicación o de formato, no de la descripción.
Instalar en claude.ai
En la aplicación web y de escritorio de Claude las skills se gestionan desde la propia interfaz, en el apartado de capacidades de la configuración, subiendo el archivo en lugar de colocarlo en una carpeta. El contenido del SKILL.md es exactamente el mismo: un archivo sirve para las dos vías sin tocar nada.
La disponibilidad de esta función depende de tu plan y va cambiando conforme evoluciona el producto, así que si no la encuentras en tu cuenta, revisa la documentación oficial de Anthropic antes de dar por hecho que el archivo está mal.
Cada herramienta compatible con el formato tiene su propio mecanismo de instalación. En MundoPrompt, cada skill incluye las instrucciones concretas de su autor, que es lo que conviene seguir cuando difieran de lo general.
Comprobar que la skill se activa de verdad
Que una skill esté instalada no significa que se use. El agente la activa cuando la petición encaja con su description, así que la prueba real no es verla en la lista: es pedirle la tarea con tus propias palabras y ver si la aplica.
Haz la prueba tres veces formulando la petición de tres maneras distintas, como lo haría alguien que no ha escrito la skill. Si se activa en las tres, está bien descrita. Si solo se activa cuando la nombras explícitamente, la description es demasiado estrecha y hay que ampliarla con las palabras que sí usaste.
Cuando el agente la ignora
No aparece al listar las skills
Es un problema de archivo, no de contenido. Revisa que la carpeta esté en la ruta correcta, que el archivo se llame SKILL.md y que el frontmatter tenga los tres guiones de apertura y de cierre. Un YAML mal cerrado hace que la skill se ignore entera y en silencio.
Aparece pero no se activa sola
La description no encaja con cómo formulas la petición. Reescríbela incluyendo las palabras literales que usarías tú, y añade los sinónimos: "revisar", "analizar" y "comprobar" no son lo mismo para el que decide si activarla.
Se activa cuando no toca
La description es demasiado amplia. Añádele el límite explícito: para qué no sirve. Es la forma más rápida de que el agente deje de usarla en el caso equivocado.
Se activa pero el resultado no es el esperado
Aquí el problema ya no es la instalación sino el cuerpo de la skill: falta proceso, faltan criterios o falta el formato de salida. Esa parte se arregla en el SKILL.md, no en la configuración.
Preguntas frecuentes sobre instalar skills
¿Instalo la skill en el proyecto o en mi usuario?
En el proyecto si tiene que ver con ese trabajo concreto y quieres que la tenga el equipo, porque viaja con el repositorio. En tu usuario si es una forma tuya de trabajar que quieres tener siempre a mano, independientemente del proyecto.
¿Las Agent Skills funcionan en ChatGPT o en Gemini?
El formato nació en el ecosistema de Claude y es ahí donde funciona tal cual. En otros asistentes puedes aprovechar el contenido del SKILL.md pegándolo como instrucciones personalizadas o como prompt de sistema, pero pierdes lo que lo hace especial: que el agente lo active solo cuando toca.
¿Tengo que reinstalar la skill cuando su autor la actualice?
Sí, el archivo que tienes en tu carpeta es una copia. En MundoPrompt las versiones futuras están incluidas en la compra, así que solo tienes que volver a la ficha y descargar la versión nueva sin pagar de nuevo.
¿Cuántas skills puedo tener instaladas a la vez?
Muchas, porque el agente solo lee el nombre y la descripción de cada una hasta que decide usar alguna. El problema real no es el número sino el solapamiento: dos skills con descripciones parecidas compiten entre sí y el agente puede elegir la que no querías.