GuidenceStudio/code-repository-audit-skill

Habilidade generalista do Claude para auditorias de código — framework de 13 dimensões, roteamento por intenção, ferramentas OSS integradas. Enxuta e testada internamente.

O que é code-repository-audit-skill?

Esta habilidade permite que o Claude Code realize auditorias completas de bases de código usando um framework de 13 dimensões que abrange aspectos como arquitetura, segurança, desempenho e legibilidade. O roteamento por intenção significa que você pode direcionar a auditoria para focar em áreas específicas (ex: segurança, conformidade) de forma dinâmica. Ela já vem com ferramentas de código aberto (OSS) conectadas, como linters, analisadores estáticos e scanners de dependências. É uma solução enxuta e testada internamente (dogfooded), ideal para desenvolvedores que querem uma auditoria profunda e extensível sem complexidade desnecessária. Suporta múltiplas plataformas e linguagens, bastando que o agente tenha acesso ao repositório e execute os comandos definidos no SKILL.md.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add GuidanceStudio/code-repository-audit-skill

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que code-repository-audit-skill faz?

Habilidade generalista do Claude para auditorias de bases de código — framework de 13 dimensões, roteamento por intenção, ferramentas OSS integradas. Enxuta e testada internamente.

Visão Geral

Esta habilidade permite que você execute auditorias sistemáticas em repositórios de código usando um framework multidimensional. Cada dimensão avalia um aspecto específico do código, e o roteamento por intenção permite que você direcione a auditoria para áreas de interesse.

Dimensões do Framework

  1. Arquitetura – Estrutura geral, modularidade, separação de responsabilidades.
  2. Segurança – Vulnerabilidades, práticas inseguras, exposição de dados.
  3. Desempenho – Eficiência, gargalos, uso de recursos.
  4. Legibilidade – Clareza do código, nomenclatura, comentários.
  5. Manutenibilidade – Facilidade de mudança, complexidade ciclomática.
  6. Testabilidade – Cobertura de testes, dependências, mocking.
  7. Conformidade – Padrões de código, licenças, regulamentações.
  8. Documentação – Adequação, atualização, clareza.
  9. Dependências – Versões, riscos, desatualizações.
  10. Portabilidade – Independência de plataforma, configurações.
  11. Tratamento de Erros – Consistência, logging, fallbacks.
  12. Escalabilidade – Capacidade de crescimento, concorrência.
  13. Reutilização – Componentes compartilhados, abstrações.

Roteamento por Intenção

Você pode especificar uma intenção ao iniciar a auditoria:

# Exemplo: Auditoria focada em segurança
claude audit --intent security

Intenções disponíveis: security, performance, readability, architecture, compliance, full.

Ferramentas OSS Integradas

A habilidade automaticamente utiliza ferramentas de código aberto quando disponíveis:

LinguagemFerramentas
Pythonpylint, bandit, safety
JavaScripteslint, npm audit, sonarwhal
Javacheckstyle, findbugs
Gogolangci-lint, staticcheck

Uso

  1. Certifique-se de que o repositório está acessível no ambiente do Claude Code.

  2. Execute a auditoria completa:

    claude audit --full
    
  3. Ou especifique uma intenção:

    claude audit --intent performance
    
  4. O agente percorrerá o código, aplicará as ferramentas relevantes e gerará um relatório dimensional.

Exemplo de Saída

## Relatório de Auditoria - Repositório: my-app
### Dimensão: Segurança (Score: 7/10)
- Encontradas 3 dependências vulneráveis (CVE-2024-...)
- 2 ocorrências de injeção SQL não verificada
- Ausência de validação de entrada em 5 endpoints
...

Personalização

Você pode estender a habilidade adicionando novas dimensões ou ferramentas no arquivo de configuração (.auditconfig.yaml):

dimensions:
  - name: performance
    tools:
      - "your-custom-linter"

Habilidades Relacionadas