Claude Code 2.1.261 agregou /skill-doctor, um comando de manutenção para encontrar skills que permanecem carregadas em contexto embora quase nunca sejam usadas.
Isso parece pequeno até que seu setup acumula meses de skills, plugins, experimentos e helpers de projeto. As skills são melhores que despejar cada procedimento em CLAUDE.md, porque o corpo completo só é carregado quando necessário. Mas a listagem de skills continua custando contexto em cada turno: Claude precisa de nomes e descrições para saber quais ferramentas tem disponíveis.
/skill-doctor torna esse custo visível.
Como saber quais skills o Claude Code usa?
Para saber quais skills o Claude Code usa, execute /skill-doctor na sessão de terminal onde o Claude Code está rodando.
A documentação da Anthropic diz que o comando mostra quanto custa cada skill e com que frequência é usada, para que você possa decidir quais desativar. Em uma sessão interativa, o relatório se abre na aba Stats do gerenciador /plugin. Em modo não interativo com -p, Claude Code imprime o relatório como texto.
Essa diferença importa para usuários avançados. Se você administra uma única estação local, o relatório visual é suficiente. Se você mantém um setup compartilhado, um repositório modelo, um devcontainer ou um pacote de plugins de equipe, a saída de texto se parece mais com um artefato auditável.
O relatório não cobre tudo. No momento da publicação desta nota, 7 de setembro de 2026, a documentação diz que cobre as skills da sua sessão exceto as bundled skills e as enterprise skills. Também requer Claude Code v2.1.252 ou posterior, depende do carregamento de feature flags e não está disponível a partir de sessões de Remote Control em telefone ou navegador. Execute-o a partir do terminal na máquina onde a sessão realmente roda.
Por que as skills que você não usa custam contexto?
As skills que você não usa custam contexto porque Claude Code inclui uma listagem de skills no contexto do modelo em cada turno.
O detalhe importante: não carrega o corpo completo de cada SKILL.md todo o tempo. Essa é precisamente a razão pela qual as skills são mais limpas do que converter cada workflow reutilizável em um arquivo de instruções sempre ativo. Mas Claude realmente precisa da listagem: nomes, descrições e metadados suficientes para decidir se uma skill é relevante.
À medida que seu setup cresce, essa listagem pode se tornar ruidosa.
Talvez você tenha instalado um plugin para um teste e o esqueceu. Talvez uma skill de projeto fizesse sentido três meses atrás, mas não cabe mais no repositório. Talvez uma skill sincronizada de claude.ai compita com algo local. Talvez um plugin de equipe exponha vinte skills, mas apenas três importam nesta base de código.
Cada uma adiciona atrito. Não apenas custo de tokens, mas também custo de seleção: mais nomes, mais descrições, mais oportunidades para Claude escolher o helper errado ou não ver o correto porque a listagem ficou muito ampla.
O que você deveria fazer depois de executar /skill-doctor?
Depois de executar /skill-doctor, trate o resultado como uma fila de poda, não como uma lista automática de exclusão.
Há quatro decisões práticas:
- Mantenha as skills que são usadas com frequência e claramente ligadas a workflows reais.
- Coloque em
name-onlyas skills pouco usadas cuja descrição completa não merece ocupar contexto. - Desative skills que foram experimentos, helpers de projeto obsoletos ou pesquisa única.
- Administre as skills que vêm de plugins a partir de
/plugin, porqueskillOverridesnão afeta as plugin skills.
Claude Code já expõe skillOverrides para controlar skills a partir de settings. A documentação descreve estados como on, name-only, user-invocable-only e off. Isso lhe oferece mais nuances do que “deletá-la ou mantê-la para sempre”.
Uma passagem útil de limpeza se parece com isto:
- Execute
/skill-doctor. - Identifique skills que nunca foram invocadas.
- Verifique se são skills pessoais, de projeto, sincronizadas ou de plugin.
- Desative as obsoletas.
- Colapsa para
name-onlyas marginais. - Execute novamente alguns prompts reais e confirme que as skills importantes ainda se ativam.
O objetivo não é minimalismo por si só. O objetivo é tornar o mapa de ferramentas disponíveis para Claude menor, mais claro e mais barato.
Qual é a diferença entre /doctor e /skill-doctor?
/doctor verifica a saúde e configuração do ambiente Claude Code; /skill-doctor se concentra no uso de skills e seu custo de contexto.
Essa separação é útil.
Um comando geral de doctor pode lhe dizer que algo está configurado incorretamente. Um doctor de skills responde outra pergunta operacional: quais skills carregadas estão ganhando seu lugar no orçamento de contexto.
A documentação de skills também diz que /doctor pode estimar o custo de contexto da listagem de skills e seus maiores contribuidores. /skill-doctor é o próximo passo: quando você já sabe que as skills custam contexto, ajuda você a encontrar quais vale a pena desativar.
Para desenvolvedores que instalam cada plugin interessante que aparece, este era o passo de manutenção que faltava. O ecossistema convida a experimentar. O contexto exige disciplina. /skill-doctor é o ponto onde essas duas realidades se encontram.
O que mudou no Claude Code 2.1.261 além de /skill-doctor?
Claude Code 2.1.261 também adicionou bashOutputMaxChars e taskOutputMaxChars, duas configurações para aumentar quanto output de comandos e tarefas em segundo plano Claude recebe inline antes que seja salvo em um arquivo.
Segundo o changelog publicado em 4 de setembro de 2026, ambas as configurações podem chegar a 128K caracteres.
Esta é a função irmã de /skill-doctor: não trata sobre skills, mas sim sobre controle de contexto. Um comando de shell pode produzir o mesmo problema que uma listagem inflada de skills. Muito pouco output e Claude perde detalhes úteis. Demais output e a sessão se enche de logs, stack traces, ruído de testes, build output e linhas repetidas que deveriam ter sido resumidas ou salvas em um arquivo.
As novas configurações dão aos usuários avançados um controle mais fino.
Se você está depurando uma suite de testes onde a pista útil aparece após um stack trace longo, uma janela inline maior pode ajudar. Se você executa ferramentas de build ruidosas o dia todo, uma janela maior talvez apenas adicione mais ruído dentro do modelo. A configuração correta depende do seu workflow.
Por isso esta parte pertence à mesma nota de manutenção que /skill-doctor: ambas as funções tratam sobre decidir o que merece ficar inline.
Quando vale a pena aumentar bashOutputMaxChars ou taskOutputMaxChars?
Vale a pena aumentar esses limites quando o output de comandos ou tarefas em segundo plano está sendo salvo em arquivos antes que Claude veja contexto útil suficiente.
Bons candidatos:
- Falhas longas de testes onde o erro acionável aparece tarde.
- Saída de type-checking onde o primeiro erro não é o único relevante.
- Agentes em segundo plano que produzem relatórios estruturados.
- Logs de build onde o resumo final importa.
- Scripts de migração que imprimem uma seção útil de validação no final.
Maus candidatos:
- Processos watch muito verbosos.
- Instalações de dependências com logs repetitivos.
- Suites de testes que imprimem milhares de casos bem-sucedidos.
- Comandos que incluem segredos ou output sensível de runtime.
- Qualquer coisa que um script deveria resumir antes de mostrá-la a Claude.
O limite importa porque 128K caracteres não é pouco. Pode ser útil para depuração real, mas também pode tornar uma sessão mais pesada. Janelas de output maiores não são automaticamente melhores. São uma forma de gastar contexto com intenção.
Por que isso importa para equipes?
Isso importa para equipes porque os setups de Claude Code estão se tornando infraestrutura compartilhada.Um desenvolvedor individual pode tolerar um certo nível de desordem. Um time não deveria permitir que cada experimento se torne overhead permanente de contexto. Quando as skills vivem em repositórios de projeto, marketplaces de plugins, contas sincronizadas e configurações gerenciadas, alguém precisa de um ritmo operacional para manter limpa a superfície de ferramentas do agente.
Esse ritmo é simples:
- Revise as skills carregadas.
- Elimine ou oculte o obsoleto.
- Mantenha fáceis de invocar os workflows de alto valor.
- Ajuste as janelas de output para os comandos que importam.
- Revise novamente após grandes mudanças em plugins ou templates de projeto.
Isto se conecta diretamente com a cobertura anterior do yoDEV sobre skills do Claude Code. Record a Skill torna mais fácil criar skills. As skills de Matt Pocock mostraram o quão rápido um diretório pessoal de skills pode se tornar um artefato útil. Caveman mostrou que uma skill focada pode se disseminar rapidamente.
/skill-doctor é a metade de manutenção dessa história.
Se criar skills agora é fácil, podar skills tem que se tornar normal.
Qual é o workflow prático?
O workflow prático é transformar a limpeza de skills em parte da sua manutenção do Claude Code.
Execute /skill-doctor após um lote de plugins, depois de adicionar um conjunto compartilhado de skills de projeto ou quando uma sessão começar a se sentir sobrecarregada. Procure por skills que nunca foram invocadas, plugins que não foram usados recentemente e descrições que ocupam espaço sem ajudar o Claude a escolher bem.
Depois faça pequenas mudanças:
- Desative skills obsoletas.
- Mova skills marginais para
name-only. - Mantenha visíveis as skills que você usa com frequência.
- Administre skills de plugin pelo
/plugin. - Ajuste o output de comandos apenas para workflows que realmente precisam de mais logs inline.
Não trate isso como uma limpeza única. Trate como poda de dependências. O primeiro passo elimina o desperdício óbvio. O segundo passo, depois de uma semana de trabalho real, mostra a você o que realmente importava.
O sinal mais importante é que o Claude Code está adicionando mais ferramentas para operar o agente, não apenas para dar prompts. Os hooks controlam o comportamento. Os plugins empacotam workflows. As skills ensinam procedimentos reutilizáveis. /skill-doctor mostra quanto tudo isso custa.
Isso é saudável.
Um agente poderoso não deveria apenas ganhar capacidades. Também deveria ajudá-lo a ver quais capacidades se tornaram peso morto.