four-doctors

The whole suite, one command. Runs rails-doctor, design-doctor, qa-doctor, and (optionally) react-doctor, and aggregates the scores.

Why the name? npm rejected doctors as too similar to doctoc. four-doctors it is.

Quick start

npx -y four-doctors@latest scan .

Auto-runs the doctors that apply to your project:

| Doctor | Runs when | |-----------------|-----------------------------------------------------| | rails-doctor | Gemfile + config/routes.rb exist | | design-doctor | package.json has react / inertia / tanstack-router | | qa-doctor | only with --browser (needs a running dev server) | | react-doctor | only with --react-doctor |

Examples

# Static-only (default) — Rails + React audit
npx -y four-doctors scan .

# Add browser QA against a running app
npx -y four-doctors scan . --browser --url http://localhost:3000

# Add the LLM vision pass
npx -y four-doctors scan . --vision --url http://localhost:3000

# Full sweep — every doctor, every flag
npx -y four-doctors scan . --browser --vision --fill --url http://localhost:3000 --react-doctor

# CI gate — fail under suite-average 80
npx -y four-doctors scan . --min-score 80

Output

doctors — suite report

  ok   rails-doctor    98/100 Great  (895ms)
  ok   design-doctor   83/100 Great  (1467ms)

  Suite average: 91/100  across 2 doctors

--markdown for PR-friendly output:

## doctors report

**Suite average: 91/100** across 2 doctors.

| Doctor | Status | Score | Notes |
|---|---|---|---|
| `rails-doctor` | ok | 98/100 | Great |
| `design-doctor` | ok | 83/100 | Great |

Install all the skills

npx -y four-doctors install              # installs the meta skill
npx -y rails-doctor install
npx -y design-doctor install
npx -y qa-doctor install

After that, your agent can call any doctor by name — and doctors itself when you want everything in one shot.

Source

• four-doctors
• rails-doctor
• design-doctor
• qa-doctor
• react-doctor (third-party)

License

MIT.