Project Doctor
su-213/project-doctor
Diagnóstico automático da saúde e qualidade do seu projeto
Ver no GitHubSkill para Claude Code que escaneia seu projeto e gera um relatório estruturado de saúde. Avalia documentação, controle de versão, dependências, qualidade de código, configurações e segurança em um único comando.
Instalação
npx convez-ai su-213/project-doctor1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Avaliar qualidade geral de um projeto antes de onboarding
- Identificar gaps em documentação, configuração e segurança
- Auditar conformidade técnica em repositórios de equipe
- Gerar relatório estruturado de saúde do codebase
Veredito

Ferramenta prática que automatiza auditoria de projeto com checks multi-camadas (docs, git, deps, code quality, config, segurança). Útil para manter saúde de codebases e onboarding de equipes, funciona bem como skill integrado ao Claude Code.
README
A tradução para o português deste README ainda está na fila.
Project Doctor 🏥
A Claude Code skill that scans your project and generates a structured health report.
What it does
When you ask Claude to check a project's health, project-doctor automatically inspects:
| Check | What it looks for |
|---|---|
| 📋 Documentation | README, LICENSE, CONTRIBUTING, CHANGELOG |
| 🔗 SCM (Git) | .gitignore, dirty tree, unpushed commits, large files |
| 📦 Dependencies | Lockfiles, version pinning, bundle size |
| 🔍 Code Quality | TODO/FIXME density, file size outliers |
| ⚙️ Configuration | Linter, formatter, Docker, env example |
| 🔐 Security | Hardcoded secrets (lightweight scan) |
Outputs a clean pass/warn/fail report and offers to fix what's wrong.
Installation
One-liner
# macOS / Linux
curl -sL https://raw.githubusercontent.com/su-213/project-doctor/main/install.sh | bash
# Windows (PowerShell)
irm https://raw.githubusercontent.com/su-213/project-doctor/main/install.ps1 | iex
Manual
mkdir -p ~/.claude/skills/project-doctor
cp SKILL.md ~/.claude/skills/project-doctor/
Project-level (recommended for teams)
mkdir -p .claude/skills/project-doctor
cp SKILL.md .claude/skills/project-doctor/
git add .claude/skills/project-doctor/SKILL.md
Usage
In any project directory with Claude Code:
> check this project's health
> audit this codebase
> what's missing in this project?
Example output:
# ── Project Doctor Report ──
## 📋 Documentation ✅ README ⚠ CHANGELOG ⚠ CONTRIBUTING
## 🔗 SCM ✅ .gitignore ✅ clean tree
## 📦 Dependencies ✅ lockfile ⚠ 3 unpinned
## 🔍 Code Quality ⚠ 12 TODOs ✓ no oversized files
## ⚙️ Configuration ✅ editorconfig ⚠ no linter
## 🔐 Security ✅ no secrets detected
🏥 Overall: GOOD (7 passed, 3 warnings, 0 critical)
License
MIT