Pular pro conteúdo

Diagnose skill

O Claude para de chutar correção: primeiro monta um jeito de reproduzir o erro, depois testa hipóteses até achar a causa e travar com um teste.

por Matt Pocock

instalações
227,6 mil
estrelas no GitHub
303,3 mil
No skills.sh desde
abril 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 dá ao Claude um roteiro de seis fases pra bug teimoso e lentidão. A primeira, a que mais pesa, é montar um jeito rápido de reproduzir o erro e ver se passou ou falhou: um teste que quebra, um script com curl, um navegador automático com Playwright ou a repetição de uma requisição real gravada.

Com o erro reproduzido, o Claude lista de 3 a 5 hipóteses em ordem, cada uma com uma previsão que dá pra provar errada, e mostra a lista antes de testar. Depois mexe numa coisa por vez, com logs marcados por um prefixo único. Em lentidão, mede a linha de base antes de mexer.

Se o código tem um ponto certo pra testar o bug, ele escreve antes um teste que falha ali, corrige e vê o teste passar; se não tem, avisa. No fim, roda a reprodução de novo, apaga os logs de depuração, registra a causa no commit e pergunta o que teria evitado o bug.

Nas palavras de quem fez

Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user…

Matt Pocock, no SKILL.md

Quando usar

  • Um erro que aparece às vezes e some quando você tenta mostrar
  • O site ou o sistema ficou lento depois de uma atualização
  • O Claude já tentou três correções e o bug continua lá
  • Um formulário, checkout ou integração quebrou e você quer a causa, não um remendo

Depois de instalar, é só pedir assim

  • Diagnostica esse erro: o formulário de cadastro às vezes salva o mesmo cliente duas vezes
  • Minha página de produtos ficou lenta desde a semana passada. Mede, acha o que piorou e corrige
  • Debuga isso: o webhook do pagamento dá erro 500 só em produção. Me diz o que você precisa pra reproduzir

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 Diagnose 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 Diagnose, 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 precisa pra usar a diagnose?

Só o projeto aberto no agente. Ela não pede chave de API nem conta paga. Rende mais quando o projeto tem como rodar testes ou subir o servidor no seu computador, porque o método todo gira em torno de reproduzir o erro.

E se o erro não der pra reproduzir?

A skill manda o Claude parar e dizer isso com todas as letras, listando o que tentou. Aí ele pede acesso ao ambiente onde o erro acontece, um registro (log, arquivo HAR, gravação de tela com horário) ou permissão pra pôr monitoramento temporário em produção. Sem reprodução, ele não segue chutando.

Roda no Codex e no Antigravity?

Sim. A skill é um roteiro em texto, com um modelo de script de terminal, então qualquer agente que leia skills e rode comandos no seu computador consegue seguir.

Levar essa skill

1x diagnoseR$ 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