MENU
Las skills de Claude son carpeta con instrucciones que le enseñan a hacer tareas concretas siempre de la misma forma.
No es un prompt que copias y pegas en cada conversación. No es un modelo distinto ni un plugin de pago. Es un paquete (instrucciones y, opcionalmente, código y archivos) que Claude carga solo cuando lo necesita y aplica por su cuenta, sin que tú le recuerdes nada.
Anthropic las llama oficialmente Agent Skills, y funcionan igual en Claude.ai, en Claude Code, en la API y en el Agent SDK. En este artículo te explico qué son, cómo están hechas por dentro, en qué se diferencian de un prompt y de un servidor MCP, y cómo crear la tuya paso a paso.
Si prefieres verlo en acción, tienes el vídeo completo aquí:
Pero si lo que quieres es entenderlo a fondo, con las cosas que en el vídeo no dio tiempo a desarrollar, sigue leyendo.
Piénsalo como una receta.
Puedes explicarle a alguien cómo se hace tu tortilla cada vez que viene a cenar, o puedes escribir la receta una vez, dejarla en la cocina, y que cualquiera la haga exactamente como a ti te gusta.
Una skill es la receta: la escribes una vez y deja de depender de tu memoria (ni de la de Claude).
La diferencia con un prompt es la persistencia. Un prompt vive en una sola conversación; cuando abres un chat nuevo, vuelta a empezar. Una skill persiste entre conversaciones y se activa sola cuando la tarea encaja.
Y la diferencia con un modelo o un plugin es que aquí no hay magia ni caja negra: una skill es, literalmente, una carpeta con archivos de texto (y como mucho algún script). Eso la hace portable. Puedes compartirla con tu equipo, subirla a GitHub o llevártela de un proyecto a otro.
De hecho, Anthropic ha publicado el formato como estándar abierto, pensado para que la misma skill funcione en Claude y en otras plataformas que lo adopten.
En resumen, una skill aporta lo que un prompt no puede: conocimiento procedimental reutilizable.
El "cómo se hace esto bien, siempre".
No todo merece convertirse en skill. Hay tres señales claras de que sí:
Un consejo importante: empieza pequeño.
Las mejores skills no nacieron enormes; empezaron con unas pocas líneas y una sola "cosa rara" que Claude no acertaba, y fueron creciendo a medida que aparecían nuevos casos. No intentes escribir la skill perfecta a la primera.
Una skill es una carpeta. Dentro, lo único obligatorio es un archivo llamado SKILL.md. Todo lo demás es opcional.
Ese archivo tiene dos partes:
name y description.El name va en minúsculas, con palabras separadas por guiones (a poder ser con un verbo que refleje lo que hace) y un máximo de 64 caracteres. No puede contener las palabras reservadas claude ni anthropic.
Pero la pieza donde de verdad te la juegas es la description.
Aquí está la clave que casi todo el mundo pasa por alto. Las skills no se cargan enteras en el contexto: al iniciar sesión, Claude solo lee el name y la description de cada skill instalada. Esa descripción es lo que usa para decidir, por su cuenta, si activa la skill o no.
Por eso la descripción tiene que cumplir tres cosas:
Si tu skill no se activa cuando esperas, el problema casi nunca está en las instrucciones: está en la descripción.
Aquí conviene parar en lo que es la habilidad más importante con cualquier modelo de lenguaje: la gestión del contexto.
La ventana de contexto es limitada y es el recurso más valioso que tienes. Todo lo que metes ahí ocupa espacio y cuesta tokens, y cuanto más se llena, peor razona el modelo. Si tuvieras 30 skills y todas se cargaran enteras al arrancar, habrías quemado medio contexto antes de escribir tu primer mensaje.
La solución de las skills es elegante y se llama carga progresiva (progressive disclosure). La información se carga en tres niveles:
SKILL.md. Solo se carga cuando Claude decide que esa skill es relevante para lo que le pides. Ahí están las instrucciones completas.Por eso puedes tener muchísimas skills instaladas sin penalización de contexto: solo cargas lo que usas, cuando lo usas.
Esto tiene una consecuencia práctica directa: mantén el SKILL.md ligero (como referencia, por debajo de unas 500 líneas).
No es un cajón de sastre.
Todo lo voluminoso (documentación larga, guías de estilo, ejemplos extensos) va fuera, en la carpeta references/, y el SKILL.md simplemente apunta a ello con un "lee esto cuando…".
El SKILL.md es más un índice que un manual.
Decir que "una skill es solo markdown" es técnicamente cierto y, a la vez, se pierde lo importante. La carpeta puede contener mucho más, y ahí está casi toda la potencia. Hay tres tipos de recursos opcionales:
scripts/ — código que Claude puede ejecutar directamente (por ejemplo, un script de Python que valide un JSON, procese un CSV o formatee un documento). ¿Por qué usar scripts? Porque son deterministas: ante la misma entrada dan el mismo resultado, no dependen de que el modelo tenga un buen día. Y hay un bonus de contexto: el código del script nunca entra en la ventana de contexto; solo entra el resultado de ejecutarlo. Ahorras tokens y ganas fiabilidad.references/ — documentos que Claude lee cuando los necesita: guías de estilo, documentación adicional, ejemplos. Como tener un manual en la estantería que coge y deja según le hace falta.assets/ — archivos que Claude usa en su salida: plantillas, iconos, imágenes, fuentes. Lo que necesite incluir en el resultado final.Regla de oro al escribirlas: referencia siempre estos recursos de forma explícita desde el SKILL.md. Claude no va a adivinar que existe un script en scripts/ ni qué hace; tienes que decirle que está ahí, para qué sirve y cuándo ejecutarlo.
No.
Y esta es la confusión más extendida desde que se extendió el uso de skills .
Mucha gente las plantea como rivales —"para qué quiero MCP si tengo skills"—, pero realmente operan en capas distintas:
MCP le da acceso a Slack.
Una skill le enseña a escribir en Slack como tu empresa.
No compiten: una da acceso y la otra da criterio. Es como darle un coche y además enseñarle a conducir.
Por eso el propio Anthropic describe las skills como la "capa de conocimiento" que se monta encima de un MCP. Si ya tienes un servidor MCP funcionando, has hecho la parte difícil; la skill captura encima los flujos y las buenas prácticas para que Claude los aplique siempre igual. Lejos de sustituir a los MCP, los hacen más inteligentes.
La respuesta correcta no es "MCP o skills". Es entender qué capa estás tocando en cada momento.
Las skills tampoco sustituyen a los prompts ni a los proyectos. Cada herramienta resuelve una necesidad distinta:
| Skills | Prompts | Proyectos | |
|---|---|---|---|
| Qué aportan | Conocimiento procedimental | Instrucciones del momento | Conocimiento de fondo |
| Persistencia | Entre conversaciones | Una sola conversación | Dentro del proyecto |
| Contienen | Instrucciones + código + assets | Lenguaje natural | Documentos + contexto |
| Cuándo se cargan | Dinámicamente, según se necesitan | En cada turno | Siempre, en el proyecto |
| ¿Incluyen código? | Sí | No | No |
| Mejor para | Experiencia especializada | Peticiones rápidas | Contexto centralizado |
La regla rápida: prompt para algo puntual, proyecto para el contexto de fondo de un trabajo concreto, skill para un saber-hacer que quieres reutilizar en todas partes.
Vamos a construir una de las skills más útiles que puedes tener: una que escriba con tu voz. La llamaremos "escribe-como-yo". La idea es darle a Claude ejemplos de cómo escribes y que capture tu estilo, tus muletillas y tu forma de explicar las cosas, para que cada vez que le pidas un texto suene a ti y no a un robot corporativo.
Paso 1. Crea la carpeta. Una carpeta con el nombre de la skill.
Paso 2. Crea el SKILL.md. Dentro, el front matter con name y description. En la descripción, dale pistas claras de cuándo activarla: "Aplica mi estilo personal de escritura a cualquier texto. Úsala siempre que se pidan posts, guiones, artículos o newsletters, o cuando se mencione que algo debe sonar como yo."
Paso 3. Escribe las instrucciones siguiendo tres principios que separan una skill que funciona de una que no:
references/. Paso 2: extrae patrones de tono, longitud de frase, uso de analogías y muletillas. Paso 3: aplícalos al texto."references/ y que tiene que leerlos antes de generar nada.Paso 4. Añade los ejemplos a la carpeta references/: guiones, posts o textos que hayas escrito tú.
Paso 5. Pruébala. Pídele un texto solo con el tema, sin decirle "usa la skill". Si la descripción está bien hecha, Claude detectará que pides contenido tuyo, cargará la skill por su cuenta y leerá tus ejemplos antes de escribir. Eso es la carga progresiva en acción. Compara el resultado con y sin skill: la diferencia es evidente. No es perfecto, pero es un punto de partida infinitamente mejor que empezar de cero cada vez.
Un atajo: existe una skill oficial (skill-creator) cuyo único trabajo es ayudarte a crear y mejorar skills siguiendo las buenas prácticas.
Crear skills con una skill.
Muy meta pero muy útil.
Después de ver montar (y romper) muchas skills, los fallos se repiten:
SKILL.md. Más instrucciones no es mejor comportamiento: es más ruido y más tokens en cada activación. Lo pesado va a references/.No tienes que empezar de cero. Anthropic mantiene un repositorio oficial de skills en GitHub, e incluye las document skills que el propio Claude usa por debajo para crear y editar PowerPoint, Word, Excel y PDF bien formateados. Cuando le pides a Claude un Excel decente, por detrás está usando una skill.
Y luego está la comunidad, que se ha desbocado: skills con metodologías para programar, de diseño frontend, de análisis de seguridad, de estrategia de contenidos… El límite lo pones tú.
Una carpeta con un archivo SKILL.md que contiene instrucciones (y, opcionalmente, scripts y recursos) para que Claude haga una tarea concreta de forma consistente. Claude la carga y la aplica automáticamente cuando la tarea encaja.
No. En su forma básica, una skill es texto en Markdown. Saber programar te permite añadir scripts y llevarla más lejos, pero no es requisito para crear una útil.
El prompt es para una conversación; el proyecto aporta contexto de fondo a un trabajo concreto; la skill es un saber-hacer reutilizable que persiste entre conversaciones y se activa solo. Tienes la comparación completa en la tabla de arriba.
No. MCP da acceso a herramientas externas; la skill enseña a Claude a usarlas con criterio. Se complementan: la skill es la capa de conocimiento que se monta sobre el MCP.
Muchas, sin penalización real de contexto, gracias a la carga progresiva: al inicio solo se cargan los nombres y descripciones, y el resto se lee bajo demanda.
En Claude.ai, Claude Code, la API y el Agent SDK. Ojo: las skills personalizadas no se sincronizan automáticamente entre superficies; si subes una a Claude.ai y la quieres en la API, tienes que subirla también allí.
El formato se ha publicado como estándar abierto en agentskills.io, pensado para ser portable. Si otro agente adopta el estándar, puedes llevarte tus skills contigo.
SKILL.md y la descripción? La descripción, máximo 1024 caracteres. El cuerpo del SKILL.md, idealmente por debajo de unas 500 líneas; todo lo demás, a references/.