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 parades directas
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.
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.
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