Cómo Claude descubre y carga Skills automáticamente
Claude escanea las descripciones de las Skills para hacer coincidir las tareas entrantes y cargar las instrucciones correspondientes bajo demanda.
//
Busca en todas las páginas de la documentación
Claude escanea las descripciones de las Skills para hacer coincidir las tareas entrantes y cargar las instrucciones correspondientes bajo demanda.
Este es el mecanismo que te permite crear una biblioteca de Skills sin tener que nombrar una cada vez que quieras que se use.
Comprender cómo funciona realmente la coincidencia es la forma más rápida de solucionar una Skill que no se activa o de escribir una nueva que lo haga.
Cada Skill que pones a disposición de Claude tiene dos partes que son importantes para el descubrimiento: su nombre y, mucho más importante, su descripción.
Claude no lee las instrucciones completas de cada Skill en cada mensaje; eso añadiría una longitud innecesaria a cada conversación, la mayoría de las cuales no necesitan ninguna Skill.
En su lugar, mantiene algo parecido a una tabla de contenidos: el nombre y la descripción de cada Skill, mantenidos de forma ligera para poder comprobarlos rápidamente contra lo que acabas de pedir.
Cuando llega tu mensaje, Claude lo compara con esa tabla de contenidos, buscando una descripción que coincida con la forma de la tarea.
Si una coincide, Claude carga el cuerpo completo de SKILL.md de esa Skill —los pasos reales, el formato o las reglas— en su contexto de trabajo antes de empezar a procesar tu solicitud.
Si nada coincide, Claude simplemente responde de forma normal, sin ninguna Skill involucrada.
Este proceso de dos pasos —una comprobación barata contra descripciones cortas, seguida de una carga completa solo si hay coincidencia— es la razón por la que puedes tener muchas Skills disponibles sin que cada conversación se ralentice o se llene de instrucciones irrelevantes.
El campo de descripción es el que realiza el trabajo real de descubrimiento, y vale la pena ser preciso sobre lo que lo hace eficaz.
Una buena descripción indica dos cosas: qué hace la Skill y cuándo debe usarse, idealmente usando el tipo de palabras que una persona escribiría naturalmente al solicitar esa tarea.
description: >-
Generates the weekly team status report in our standard format.
Use when asked for a weekly update, status report, or team summary.Observa que esta descripción no dice simplemente "maneja informes", sino que nombra la tarea específica y enumera tres formas en que alguien podría solicitarla.
Esa especificidad importa porque Claude está comparando con el lenguaje real de la tarea, no con una etiqueta de categoría que tenías en mente al escribirla.
Una descripción demasiado amplia corre el riesgo de activarse en tareas para las que no estaba destinada; una descripción demasiado estrecha o abstracta corre el riesgo de no activarse nunca, incluso en la tarea exacta para la que fue creada.
Cuando la descripción de más de una Skill podría cubrir plausiblemente la misma solicitud, Claude tiene que elegir, por eso mantener las descripciones distintas entre sí es importante a medida que tu biblioteca de Skills crece, no solo mantener cada una individualmente clara.
El cuerpo de las instrucciones, por el contrario, no necesita estar optimizado para la coincidencia en absoluto; solo se lee después de que una Skill ya ha sido seleccionada, por lo que puede ser tan largo y detallado como la tarea realmente requiera.
A medida que la biblioteca de Skills de un equipo crece más allá de un puñado de entradas, la fiabilidad del descubrimiento se convierte en un problema de diseño, no solo en un ajuste de redacción.
| Situación | Qué Sucede | Solución |
|---|---|---|
| Descripción demasiado vaga ("maneja informes") | Rara vez o nunca coincide con solicitudes reales | Añade frases de activación concretas que alguien escribiría realmente |
| Dos Skills con descripciones superpuestas | Claude puede elegir la incorrecta, de forma inconsistente | Acota cada descripción a su activación distinta |
| Descripción precisa pero instrucciones escasas | La Skill se activa correctamente pero la salida no coincide con las expectativas | Esto no es un problema de descubrimiento; revisa el cuerpo, no la descripción |
| La Skill cubre demasiadas tareas no relacionadas | La descripción se vuelve amplia y poco enfocada, perjudicando la coincidencia | Divide en dos o más Skills de propósito único |
Un hábito útil es tratar la descripción como una consulta de búsqueda que estás preescribiendo en nombre de cada futura versión de ti mismo que pueda solicitar esta tarea con palabras ligeramente diferentes.
Eso significa probar una nueva Skill con la redacción real que esperas usar día a día, no un mensaje de prueba genérico, y revisar la descripción después de observar un resultado real en lugar de adivinar de antemano.
Esta es también la razón por la que los problemas de descubrimiento y los problemas de instrucciones se confunden: una Skill que nunca se activa y una Skill que se activa pero produce el resultado incorrecto se ven similares desde fuera, pero la solución vive en una parte diferente del archivo cada vez.
Versiones de Stack: Escrito contra la línea de modelos de Claude actual a partir de ~junio de 2026 - Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (el predeterminado) y Claude Haiku 4.5. Los nombres de los modelos, los precios y las características del producto cambian rápidamente; verifica los detalles actuales en platform.claude.com/docs antes de confiar en ellos.
Revisado por Chris St. John·Última actualización: 16 jul 2026