/skill-doctor: quita las skills que pagas y no usas

Primero: qué es una skill

Una skill es un archivo de texto con instrucciones que le enseñan al asistente a hacer una tarea concreta a tu manera. Cómo redactáis un presupuesto. Qué revisáis antes de publicar. Cómo se cierra un mes. Se guarda en una carpeta con el nombre SKILL.md y, a partir de ahí, el asistente puede usarla solo cuando toca o puedes llamarla tú escribiendo su nombre con una barra delante ¹.

Es, básicamente, el manual de la casa en un formato que la máquina entiende. Por eso me parece de lo más útil que hay para una empresa: no cambias de herramienta, le explicas cómo trabajáis aquí.

Si quieres la explicación larga y en castellano, Daniel Ávila tiene casi una hora de curso dedicada a las skills ³.

El detalle que casi nadie tiene en cuenta viene ahora. Para que el asistente sepa qué skills tiene disponibles, la descripción de todas ellas se le cuenta en cada turno de la conversación. La skill entera solo se carga cuando se usa, pero el listado va siempre ¹. Y ese listado ocupa sitio en el contexto, que es la memoria de trabajo de la sesión: limitada y compartida con todo lo demás. Tener treinta skills instaladas y usar cuatro significa pagar el peaje de veintiséis todo el rato.

El comando: /skill-doctor

Claude Code incorporó el comando en la versión 2.1.261. Su changelog oficial lo describe así, sin adornos: «muestra qué skills cargadas no se usan y lo que cuestan en contexto, para que puedas podarlas» ².

Se escribe tal cual en una sesión de Claude Code: /skill-doctor. No hace falta instalar nada si tienes esa versión o posterior; si no te aparece, actualiza.

El informe te da tres cosas que por separado no valen nada y juntas sí: qué skills están cargadas, cuántas veces se ha disparado cada una y cuántos tokens de contexto te cuesta cada turno tenerlas ahí. Con eso ya no hay que adivinar: lo que se ve son las que llevas cargando semanas sin haberlas usado nunca.

Cómo leer el informe sin cargarte nada

Mi orden sería este, y es criterio, no doctrina.

Uno: mira primero la columna de veces usadas, no la de tokens. Una skill que cuesta mucho pero se dispara a diario está haciendo su trabajo. Una que cuesta poco y no se ha usado nunca sigue siendo ruido en el listado y una candidata a que se dispare cuando no toca.

Dos: antes de borrar nada, pregúntate si no se usa porque no hace falta o porque está mal descrita. Este es el error que más veo venir. La descripción es lo que el asistente lee para decidir si le sirve ¹; si está escrita en abstracto, la skill no se dispara aunque sea buenísima. Ahí la solución es reescribir la descripción, no tirar la skill.

Tres: si quieres conservarla pero que deje de saltar sola, no hace falta borrarla. Puedes marcarla para que solo la invoques tú, con disable-model-invocation, y sigue estando disponible cuando la llames por su nombre ¹.

Cuatro: si la borras, borra la carpeta y listo. Las personales viven en tu carpeta de usuario y las del proyecto dentro del repositorio; las del proyecto son de todo el equipo, así que esas se hablan antes de tocarlas ¹.

Y un aviso de calibración: Claude Code vigila las carpetas de skills durante la sesión, así que añadir o editar se nota al momento, pero crear una carpeta de skill nueva por primera vez pide reiniciar ¹. Si acabas de limpiar y algo se comporta raro, reinicia antes de dar por rota la configuración.

Por qué esto no es manía de ordenado

Porque el problema de fondo no es el gasto, es la puntería. Un asistente con cuarenta skills instaladas tiene cuarenta descripciones compitiendo por su atención en cada turno, y las equivocaciones no las ves: se manifiestan como respuestas peores sin que nadie sepa por qué.

El patrón se repite en cualquier empresa que lleve un año con esto. Se instalan cosas para probar, nadie las desinstala, y al cabo de unos meses la configuración es un desván. La diferencia entre un desván y un almacén es que alguien pasa a revisarlo de vez en cuando.

Si en tu equipo hay varias personas usando Claude Code, yo propondría exactamente una rutina: que cada uno lance /skill-doctor una vez al mes y comparta las que no ha usado nunca. En quince minutos sabes qué parte de vuestro manual digital está muerta, y probablemente descubras que dos personas escribieron la misma skill con nombres distintos.