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.
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.
Resumen
- Idea Central: Claude comprueba la descripción de cada Skill disponible contra la tarea actual y carga las instrucciones completas solo para la Skill que coincide.
- Por Qué Importa: Es lo que hace que las Skills se sientan automáticas: describes la tarea, no la herramienta, y aparecen las instrucciones correctas.
- Conceptos Clave: índice de descripciones, carga bajo demanda, palabras clave de activación, especificidad de la descripción, descripciones superpuestas.
- Cuándo Usar: Relevante siempre que estés decidiendo cómo redactar la descripción de una Skill o depurando por qué una Skill se activó o no.
- Limitaciones / Compensaciones: La coincidencia depende completamente de la redacción; una Skill bien construida con una descripción vaga se comporta como si no existiera.
- Temas Relacionados: Anatomía de SKILL.md, Fundamentos de Agent Skills, señales de que una Skill no se descubre, cómo escribir una descripción eficaz.
Fundamentos
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.
Mecánica e Interacciones
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.
Consideraciones Avanzadas y Aplicaciones
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.
Conceptos Erróneos Comunes
- "Claude lee las instrucciones de cada Skill en cada mensaje." — Comprueba primero las descripciones ligeras; las instrucciones completas solo se cargan para una Skill coincidente, manteniendo las conversaciones no relacionadas sin afectar.
- "Una descripción más larga coincide de forma más fiable." — La especificidad, no la longitud, impulsa la coincidencia; una descripción corta con las palabras clave correctas supera a una larga y vaga.
- "Si mi Skill no se activa, las instrucciones deben estar mal." — Las instrucciones ni siquiera se evalúan hasta que ocurre una coincidencia de descripción; comprueba la descripción antes de tocar el cuerpo.
- "Tener muchas Skills ralentiza a Claude." — Las Skills no coincidentes añaden una sobrecarga insignificante, ya que solo se comprueban sus descripciones cortas, no su contenido completo.
- "Necesitas nombrar la Skill en tu mensaje para que funcione." — El descubrimiento está diseñado para funcionar solo con el lenguaje natural de la tarea; nombrar una Skill directamente es opcional, no obligatorio.
Preguntas Frecuentes
¿Qué se comprueba realmente cuando envío un mensaje?
- Claude compara tu tarea con las descripciones de tus Skills actualmente disponibles, no con sus instrucciones completas.
- Solo el cuerpo completo de una Skill coincidente se carga en la conversación.
¿Por qué mi Skill no se activó aunque describí la tarea correcta?
- La causa más común es una descripción que no utiliza un lenguaje lo suficientemente cercano a cómo redactaste realmente la solicitud.
- Revisar la descripción para incluir las palabras clave exactas que usas en la práctica es la solución habitual.
¿Pueden dos Skills coincidir con el mismo mensaje?
- Es posible si sus descripciones se superponen; Claude tiene que elegir, lo que puede producir resultados inconsistentes.
- Acotar la descripción de cada Skill a una activación distinta reduce este riesgo.
¿Tener muchas Skills instaladas ralentiza las cosas?
- No, no de forma significativa; solo se comprueban descripciones cortas contra cada tarea; las instrucciones completas solo se cargan para una coincidencia.
¿Necesito decir el nombre de la Skill para usarla?
- No; el descubrimiento está diseñado para funcionar con la redacción ordinaria de la tarea. Nombrar una Skill directamente es una opción, no un requisito.
¿Cuál es la diferencia entre un problema de descubrimiento y un problema de instrucciones?
- Un problema de descubrimiento significa que la Skill nunca se carga; soluciona la descripción.
- Un problema de instrucciones significa que la Skill se carga pero produce el resultado incorrecto; soluciona el cuerpo.
¿Debería crear una Skill amplia o varias estrechas?
- Varias Skills estrechas con descripciones distintas generalmente coinciden de forma más fiable que una Skill amplia que intenta cubrir muchas tareas no relacionadas.
¿Qué tan específica debe ser realmente una descripción?
- Lo suficientemente específica como para nombrar tanto lo que hace la Skill como dos o tres redacciones reales que alguien usaría para solicitarla, no solo una etiqueta de categoría abstracta.
¿La coincidencia se basa en palabras clave exactas o en algo más flexible?
- Se basa en el significado y la redacción de la descripción que coinciden con el significado y la redacción de la tarea; una redacción cercana y natural funciona mejor que intentar manipular palabras clave exactas.
¿Puedo probar si una Skill se está descubriendo correctamente?
- Sí; envía el tipo de mensaje que usarías naturalmente para esa tarea y comprueba si la salida sigue las instrucciones de la Skill, o pregunta directamente qué Skill se utilizó.
Relacionado
- ¿Qué son las Agent Skills? - los bloques de construcción básicos a los que pertenece una descripción
- Anatomía de un Archivo SKILL.md - dónde se encuentra el campo de descripción en la estructura del archivo
- Señales de que Claude no está descubriendo tu Skill - una lista de diagnóstico para fallos de descubrimiento
- Escribir una Descripción de Skill Eficaz que Claude Activará - un análisis más profundo de la redacción de descripciones
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.