run-react-doctor

Installation
SKILL.md

run-react-doctor

react-doctor (https://react.doctor) is pinned to 0.2.16 in package.json and configured via doctor.config.json at the repo root. It runs against src/** only — studio code, scripts, and test files are excluded by config (see ignore.files).

Scripts (use these, not the raw CLI)

Script What it writes When to use
npm run doctor TTY report to stdout Local check while iterating
npm run doctor:verbose TTY + extra context When a finding is unclear
npm run doctor:json .react-doctor/report.json When you need to parse or diff
npm run doctor:baseline .react-doctor/baseline.json + docs/react-doctor/baseline.{json,txt} Recapture the baseline (only at release branches)
npm run doctor:check Same as npm run doctor but set -e Used by CI
npm run doctor:diff diff against HEAD Comparing branches

The CI gate is .github/workflows/react-doctor.yml (threshold = 0 findings = 100/100).

The 12-rule catalog (and what to fix vs ignore)

Installs
1
GitHub Stars
2
First Seen
Jul 20, 2026
run-react-doctor — pp-namias/portfolio