¿Cuántos tokens gastan las skills y los plugins en cada turno?
Cada turno lleva solo el nombre y la descripción de cada skill, no el texto completo; un plugin con 6 skills midió unos 221 tokens por turno. La skill completa se carga cuando se usa. Claude Code muestra en /usage lo que añade cada plugin por turno. Codex funciona igual, pero no da una cifra por skill.
Codex
El mismo diseño: nombre, descripción y ruta del archivo al principio, y la skill completa cuando se elige. Codex no muestra una cifra de tokens por skill.
La lista inicial de skills usa como mucho el 2 % de la ventana de contexto, u 8000 caracteres cuando no se conoce el tamaño de la ventana. Con muchas skills instaladas, Codex primero acorta las descripciones, después deja algunas skills fuera de la lista y muestra un aviso. Cuando elige una skill, lee el SKILL.md completo. /usage en la CLI de Codex muestra los tokens por día, por semana y en total, no por skill; para llevar menos, desactiva en ~/.codex/config.toml las skills que no uses.
Qué dice la documentación oficial
Skills use progressive disclosure to manage context efficiently. ChatGPT and Codex start with each skill's name and description, then load the full SKILL.md instructions when they decide to use that skill. In Codex, the initial list also includes each skill's file path.To avoid crowding out the rest of the prompt, this list uses at most 2% of the model's context window, or 8,000 characters when the context window is unknown. If many skills are installed, Codex shortens skill descriptions first. For large skill sets, Codex may omit some skills from the initial list and show a warning./usage — View account token usage or use a rate-limit reset. Inspect daily, weekly, or cumulative ChatGPT token activity from inside the TUI.Claude
Solo el nombre y la descripción de cada skill, en cada turno. /usage muestra lo que añade cada plugin por turno.
Claude Code reúne los nombres y las descripciones de todas las skills en una lista dentro del prompt de sistema. Cada mensaje la lleva, se use o no; después del primer turno se relee a la tarifa de caché. La lista está limitada al 1 % de la ventana de contexto, y la descripción de una skill, a 1536 caracteres; pasado el límite, se eliminan descripciones empezando por las skills que menos invocas. El SKILL.md completo solo se carga cuando se invoca la skill; después se queda en la conversación y se relee en cada turno posterior.
Qué dice la documentación oficial
In a regular session, skill descriptions are loaded into context so Claude knows what's available, but full skill content only loads when invoked.Every skill in the skill listing adds to your context on every turn, whether or not Claude ever uses it. Run /skill-doctor to see what each of your skills costs and how often it gets used, so you can decide which ones to turn off.The budget scales at 1% of the model's context window. When the listing overflows, Claude Code drops descriptions starting with the skills you invoke least, so the skills you use most keep their full text.Skills load on-demand only when invoked, so moving specialized instructions into skills keeps your base context smaller.La fila de plugins en /usage
Ejecuta /usage en Claude Code y busca la fila llamada Plugin skill-listing footprint. Muestra cada plugin con su número de skills y su coste por turno, por ejemplo: diagram-design 6 skills · ~221 tok/turn. Esa cifra es la de un plugin medido, no una media.
El panel de /usage describe la fila así: lo que las descripciones de skills de cada plugin añaden al prompt de sistema (entrada en caché después del primer turno); los agentes y las herramientas MCP aún no se cuentan. En inglés: "What each plugin's skill descriptions add to the system prompt (cached input after the first turn). Agents and MCP tools not yet counted." Esta frase viene del panel, no de la documentación. Los agentes y las herramientas MCP que trae un plugin se suman a la cifra mostrada.
Apaga las skills que no uses
Una skill apagada deja de añadir su descripción a cada turno. Cómo se apaga depende de dónde venga la skill.
Claude Code, skills de un plugin: ejecuta /plugin disable nombre-del-plugin@nombre-del-marketplace, o usa la pestaña Installed de /plugin. Las skills de un plugin solo se pueden apagar así.
Claude Code, tus propias skills: abre /skills, resalta una skill, pulsa Espacio para cambiar su estado y Esc para guardar. name-only conserva solo el nombre; off oculta la skill por completo.
Claude Code, skills que solo lanzas a mano: añade disable-model-invocation: true al principio de SKILL.md. Su descripción deja de viajar en cada turno.
Codex: añade una entrada [[skills.config]] a ~/.codex/config.toml con path = "/path/to/skill/SKILL.md" y enabled = false, y reinicia Codex.
Qué dice la documentación oficial
Plugin skills are not affected by skillOverrides. Manage those through /plugin instead.Use [[skills.config]] entries in ~/.codex/config.toml to disable a skill without deleting itErrores frecuentes
- Con 50 skills instaladas, cada turno lee 50 archivos de skill completos
No. Cada turno lleva solo nombres y descripciones; 6 skills midieron unos 221 tokens en total. El texto completo solo se carga cuando se usa esa skill.
- Cuanto más detallada sea la descripción de una skill, mejor
No. La descripción es la parte que viaja en cada turno, y se recorta: Claude Code permite 1536 caracteres por skill y el 1 % de la ventana de contexto para toda la lista; Codex permite el 2 % para su lista. Pon primero el uso principal y las palabras que la activan, y que sea corta.
- Cuando una skill ya se ha ejecutado, deja de gastar tokens
No. La skill completa se queda en la conversación después de cargarse y se relee en cada turno posterior. Cuando Claude Code compacta una sesión, cada skill invocada conserva sus primeros 5000 tokens, hasta 25 000 en total. Abre una sesión nueva cuando cambies de tarea.
Consejos
- Claude Code: ejecuta /usage y lee la fila Plugin skill-listing footprint. Empieza por el plugin que más tokens añade por turno.
- Claude Code: ejecuta /skill-doctor (v2.1.252 o posterior). Marca las skills que nunca se han invocado y los plugins que no has usado últimamente. La línea Skills de /context es el tamaño actual de toda la lista.
- Cuando una skill se haya ejecutado y pases a otra tarea, usa /clear (/new en Codex). El texto completo de la skill se queda en la sesión hasta que lo hagas.
Anuncios de reinicio de Codex · Anuncios de reinicio de Claude