react-doctor

Scans React codebases for security, performance, and architecture issues with a health score.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires react-doctor.

What problem does it solve? React codebases accumulate lint violations, dead code, accessibility gaps, bundle bloat, and architecture problems that are hard to track manually. This Skill runs an automated diagnostic scan and reports a 0-100 health score so you can catch regressions before committing. ## Core Features & Use Cases - Regression Checking: Run with the --diff flag after making changes to verify your health score did not drop before committing code. - Full Codebase Audits: Scan the entire project for security, performance, correctness, and architecture issues, sorted by severity. - Verbose Diagnostics: Use --verbose to see affected files and line numbers for every rule violation. - Use Case: After finishing a feature branch, run the diff scan to confirm your changes did not introduce new lint errors, dead code, or accessibility issues before opening a pull request. ## Quick Start Ask the AI to run react-doctor on this project with the diff flag and report whether the health score regressed.

Frequently Asked Questions about react-doctor

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

FAQPage Schema
How do I check React code quality before committing?

Run npx -y react-doctor@latest . --verbose --diff to scan only files changed versus the base branch. The command reports a health score so you can confirm no regressions were introduced before committing.

What issues does react-doctor detect in React projects?

react-doctor scans for security, performance, correctness, and architecture issues, including lint violations, dead code, accessibility problems, and bundle size concerns. Results are aggregated into a 0-100 health score.

How do I scan only changed files instead of the whole codebase?

Add the --diff flag to the react-doctor command to limit the scan to files changed versus the base branch. Omit the flag to audit the full codebase for general cleanup.

Does react-doctor require installation as a project dependency?

No installation is required. The npx -y react-doctor@latest command downloads and runs the latest version on demand, so it works in any React project without modifying package.json.

Why did my react-doctor health score drop after a change?

A score drop means your changes introduced new issues such as lint errors, dead code, or accessibility violations. Run with --verbose to see the affected files and line numbers, then fix errors first, followed by warnings.