react-doctor

Scans React codebases for security, performance, and correctness issues with scored diagnostics.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/chhpt/skills --skill react-doctor-chhpt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: react-doctor
Source: https://github.com/chhpt/skills/tree/main/skills/react-doctor
Command: npx skills add https://github.com/chhpt/skills --skill react-doctor-chhpt

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires react-doctor.

What problem does it solve? React codebases accumulate subtle security, performance, correctness, and architecture issues that are easy to miss during manual review. This Skill runs an automated scan after code changes and returns a 0-100 score with actionable diagnostics so problems are caught early. ## Core Features & Use Cases - Automated React Auditing: Scans the codebase for security, performance, correctness, and architecture issues in one pass. - Scored Diagnostics: Outputs a 0-100 score with actionable findings, making it easy to track improvement over time. - Diff-Aware Review: The --diff flag focuses analysis on recent changes, ideal for reviewing a feature or bug fix. - Use Case: After finishing a React feature, run the scan, fix the reported errors first, then re-run to verify the score improved before merging. ## Quick Start Ask the assistant 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 code issues?

Run npx -y react-doctor@latest . --verbose --diff from the project root. The scan checks security, performance, correctness, and architecture, then outputs a 0-100 score with actionable diagnostics.

What does the react-doctor score mean?

The score is a 0-100 rating of the codebase based on detected security, performance, correctness, and architecture issues. Fix reported errors first, then re-run the scan to confirm the score improved.

When should I run react-doctor during development?

Run it after making React changes, when reviewing code, finishing a feature, or fixing bugs. Running it after each change catches issues early before they accumulate.

Does react-doctor require installation?

No installation is required. The npx -y react-doctor@latest command downloads and runs the latest version on demand, so you always use the current release without adding a project dependency.

What does the --diff flag do in react-doctor?

The --diff flag focuses the scan on recent changes rather than the entire codebase. This is useful when reviewing a specific feature or bug fix to see only the issues introduced by your changes.