Codegraph skill

O que ela faz

A skill liga o codegraph, um índice do código guardado em SQLite na pasta .codegraph do projeto. Em vez de abrir dezenas de arquivos pra se situar, o Claude consulta 8 ferramentas MCP: busca, quem chama, o que é chamado, impacto de uma mudança, detalhes de um trecho, mapa dos arquivos, contexto pra uma tarefa e estado do índice.

Ela vale pra projetos grandes, acima de uns 500 arquivos, e sessões longas. Nos testes do autor, indexar um repositório de 578 arquivos levou 12 segundos e cada consulta, menos de um segundo. Pra edição num arquivo só ou tarefa rápida, a skill diz pra não usar.

A skill é franca sobre o limite: o grafo é uma aproximação e perde chamadas, como métodos em variáveis locais e funções com nome repetido. Por isso traz uma tabela de quando confiar no codegraph e quando conferir com grep, que dá a palavra final antes de renomear ou mudar uma função.

Nas palavras de quem fez

Quando usar

• Cair num projeto grande que outra pessoa escreveu
• Descobrir o que quebra antes de mudar uma função
• Rastrear o caminho de um dado do botão até o banco
• Pedir a explicação de um módulo sem ler pasta por pasta

Depois de instalar, é só pedir assim

• Indexa esse repositório com o codegraph e me explica como funciona o módulo de pagamentos
• Quem chama a função calcularFrete? Confere com grep antes de eu mudar a assinatura
• Me mostra o que pode quebrar se eu mudar o tipo Pedido

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
• SnykAlerta

Perguntas