/skill-doctor en Claude Code: haz limpieza de skills que nunca usas

Cada skill que tienes cargada escribe una línea en tu system prompt en cada turno, la uses o no. `/skill-doctor` las pone en una tabla con lo que cuesta cada una, cuántas veces ha corrido y cuándo fue la última. En la mía, 24 de 43 no habían corrido jamás.

Listado de skills de Claude Code: una barra donde 24 skills nunca invocadas ocupan 3.020 de los 4.470 tokens que viajan en cada turno, y cuatro tarjetas con el origen de cada skill y dónde se apaga

TL;DR /skill-doctor (v2.1.252 o superior) te saca una fila por skill con lo que su descripción te cuesta en cada turno, cuántas veces la has invocado y cuándo fue la última. Las filas amarillas nunca han corrido. Las que además llevan un número en context te están costando ese número de tokens en cada turno desde que las instalaste. Apágalas según su origen: /skills, /plugin, /mcp o claude.ai.

Llevas meses añadiendo skills. Unas las escribiste tú, otras llegaron dentro de un plugin que instalaste para una tarde concreta. Todas escriben su línea de descripción en el system prompt en cada turno, se usen o no, porque Claude tiene que verlas para poder elegirlas. El problema no era pagarlo, era que nada te decía cuáles llevaban meses cobrando sin trabajar. Desde la v2.1.252 hay un comando que las nombra una por una.

Resultado (mi propia sesión, recortada):

$ claude -p "/skill-doctor"

Skills loaded this session

  skill                                      source               context  7d tokens   uses  last used
  carousel                                   userSettings            ~130          -     0×  never
  cc-cleanup                                 userSettings             ~90          -     0×  never
  lead-magnet                                userSettings            ~100          -     0×  never
  tip-board                                  userSettings             ~50          -     0×  never
  chrome-devtools-mcp:a11y-debugging         chrome-devtools-mcp      ~80          -     0×  never
  figma:figma-generate-design                figma                   ~290          -     0×  never
  figma:figma-design-to-code                 figma                   ~180          -     0×  never
  craft:close                                craft                      -          -     0×  never
  [29 filas más]
  seo-optimize                               userSettings               -          -     4×  181 days
  svg-illustration                           userSettings             ~30          -    16×  19 days
  claude-code-tip                            userSettings             ~30      25.9m   213×  today

  context = this skill's one-line listing in the system prompt, included every turn
  (dash = not in the current listing, costs nothing; full SKILL.md loads only when it runs)
  7d tokens = tokens attributed to the skill over the last 7 days of sessions on this machine

Plugins not used recently

  figma  last used 31 days ago
  typescript-lsp  last used 18 days ago

  Manage these in /plugin

43 skills, 4.470 tokens de listado. De esas, 24 no se habían invocado jamás, y esas 24 se llevaban 3.020 de los 4.470. Dos tercios de lo que pagaba en cada turno era por trabajo que nunca se hizo. El plugin de figma solo, catorce skills y 2.190 tokens, y lo había abierto por última vez hacía 31 días.

Cómo se lee la tabla

Tres cosas que no se ven a la primera y cambian a qué filas haces caso.

El guion en context significa gratis. Una skill con guion no está en el listado de este momento, así que su descripción no viaja en el prompt y no te cuesta nada. Mi craft:close sale en amarillo y no hay nada que apagar ahí. Lo que persigues son las amarillas con número.

Amarillo es "nunca", no "ya no". La marca es cero invocaciones desde que la instalaste, no un tiempo sin tocarla. Mi seo-optimize corrió 4 veces hace 181 días y sale en blanco. Quien lleva la cuenta del tiempo es la sección de abajo, la de plugins, con su last used.

Los avisos del final son un subconjunto de las filas amarillas. Al pie de la tabla Claude Code resume lo que ha encontrado (4 skills loaded but never invoked. Each one adds to the system prompt every turn. Disable in /skills, or remove from .claude/skills., y otra línea para las quince de plugin). Pero una skill de plugin solo entra en ese aviso si ninguna otra skill de ese mismo plugin ha corrido. Por eso mis cuatro de chrome-devtools-mcp están amarillas en la tabla y no aparecen en ningún aviso: dos hermanas suyas sí se usaron. Fíate del color de las filas, no del recuento del final.

Cómo hacer la limpieza

1. Saca el informe

/skill-doctor

Dentro de la sesión te lo abre en la pestaña Stats del gestor de plugins. Si lo quieres como texto plano, para pegarlo o pasarlo por grep, lánzalo en modo no interactivo:

claude -p "/skill-doctor"

2. Ordena por lo que te cuesta, no por el número de filas

Las amarillas con número, de mayor a menor context. Una skill de 290 tokens que no has usado nunca pesa lo mismo que tres de 90. La tabla viene ordenada por tiempo sin usarse, no por coste, así que ese orden lo pones tú.

3. Apágala donde le toque según su origen

La columna source no es decorativa: dice en qué sitio se apaga esa skill, y son cuatro sitios distintos. Las tuyas de ~/.claude/skills salen del listado con /skills o borrando la carpeta. Las de un plugin no se pueden apagar de una en una: o cae el plugin entero en /plugin, o se quedan. Las de un servidor MCP viven en el servidor, así que apagarlo en /mcp te quita también sus tools. Y si la sincronizaste desde claude.ai, borrar la copia local no sirve de nada: vuelve en el siguiente sync, hay que apagarla allí.

Referencia

`source`	Qué es	Dónde se apaga
`userSettings` / `projectSettings`	Tuya, en `~/.claude/skills` o en el repo	`/skills`, o borra la carpeta
Nombre de plugin (`figma:…`)	Viene dentro de un plugin	`/plugin`, el plugin entero
Nombre de servidor MCP	Vive en el servidor, no en disco	`/mcp`, y pierdes también sus tools
Sincronizada desde claude.ai	Copia local de una skill de la web	En claude.ai, o vuelve al sincronizar
Bundled / de empresa	Las que trae Claude Code o tu organización	No salen en el informe

El informe no es un barrido general. Si lo que quieres es que alguien mire todo a la vez (skills, MCP, plugins, CLAUDE.md inflado, hooks lentos) y te proponga los cambios, eso es la revisión completa de /doctor: ese decide por ti y te pide permiso, este te da los números y decides tú. Para el peaje de los plugins enteros está el detector de "Not used recently", y para ver a cuánto asciende todo el listado junto, /context.

Y si lo que quieres saber no es cuáles no usas sino cuáles te están saliendo costosas de verdad, esa es la otra mitad: /usage te reparte el consumo por skill y por MCP en tokens gastados. Este informe mira la otra cara, la de las que no gastan nada porque no han corrido nunca y aun así ocupan sitio.

Un aviso sobre lo que vas a apagar: una skill que nunca se ha invocado no siempre es una skill que sobre. A veces está escrita de forma que Claude no la encuentra, y entonces el arreglo es la descripción, no el borrado. Ahí manda cómo se escribe una skill que sí se activa.

Documentación oficial: Find unused skills

Requisitos: Claude Code v2.1.252 o superior. Necesita que la sesión reciba feature flags, así que no lo tienes en Bedrock, Vertex o Foundry ni con la telemetría desactivada. Por Remote Control, desde el móvil o el navegador, responde Skill usage reports are not available on this connection.: hay que correrlo en el terminal de la máquina donde vive la sesión. La columna 7d tokens sale de escanear los transcripts guardados en tu disco, y en organizaciones reguladas por HIPAA no se muestra.