¿Qué son las Claude skills? Una explicación sin jerga

Una Claude skill es un módulo reutilizable (un archivo SKILL.md más referencias y scripts opcionales) que le enseña a Claude a hacer un tipo de trabajo. Carga bajo demanda: los metadatos están siempre en el contexto, el cuerpo entra cuando se cumple el disparador y los archivos de apoyo solo cargan cuando la skill los pide. Las skills persisten entre sesiones, se versionan en git y siguen el estándar abierto Agent Skills.

Si quieres ir directo a construir una, la guía completa para crear Claude skills cubre toda la anatomía.

Qué es realmente una Claude skill

Una skill no es un prompt. Es un módulo versionado, basado en archivos, que vive en el directorio .claude/skills/ de tu proyecto (o en ~/.claude/skills/ para las skills que quieres tener disponibles en todas partes). El archivo central es SKILL.md, un documento markdown que le da al agente un nombre, una descripción de una línea e instrucciones sobre cómo trabajar. Las referencias, los scripts y los assets van al lado.

La descripción es el mecanismo de activación. Al inicio de la sesión, Claude lee el nombre y la descripción de cada skill en su alcance. Cuando la descripción coincide con tu intención, se carga el cuerpo de la skill. Sin coincidencia, no hay carga. Nada se activa si no hay señal.

La progressive disclosure se encarga del resto.

Por qué existen las skills: los LLMs no tienen estado

Cada sesión de Claude empieza en blanco. No hay memoria, nada se arrastra del trabajo de ayer, ninguna noción de las decisiones de la semana pasada. Es una propiedad de diseño de los LLMs, no un bug de Claude en particular.

Sin skills, esa falta de estado te deja con uno de dos malos resultados. O pegas el mismo bloque largo de contexto en cada sesión (una deuda de prompt que crece y se desactualiza con el tiempo), o aceptas que el comportamiento del agente cambie de una sesión a otra porque las instrucciones no siempre están ahí.

Una skill resuelve las dos cosas. Escribes el método una vez, en un archivo versionado, y carga justo cuando el trabajo lo pide. Las skills sirven para cualquier cosa que haces una y otra vez y no quieres volver a explicar: code review, evaluación de ofertas, formateo de contenido, workflows de git, auditorías de SEO. La única condición es que la tarea tenga una forma consistente. Si la puedes describir en una frase, la puedes convertir en skill.

Cómo carga una skill: tres niveles

El modelo de carga es lo que separa una skill de un archivo markdown que pegas en el contexto. Tres niveles, cada uno condicionado al anterior.

Los tres niveles de carga

1. T1

   Metadatos: siempre en contexto

   El nombre y la descripción de la skill cargan al inicio de cada sesión. Así el modelo sabe que la skill existe y qué tipo de trabajo resuelve. Cuesta casi nada, una o dos líneas por skill.

   +
2. T2

   Cuerpo del SKILL.md: carga al activarse

   Cuando la descripción coincide con la intención del usuario, carga el cuerpo completo del SKILL.md. Ahí viven las instrucciones, los modos de salida y el mapa de carga de referencias: el método que va a seguir el agente.

   +
3. T3

   Referencias y scripts: cargan bajo demanda

   Los archivos de apoyo (conocimiento destilado, checklists de decisión, plantillas, scripts) solo cargan cuando el mapa de carga del SKILL.md le indica al modelo que los busque. Nada carga solo. La skill decide.

Una skill con veinte archivos de referencia cuesta una línea de metadatos por sesión hasta que se activa. Después, solo entran al contexto las referencias que necesita la tarea actual. El mapa de carga le dice al modelo exactamente qué leer. Todo lo demás se queda en disco.

Qué va dentro de una skill

La mayoría de las skills tiene tres partes: el router (SKILL.md), la base de conocimiento (references/) y la automatización opcional (scripts/). El router es obligatorio. El resto crece a medida que la skill madura.

Anatomía de una skill

1

SKILL.mdel router: nombre, descripción, instrucciones, mapa de carga

1-20

references/conocimiento destilado, dividido por dominio de decisión

0+

scripts/helpers en shell o Python que la skill puede invocar

0+

assets/plantillas, schemas o archivos de salida de ejemplo

Dentro de SKILL.md, el mapa de carga es la parte que casi todos se saltan y después no entienden por qué la skill rinde poco. Es una tabla (o una lista corta) que asocia tipos de preguntas con los archivos de referencia que las responden. Una pregunta de precios carga la referencia de precios. Un code review carga el checklist de review. Sin el mapa, el agente adivina.

La línea de descripción es la otra cosa que vale la pena dejar exacta. Es una frase disparadora, no documentación. Escríbela como la frase que dirías naturalmente cuando necesitas esa skill. Las descripciones vagas no se activan. Las precisas se activan siempre.

Las skills siguen un estándar abierto

Las Claude skills implementan el estándar abierto Agent Skills, lo que significa que la arquitectura no es propietaria de Claude Code. El mismo módulo SKILL.md (mismo nombre, descripción, referencias y mapa de carga) es portable a cualquier runtime de agentes que soporte el estándar.

He estado construyendo skills en mi propia biblioteca, en ~/Work/my-second-brain/.agents/skills/. Skills de persona como alex-hormozi se encargan de evaluar ofertas. Un sistema lifeos-* cubre tareas de operación personal: revisiones semanales, ritmos de planificación, registros de decisiones. Cada una es un módulo autocontenido: un router, un puñado de referencias destiladas, un mapa de carga ajustado. Ninguna es ingeniosa. Son solo método que carga bajo demanda.

Para ejemplos reales de cómo se ven, mira ejemplos de Claude skills de mi propia biblioteca. Para el límite entre skills y subagents con MCP (una duda que aparece rápido cuando empiezas a construir), mira Claude skills vs MCP y subagents.

En resumen

Una Claude skill es un módulo versionado, basado en archivos, que le enseña a un agente a hacer un tipo de trabajo. Metadatos en contexto. Cuerpo al activarse. Referencias bajo demanda. Sin deuda de prompt, sin deriva entre sesiones, sin volver a explicar lo mismo cada lunes.

Las skills existen porque los LLMs olvidan. Una buena skill no.

Si estás listo para construir la primera, la guía completa para crear Claude skills recorre cada decisión: estructura de archivos, mapa de carga, referencias y cómo probar si algo de eso funcionó de verdad.

Preguntas frecuentes

¿Qué es una Claude skill, en pocas palabras?+

Una Claude skill es un módulo reutilizable (un archivo SKILL.md más referencias y scripts opcionales) que le enseña a Claude a hacer un tipo de trabajo. Carga bajo demanda, persiste entre sesiones y se versiona en git como cualquier otro archivo.

El método persiste en un archivo. Solo entra al contexto cuando el trabajo lo necesita.

¿Cuál es la diferencia entre una Claude skill y un prompt?+

Un prompt es una instrucción de sesión: lo pegas, lo usas y lo vuelves a pegar la próxima vez. Una skill es un módulo persistente, basado en archivos, que carga automáticamente cuando la descripción coincide con tu intención.

El prompt se pierde entre sesiones. La skill se queda.

¿Cómo sabe Claude cuándo activar una skill?+

La línea de descripción del SKILL.md es el disparador. Claude lee los metadatos de todas las skills al inicio de la sesión. Cuando la descripción coincide con la intención del usuario, carga el cuerpo completo del SKILL.md. Sin coincidencia, no hay carga.

¿Qué es la 'progressive disclosure' en el contexto de las Claude skills?+

La progressive disclosure es el modelo de carga: los metadatos (nombre y descripción) están siempre en el contexto; el cuerpo del SKILL.md carga cuando se activa el disparador; los archivos de referencia solo cargan cuando el mapa de carga de la skill indica que hay que buscarlos.

Nada carga solo. Solo entra al contexto lo que necesita la tarea actual.

¿Qué va dentro de un archivo SKILL.md?+

Como mínimo: un nombre, una descripción de una línea (el disparador) e instrucciones para el agente. Una skill madura también incluye un mapa de carga, una tabla que dirige cada tipo de pregunta a los archivos de referencia que la responden. El mapa de carga es la parte que casi todos se saltan y después lamentan.

¿Puedo usar Claude skills fuera de Claude Code?+

Sí. Las skills siguen el estándar abierto Agent Skills, así que el mismo módulo SKILL.md es portable a cualquier runtime de agentes que soporte el estándar.

El método vive en el archivo, no en la herramienta.

¿Dónde busca Claude las skills?+

Las skills de proyecto viven en el directorio .claude/skills/ del proyecto y aplican solo a ese proyecto. Las skills de usuario viven en ~/.claude/skills/ y están disponibles en todas las sesiones. Ambas son archivos markdown simples que el agente lee al inicio de la sesión.

¿Las skills hacen más lento al modelo o se comen la context window?+

No más de lo necesario. Los metadatos son mínimos: un nombre y una descripción por skill. El cuerpo del SKILL.md solo carga al activarse. Los archivos de referencia solo cargan cuando el mapa de carga los pide.

Una skill con veinte archivos de referencia cuesta más o menos una línea de metadatos por sesión hasta que se activa. Después, solo entran al contexto las referencias relevantes.

¿Para qué tipo de tareas vale la pena crear una skill?+

Cualquier cosa que haces una y otra vez con una forma consistente: code review, evaluación de ofertas, formateo de contenido, auditorías de SEO, workflows de git, planificación semanal. Si puedes describir la tarea en una frase y ya la hiciste más de un puñado de veces, vale una skill.

Las tareas puntuales no valen la pena. La ganancia está en reutilizarla entre sesiones.