Claude Code 2.1.261 agregó /skill-doctor, un comando de mantenimiento para encontrar skills que permanecen cargadas en contexto aunque casi nunca se usan.
Eso parece pequeño hasta que tu setup acumula meses de skills, plugins, experimentos y helpers de proyecto. Las skills son mejores que volcar cada procedimiento en CLAUDE.md, porque el cuerpo completo solo se carga cuando hace falta. Pero el listado de skills sigue costando contexto en cada turno: Claude necesita nombres y descripciones para saber qué herramientas tiene disponibles.
/skill-doctor vuelve visible ese costo.
¿Cómo saber qué skills usa Claude Code?
Para saber qué skills usa Claude Code, ejecuta /skill-doctor en la sesión de terminal donde está corriendo Claude Code.
La documentación de Anthropic dice que el comando muestra cuánto cuesta cada skill y con qué frecuencia se usa, para que puedas decidir cuáles desactivar. En una sesión interactiva, el reporte se abre en la pestaña Stats del manager /plugin. En modo no interactivo con -p, Claude Code imprime el reporte como texto.
Esa diferencia importa para usuarios avanzados. Si administras una sola estación local, el reporte visual alcanza. Si mantienes un setup compartido, un repositorio plantilla, un devcontainer o un paquete de plugins de equipo, la salida de texto se parece más a un artefacto auditable.
El reporte no cubre todo. Al momento de publicar esta nota, el 7 de septiembre de 2026, la documentación dice que cubre las skills de tu sesión excepto las bundled skills y las enterprise skills. También requiere Claude Code v2.1.252 o posterior, depende de la carga de feature flags y no está disponible desde sesiones de Remote Control en teléfono o navegador. Ejecútalo desde la terminal en la máquina donde realmente corre la sesión.
¿Por qué las skills que no usas cuestan contexto?
Las skills que no usas cuestan contexto porque Claude Code incluye un listado de skills en el contexto del modelo en cada turno.
El matiz importante: no carga todo el cuerpo de cada SKILL.md todo el tiempo. Esa es precisamente la razón por la que las skills son más limpias que convertir cada workflow reutilizable en un archivo de instrucciones siempre activo. Pero Claude sí necesita el listado: nombres, descripciones y suficiente metadata para decidir si una skill es relevante.
A medida que tu setup crece, ese listado puede volverse ruidoso.
Quizá instalaste un plugin para una prueba y lo olvidaste. Quizá una skill de proyecto tenía sentido hace tres meses, pero ya no encaja con el repo. Quizá una skill sincronizada desde claude.ai compite con algo local. Quizá un plugin de equipo expone veinte skills, pero solo tres importan en este código base.
Cada una agrega fricción. No solo costo de tokens, también costo de selección: más nombres, más descripciones, más oportunidades para que Claude elija el helper equivocado o no vea el correcto porque el listado se volvió demasiado amplio.
¿Qué deberías hacer después de ejecutar /skill-doctor?
Después de ejecutar /skill-doctor, trata el resultado como una cola de poda, no como una lista automática de eliminación.
Hay cuatro decisiones prácticas:
- Conserva las skills que se usan con frecuencia y están claramente ligadas a workflows reales.
- Pasa a
name-onlylas skills poco usadas cuya descripción completa no merece ocupar contexto. - Desactiva skills que fueron experimentos, helpers obsoletos de proyecto o investigación de una sola vez.
- Administra las skills que vienen de plugins desde
/plugin, porqueskillOverridesno afecta a las plugin skills.
Claude Code ya expone skillOverrides para controlar skills desde settings. La documentación describe estados como on, name-only, user-invocable-only y off. Eso te da más matices que “borrarla o conservarla para siempre”.
Un pase útil de limpieza se ve así:
- Ejecuta
/skill-doctor. - Identifica skills que nunca fueron invocadas.
- Revisa si son skills personales, de proyecto, sincronizadas o de plugin.
- Desactiva las obsoletas.
- Colapsa a
name-onlylas marginales. - Vuelve a correr algunos prompts reales y confirma que las skills importantes todavía se activan.
El objetivo no es el minimalismo por sí mismo. El objetivo es hacer que el mapa de herramientas disponible para Claude sea más pequeño, más claro y más barato.
¿Qué diferencia hay entre /doctor y /skill-doctor?
/doctor revisa la salud y configuración del entorno de Claude Code; /skill-doctor se enfoca en el uso de skills y su costo de contexto.
Esa separación es útil.
Un comando general de doctor puede decirte que algo está mal configurado. Un doctor de skills responde otra pregunta operativa: qué skills cargadas se están ganando su lugar en el presupuesto de contexto.
La documentación de skills también dice que /doctor puede estimar el costo de contexto del listado de skills y sus mayores contribuyentes. /skill-doctor es el siguiente paso: cuando ya sabes que las skills cuestan contexto, te ayuda a encontrar cuáles conviene desactivar.
Para desarrolladores que instalan cada plugin interesante que aparece, este era el paso de mantenimiento que faltaba. El ecosistema invita a experimentar. El contexto exige disciplina. /skill-doctor es el punto donde esas dos realidades se encuentran.
¿Qué cambió en Claude Code 2.1.261 además de /skill-doctor?
Claude Code 2.1.261 también agregó bashOutputMaxChars y taskOutputMaxChars, dos settings para aumentar cuánto output de comandos y tareas en segundo plano recibe Claude inline antes de que se guarde en un archivo.
Según el changelog publicado el 4 de septiembre de 2026, ambos settings pueden subir hasta 128K caracteres.
Esta es la función hermana de /skill-doctor: no trata sobre skills, pero sí sobre control de contexto. Un comando de shell puede producir el mismo problema que un listado inflado de skills. Muy poco output y Claude pierde detalles útiles. Demasiado output y la sesión se llena de logs, stack traces, ruido de tests, build output y líneas repetidas que deberían haberse resumido o guardado en un archivo.
Los nuevos settings le dan a usuarios avanzados un control más fino.
Si estás depurando una suite de tests donde la pista útil aparece después de un stack trace largo, una ventana inline más grande puede ayudar. Si corres herramientas de build ruidosas todo el día, una ventana más grande quizá solo meta más ruido dentro del modelo. El setting correcto depende del workflow.
Por eso esta parte pertenece en la misma nota de mantenimiento que /skill-doctor: ambas funciones tratan sobre decidir qué merece quedarse inline.
¿Cuándo conviene subir bashOutputMaxChars o taskOutputMaxChars?
Conviene subir estos límites cuando el output de comandos o tareas en segundo plano se está guardando en archivos antes de que Claude vea suficiente contexto útil.
Buenos candidatos:
- Fallos largos de tests donde el error accionable aparece tarde.
- Salida de type-checking donde el primer error no es el único relevante.
- Agentes en segundo plano que producen reportes estructurados.
- Logs de build donde el resumen final importa.
- Scripts de migración que imprimen una sección útil de validación al final.
Malos candidatos:
- Procesos watch demasiado verbosos.
- Instalaciones de dependencias con logs repetitivos.
- Suites de tests que imprimen miles de casos exitosos.
- Comandos que incluyen secretos o output sensible de runtime.
- Cualquier cosa que un script debería resumir antes de mostrársela a Claude.
El límite importa porque 128K caracteres no es poco. Puede ser útil para depuración real, pero también puede hacer más pesada una sesión. Ventanas de output más grandes no son automáticamente mejores. Son una forma de gastar contexto con intención.
¿Por qué esto importa para equipos?
Esto importa para equipos porque los setups de Claude Code se están convirtiendo en infraestructura compartida.
Un desarrollador individual puede tolerar algo de desorden. Un equipo no debería permitir que cada experimento se convierta en overhead permanente de contexto. Cuando las skills viven en repositorios de proyecto, marketplaces de plugins, cuentas sincronizadas y settings administrados, alguien necesita un ritmo operativo para mantener limpia la superficie de herramientas del agente.
Ese ritmo es simple:
- Revisa las skills cargadas.
- Elimina u oculta lo obsoleto.
- Mantén fáciles de invocar los workflows de alto valor.
- Ajusta las ventanas de output para los comandos que importan.
- Vuelve a revisar después de cambios grandes en plugins o plantillas de proyecto.
Esto conecta directamente con cobertura anterior de yoDEV sobre skills de Claude Code. Record a Skill hace más fácil crear skills. Las skills de Matt Pocock mostraron lo rápido que un directorio personal de skills puede convertirse en un artefacto útil. Caveman mostró que una skill enfocada puede viajar rápido.
/skill-doctor es la mitad de mantenimiento de esa historia.
Si crear skills ahora es fácil, podar skills tiene que volverse normal.
¿Cuál es el workflow práctico?
El workflow práctico es convertir la limpieza de skills en parte de tu mantenimiento de Claude Code.
Ejecuta /skill-doctor después de una tanda de plugins, después de agregar un set compartido de skills de proyecto o cuando una sesión empiece a sentirse cargada. Busca skills que nunca se invocaron, plugins que no se usaron recientemente y descripciones que ocupan espacio sin ayudar a Claude a elegir bien.
Después haz cambios pequeños:
- Desactiva skills obsoletas.
- Pasa skills marginales a
name-only. - Mantén visibles las skills que usas con frecuencia.
- Administra plugin skills desde
/plugin. - Ajusta el output de comandos solo para workflows que realmente necesitan más logs inline.
No lo trates como una limpieza única. Trátalo como poda de dependencias. El primer pase elimina el desperdicio obvio. El segundo pase, después de una semana de trabajo real, te dice qué importaba de verdad.
La señal más grande es que Claude Code está agregando más herramientas para operar el agente, no solo para darle prompts. Los hooks controlan comportamiento. Los plugins empaquetan workflows. Las skills enseñan procedimientos reutilizables. /skill-doctor muestra cuánto cuesta todo eso.
Eso es sano.
Un agente poderoso no solo debería ganar capacidades. También debería ayudarte a ver qué capacidades se volvieron peso muerto.