react-doctor

Scans React codebases for security, performance, and architecture issues with a scored diagnostic report.

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/alex-jordan547/agent-setup --skill react-doctor-alex-jordan547
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: react-doctor
Source: https://github.com/alex-jordan547/agent-setup/tree/main/archive/2026-09-10/react-doctor
Command: npx skills add https://github.com/alex-jordan547/agent-setup --skill react-doctor-alex-jordan547

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires react-doctor.

What problem does it solve? React codebases accumulate subtle security, performance, correctness, and architecture problems that are easy to miss during manual review. This Skill runs an automated scan after code changes so issues are caught early, before they reach production. ## Core Features & Use Cases - Automated React Scanning: Runs the react-doctor CLI via npx to analyze the entire project for security, performance, correctness, and architecture issues. - Scored Diagnostics: Outputs a 0-100 score with actionable diagnostics, making it easy to track code health over time. - Diff-Aware Review: The --diff flag focuses analysis on recent changes, ideal for verifying a feature or bug fix. - Use Case: After finishing a React feature, run the scan, fix reported errors first, then re-run to confirm the score improved before merging. ## Quick Start Ask the agent to run react-doctor on this React project with verbose diff output and report the score and top issues.

Frequently Asked Questions about react-doctor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scan a React project for security and performance issues?

Run npx -y react-doctor@latest . --verbose --diff from the project root. It scans the codebase for security, performance, correctness, and architecture issues and outputs a 0-100 score with actionable diagnostics.

When should I run react-doctor in my workflow?

Run it after making React changes, when reviewing code, finishing a feature, or fixing bugs. Fix reported errors first, then re-run the scan to verify the score improved before merging.

Does react-doctor require installation as a project dependency?

No, it runs through npx with the -y flag, which fetches and executes the latest react-doctor package on demand. No local installation or package.json changes are required.

What does the react-doctor score mean?

The scan outputs a 0-100 score reflecting the health of the React codebase across security, performance, correctness, and architecture categories. A higher score after re-running confirms that fixes resolved the reported issues.

Can react-doctor scan only my recent changes?

Yes, the --diff flag focuses the analysis on recent changes rather than the entire codebase. This is useful for verifying a specific feature or bug fix without re-reviewing unchanged code.