code-analysis
Melhorar a legibilidade do código
As equipes frequentemente escrevem código que apenas desenvolvedores conseguem acompanhar. Esta skill verifica nomes, comentários, jargões e documentação para que equipes mais amplas possam entender o código mais rapidamente.
Baixar o ZIP da habilidade
Upload no Claude
Vá em Configurações → Capacidades → Skills → Upload skill
Ative e comece a usar
Recursos legíveis por agentes
Use estes links quando um agente de IA, crawler ou script precisar de contexto limpo em vez de ler a página completa.
Testar
Usando "code-analysis". Um arquivo Python com nomes de variáveis curtos e poucos comentários.
Resultado esperado:
O relatório apresenta uma pontuação moderada, sinaliza nomes pouco claros e sugere nomes mais completos com comentários explicativos.
Usando "code-analysis". Um arquivo TypeScript com jargão de API nos comentários.
Resultado esperado:
O relatório identifica termos técnicos não explicados e sugere definições em linguagem simples.
Usando "code-analysis". Um arquivo de serviço bem documentado.
Resultado esperado:
O relatório apresenta uma pontuação alta e observa que o arquivo é acessível a não desenvolvedores.
Auditoria de segurança
Baixo RiscoThe static weak cryptography findings are false positives caused by readability terms such as token, serialize, and hash-related wording, not cryptographic operations. The Markdown backtick findings are also false positives from fenced examples and documented CLI usage. The skill is safe to publish with a low warning because it runs a local script that reads user-selected files and may print code snippets.
Confirmed security concerns (1)
Static false positives ignored (3)
These static matches were dismissed by semantic review or matched schema-only tokens, so they are shown for transparency but do not drive the quality score.
Fatores de risco
⚡ Contém scripts (2)
📁 Acesso ao sistema de arquivos (1)
⚙️ Comandos externos (1)
Padrões detectados
Pontuação de qualidade
O que você pode criar
Revisar código voltado para stakeholders
Verifique se a lógica de negócios tem nomes claros e comentários simples antes de uma revisão de produto.
Preparar exemplos de onboarding
Encontre explicações ausentes antes de compartilhar código com novos membros da equipe.
Melhorar a qualidade da documentação
Identifique jargões e contexto ausente de O quê, Por quê e Como nos comentários do código-fonte.
Teste estes prompts
Use the code-analysis skill to review this file for non-developer readability: [file path].
Analyze [file path] with focus on naming. Explain which names should be clearer and why.
Review [file path] for a new team member. Prioritize comments, jargon, and missing context.
Analyze [file path] with strict readability expectations. Summarize blockers before this code is shared with stakeholders.
Boas práticas
- Execute-a nos arquivos de projeto pretendidos, não em arquivos que contenham segredos.
- Use o modo estrito antes de compartilhar código com públicos não desenvolvedores.
- Revise cada sugestão manualmente antes de alterar termos de domínio já estabelecidos.
Evitar
- Não trate a pontuação como prova de que o código está correto.
- Não escaneie credenciais privadas, chaves ou arquivos de configuração sensíveis.
- Não substitua a revisão humana da documentação apenas por achados automatizados.