Inicio / Extender: habilidades, MCP, subagentes, hooks, plugins
El enrutamiento de las skills falla en silencio
Claude decide invocar una skill comparando el vocabulario de la solicitud con el único campo description de esa skill, y un desajuste de idioma o de jerga entre ambos hace fallar la invocación automática sin ninguna señal visible en la respuesta.
Nada indica, en el momento de una solicitud, que una skill instalada cubra exactamente el tema: Claude decide invocarla comparando el vocabulario de la solicitud con el campo description de esa skill, y una skill que no coincide con ninguna palabra de la solicitud permanece silenciosa (fuente code.claude.com/docs/en/skills, consultada el 2026-09-02).
Un solo campo decide
La documentación es explícita en este punto: description dice lo que hace la skill y cuándo usarla, es el único texto que Claude lee para decidir invocarla automáticamente. Cuando este campo está ausente, Claude recurre al primer párrafo del archivo SKILL.md. Este texto también se trunca a mil quinientos treinta y seis caracteres en el listado presentado al modelo, para limitar el costo en tokens: una descripción larga cuyo caso de uso principal aparece al final del texto pierde exactamente la frase que habría activado la invocación.
El desajuste de vocabulario no avisa a nadie
Una skill descrita en inglés para un uso llamado chart o dataviz puede no activarse ante una solicitud en español que habla de gráfico, aunque la necesidad sea idéntica. Una skill descrita para resumir un ticket puede no activarse ante una solicitud que habla de sintetizar un incidente. La respuesta llega de todas formas, escrita por Claude directamente, y nada en su forma distingue una respuesta que movilizó la skill instalada de una respuesta que la ignoró.
---
description: Crée des graphiques et des tableaux de bord à partir de données
---Dos formas directas de evitarlo
La primera consiste en formular la solicitud con el vocabulario mismo de la descripción instalada, lo que supone haberla leído al menos una vez. La segunda consiste en invocar la skill directamente por su nombre, con la barra oblicua, en lugar de contar con la correspondencia automática: la misma skill se invoca entonces sin importar la palabra elegida en la frase que sigue.
Este riesgo de no activación se conecta directamente con lo que se enseña en skills, enseñar un workflow a Claude: una skill correctamente escrita pero jamás invocada no vale más que una skill que no existe.
Una skill sin uso es un defecto de activación
Contar las invocaciones de una skill no dice si es útil, solo si se ofrece en el momento adecuado. Una skill que nunca se invoca puede tener una descripción que no coincide jamás con el vocabulario de las peticiones reales, o que aparece por error en peticiones sin relación. Archivarla no corrige nada. Prepara diez peticiones que deberían activarla y diez que no, anota para cada una si la skill se ofrece, y añade un testigo positivo: una petición que repite la descripción palabra por palabra debe activarla, si no la medición está rota. Corrige después la descripción, no la skill.
Desde octubre de 2026, una skill también se encuentra por el nombre de su SKILL.md cuando su carpeta lleva otro nombre, y la lista muestra los dos: un fallo al invocarla por el nombre ya no hay que buscarlo por ese lado.
El límite de truncamiento del campo description
Misma skill instalada, misma necesidad, vocabulario distinto
| Una skill descrita en inglés con las palabras chart y dataviz, frente a dos formulaciones de una misma solicitud | Palabras empleadas en la solicitud | Coincidencia con la descripción instalada | Skill invocada automáticamente |
|---|---|---|---|
| Solicitud alineada con la descripción | chart, dataviz | fuerte | sí |
| Solicitud reformulada con otro vocabulario | gráfico, tablero | débil | no |
La descripción de la skill instalada para este uso emplea las palabras chart, dataviz y visualization en su archivo SKILL.md. Un usuario le pide a Claude construir un gráfico a partir de una tabla de cifras que acaba de pegar en la conversación. Claude responde escribiendo directamente, en el cuerpo de su respuesta, el código del gráfico pedido.
Escribe en una frase lo que esta situación establece, y en una frase lo que no establece.
Lo que esto establece: En este intercambio, Claude produjo el gráfico sin pasar por la skill instalada para este uso, cuando el vocabulario de la solicitud no coincidía con el de su descripción.
Lo que esto no establece: Que la misma skill fallaría también en activarse ante una solicitud que retomara las palabras exactas de su descripción, chart o dataviz por ejemplo.
Los tres calibrados falsos más frecuentes
- Demasiado amplio Este intercambio prueba que esta skill jamás se activa, sea cual sea el vocabulario empleado en una solicitud futura.
- Demasiado estrecho Este intercambio no prueba nada, ya que se formuló una sola solicitud ante una sola skill instalada.
- Fuera de tema Este intercambio muestra que la descripción de esta skill supera el límite de mil quinientos treinta y seis caracteres aplicado al listado presentado al modelo.
- Claude decide invocar una skill comparando el vocabulario de la solicitud con el único campo description de esa skill.
- La descripción combinada de una skill se trunca a mil quinientos treinta y seis caracteres en el listado presentado al modelo, para limitar el costo en tokens.
- Un desajuste de idioma o de jerga entre la solicitud y la descripción instalada hace fallar la invocación automática sin ninguna señal visible en la respuesta.
- Formular la solicitud con el vocabulario de la descripción instalada, o invocar la skill directamente por su nombre, evita este riesgo.
- Una skill que casi no se invoca se diagnostica midiendo las peticiones que la activan, con un testigo positivo, antes de pensar en archivarla.
Abre el archivo SKILL.md de una skill que usas regularmente, anota tres palabras exactas de su campo description, y reformula una solicitud reciente con esas palabras para verificar que sí activa esta skill.
Estos puntos dependen de una interfaz o de una regla que puede haber cambiado desde la redacción. Verifícalos en tu propia pantalla antes de fiarte de ellos.
- El umbral de truncamiento de mil quinientos treinta y seis caracteres es un detalle de implementación del harnais, susceptible de cambiar con una futura versión, a reverificar en https://code.claude.com/docs/en/skills antes de citarlo como un límite fijo.
Cada afirmación datable de esta lección remite aquí al texto público que la respalda. Una fuente que no se abre no prueba nada.
- Anthropic, Claude Code, referencia de las skills consultée le 2026-09-02
- Registro de cambios de Claude Code: skill encontrada por el nombre de su SKILL.md consultée le 2026-10-24