React Doctor
- 16 installs
- 356 repo stars
- Updated March 25, 2026
- brianlovin/agent-config
This is a copy of react-doctor by posthog - installs and ranking accrue to the original listing.
react-doctor is a Claude skill that scans a React codebase for security, performance, correctness, and architecture issues and outputs a 0-100 score with diagnostics.
About
react-doctor scans a React codebase for security, performance, correctness, and architecture issues and outputs a 0-100 score with actionable diagnostics. It runs via npx react-doctor and reports file paths and line numbers so developers can fix errors by severity and re-run to verify. Its 47+ rules span state and effects, bundle size, Next.js patterns, server auth, accessibility, and dead code.
- Scans a React codebase with `npx react-doctor` and outputs a 0-100 health score
- Covers 47+ rules across security, state/effects, architecture, performance, and correctness
- Includes Next.js, bundle-size, server-action, accessibility, and dead-code checks
React Doctor by the numbers
- 16 all-time installs (skills.sh)
- Data as of Aug 1, 2026 (Skillselion catalog sync)
react-doctor capabilities & compatibility
- Capabilities
- code review · react audit · performance audit · security audit
- Use cases
- code review · security audit
- Pricing
- Free
What react-doctor says it does
Scans your React codebase for security, performance, correctness, and architecture issues. Outputs a 0-100 score with actionable diagnostics.
npx -y react-doctor@latest . --verbose
Fix issues starting with errors (highest severity)
npx skills add https://github.com/brianlovin/agent-config --skill react-doctorAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 16 |
|---|---|
| repo stars | ★ 356 |
| Last updated | March 25, 2026 |
| Repository | brianlovin/agent-config ↗ |
What it does
Scan a React codebase for security, performance, correctness, and architecture issues and get a scored diagnostic list.
Who is it for?
Auditing React and Next.js codebases for health and quality issues
When should I use this skill?
You are reviewing React code, fixing performance problems, auditing security, or improving code quality
What you get
A scored, line-referenced diagnostic list to fix by severity and re-verify.
- 0-100 health score
- Line-referenced diagnostics
By the numbers
- 47+ rules
- 0-100 score with thresholds 75+/50-74/0-49
Files
React Doctor
Scans your React codebase for security, performance, correctness, and architecture issues. Outputs a 0-100 score with actionable diagnostics.
Usage
npx -y react-doctor@latest . --verboseWorkflow
1. Run the command above at the project root 2. Read every diagnostic with file paths and line numbers 3. Fix issues starting with errors (highest severity) 4. Re-run to verify the score improved
Rules (47+)
- Security: hardcoded secrets in client bundle, eval()
- State & Effects: derived state in useEffect, missing cleanup, useState from props, cascading setState
- Architecture: components inside components, giant components, inline render functions
- Performance: layout property animations, transition-all, large blur values
- Correctness: array index as key, conditional rendering bugs
- Next.js: missing metadata, client-side fetching for server data, async client components
- Bundle Size: barrel imports, full lodash, moment.js, missing code splitting
- Server: missing auth in server actions, blocking without after()
- Accessibility: missing prefers-reduced-motion
- Dead Code: unused files, exports, types
Score
- 75+: Great
- 50-74: Needs work
- 0-49: Critical
Related skills
Improve Codebase ArchitectureSafely deepen clusters of shallow modules into cohesive, testable units while respecting their external dependencies.566k196k
Caveman ReviewGet ultra-compressed, one-line code review comments that cut noise while keeping every actionable fix.270k94.7kCodebase DesignShared vocabulary for designing deep modules: improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable.266k196kCavecrewDelegate coding tasks to specialized subagents that return compressed output, keeping the main context window usable for much longer sessions.220k94.7kCode ReviewReviews a branch or PR diff on two axes at once: conformance to coding standards plus a code-smell baseline, and whether it actually implements the original spec.201k196k
Requesting Code ReviewDispatch a consistent, high-signal code reviewer subagent that catches plan deviations and quality issues before merging or continuing development.183k264kFAQ
How do I run it?
Run `npx -y react-doctor@latest . --verbose` at the project root.
How many rules does it have?
47+ rules across security, state and effects, architecture, performance, correctness, Next.js, bundle size, server, accessibility, and dead code.
What does the score mean?
75+ is Great, 50-74 needs work, and 0-49 is Critical.