| name | repo-health |
| description | Analisa o perfil do repositório e extrai um modelo estruturado com evidências para orientar outras análises. |
Skill: Repo Health
Quando usar
Execute esta skill quando estiver começando a análise de um repositório e precisar:
- Determinar tipo de projeto (app, lib, monorepo)
- Identificar stack tecnológica
- Construir um modelo de contexto reutilizável por outras skills
Escopo da skill
Inclui:
- Modelagem da estrutura de arquivos
- Identificação de linguagens/frameworks
- Detectar presença de configurações importantes (
package.json, configs)
Não inclui:
- Análises de qualidade profundas (essas são outras skills)
Entradas esperadas
- Árvore completa de arquivos do repositório
- Conteúdo de:
package.json
- Possíveis configs (
.eslintrc, tsconfig.json, vite.config.js)
Como analisar
- Percorrer todos os diretórios principais.
- Identificar:
- Linguagens dominantes
- Scripts importantes (
lint, test, build)
- Estruturas comuns (
src/, apps/, packages/)
- Classificar o repo (monorepo vs simples)
- Construir mapa de “pontos de interesse” para outras skills
Saída esperada
Resultado deve incluir:
- Tipo de projeto
- Lista de linguagens + frameworks
- Scripts principais
- Mapa de pastas relevantes
Regras obrigatórias
- Deve usar conteúdo real (arquivo + corpo)
- Não deve fazer suposições sem evidência
- Deve retornar JSON/natureza de dados legível por outros agentes
Limitações
- Não detecta qualidade de código
- Não faz recomendações por si só