convez.ai
SkillDevOps & InfraestruturaIntermediário
su-213

Project Doctor

su-213/project-doctor

Diagnóstico automático da saúde e qualidade do seu projeto

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill 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-doctor

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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:

CheckWhat it looks for
📋 DocumentationREADME, LICENSE, CONTRIBUTING, CHANGELOG
🔗 SCM (Git).gitignore, dirty tree, unpushed commits, large files
📦 DependenciesLockfiles, version pinning, bundle size
🔍 Code QualityTODO/FIXME density, file size outliers
⚙️ ConfigurationLinter, formatter, Docker, env example
🔐 SecurityHardcoded 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

Ver o original no GitHub

Bom para

Relacionados