Pular pro conteúdo

Diagnosing Bugs skill

O Claude para de chutar a causa: primeiro faz o erro aparecer num comando, depois testa hipóteses, corrige e deixa um teste pra ele não voltar.

por Matt Pocock

instalações
841,6 mil
estrelas no GitHub
303,3 mil
No skills.sh desde
junho de 2026
Licença
MIT

Atualizada no GitHub em 22 de outubro de 2026. Dados conferidos em 26 de outubro de 2026, no skills.sh e no GitHub.

O que ela faz

A skill é um roteiro de seis fases pra bug difícil e queda de desempenho. A primeira é a que manda: montar um jeito rápido de ver o erro acontecer, como um teste que falha, um curl no servidor, um script no navegador com Playwright ou um git bisect. Sem esse comando falhando, o Claude não pode começar a teorizar.

Com o erro reproduzido, ele enxuga o caso até o mínimo que ainda falha. Depois lista de 3 a 5 hipóteses em ordem, cada uma dizendo o que deveria acontecer se for verdade, e mostra pra você antes de testar. Os logs de investigação levam uma marca única, tipo [DEBUG-a4f2], pra saírem todos no fim.

Na correção, o teste de regressão vem antes do conserto, quando há um ponto certo pra ele. Na limpeza, o Claude confere que o erro original sumiu, tira os logs, apaga os protótipos e escreve no commit qual hipótese estava certa. Senha e token que aparecem nas saídas viram <REDACTED>.

Nas palavras de quem fez

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.

Matt Pocock, no SKILL.md

Quando usar

  • Um erro que some e volta e ninguém consegue repetir
  • O site ou o sistema ficou lento depois de uma atualização
  • Uma coisa que funcionava parou entre uma versão e outra
  • O Claude já tentou consertar duas vezes e o erro continua
  • Um bug que só aparece com dado real de produção

Depois de instalar, é só pedir assim

  • Diagnostica esse bug: o checkout dá erro 500 de vez em quando e não sei por quê
  • A página de produtos ficou lenta desde a semana passada, descobre o que mudou
  • O e-mail de confirmação não chega pra alguns clientes; usa a diagnosing-bugs pra achar a causa

Segurança

Gen Agent Trust Hub, Socket e Snyk leem o código da skill atrás de comando perigoso, dado vazando e instrução escondida. Alerta não é reprovação: quer dizer que vale ler o que a skill faz antes de instalar.

  • Gen Agent Trust HubPassou
  • SocketPassou
  • SnykPassou

Perguntas

Como instalar a Diagnosing Bugs no Claude Code?

Toca em Levar, aqui nesta página, e deixa seu nome, e-mail e WhatsApp (é uma vez só). Aparece uma frase pronta: cola ela no Claude Code, que ele mesmo instala a Diagnosing Bugs, e a skill passa a valer na próxima conversa. A mesma frase serve no Codex. Se preferir fazer na mão, o passo a passo está em como instalar skills no Claude Code.

O que a diagnosing-bugs precisa pra funcionar?

Não pede chave de API nem conta paga. Ela usa o que o projeto já tem: os testes, o servidor rodando, o git e, se o bug for na tela, Playwright ou Puppeteer. Se não der pra reproduzir o erro, o Claude para e pede acesso ao ambiente, um log ou uma gravação.

Roda no Codex e no Antigravity?

Roda. É um SKILL.md de texto, e o que ele pede (testes, curl, git bisect) funciona em qualquer agente que use o terminal. Pra quando uma pessoa precisa clicar, o script de apoio vem junto na pasta da skill.

Vale pra erro simples?

Ela é feita pros bugs que resistem à primeira olhada. Pra erro de digitação ou mensagem de erro clara, o roteiro inteiro é exagero; a própria skill diz que fase só se pula com justificativa, então guarde pros casos cabeludos.

Levar essa skill

1x diagnosing-bugsR$ 0,00

TotalR$ 0,00

A skill sai aqui mesmo, na hora. Seus dados eu uso pra falar com você sobre o MazyOS.

Levar precisa do JavaScript ligado. O código da skill está no GitHub: github.com/mattpocock/skills

Aprenda a usar

Mais da loja Matt Pocock

Ver a loja Matt Pocock