react-doctor

Analyze React codebases for security, performance, correctness, and architecture issues.

1|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/matthewharwood/dean-stack --skill react-doctor-matthewharwood
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: react-doctor
Source: https://github.com/matthewharwood/dean-stack/tree/main/.claude/skills/react-doctor
Command: npx skills add https://github.com/matthewharwood/dean-stack --skill react-doctor-matthewharwood

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Scans React codebases to detect security, performance, correctness, and architecture issues and provides a clear health assessment to guide fixes.

Core Features & Use Cases

  • Security, performance, correctness, and architecture diagnostics across React projects.
  • Health score: outputs a deterministic 0–100 score to quantify code health.
  • Workflow integration: supports CI and pre-commit gates to prevent regressions.
  • Quality signals: identifies dead code, accessibility issues, and oversized bundles to guide targeted improvements.

Quick Start

Run npx -y react-doctor@latest . --verbose to scan your project and surface actionable improvements.

Frequently Asked Questions about react-doctor

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

FAQPage Schema
How do I check my React codebase for performance and security issues?

To check React codebase for performance and security issues, run a diagnostic scan that analyzes correctness and architecture concerns. This process identifies accessibility problems, dead code, and oversized bundles while producing a deterministic 0–100 health score to guide fixes.

Can I run React code quality checks as a pre-commit gate?

Yes, you can run React code quality checks as a pre-commit gate. The diagnostic tool supports CI and pre-commit workflow integration to prevent regressions during feature development or bug fixes by surfacing lint and bundle-size issues before changes are committed.

What is a React health score and how does it quantify code quality?

A React health score quantifies code quality by outputting a deterministic 0–100 score after analyzing security, performance, correctness, and architecture. This score provides a clear health assessment to help developers target specific improvements like removing dead code.

How do I find dead code and oversized bundles in a React project?

To find dead code and oversized bundles in a React project, execute a project scan using the command npx -y react-doctor@latest . --verbose. This surfaces actionable architectural and bundle-size diagnostics to guide targeted performance improvements.

Does this React linting tool detect accessibility issues?

Yes, this React linting tool detects accessibility issues. It performs comprehensive diagnostics across your project to identify accessibility concerns alongside security and correctness problems, satisfying lint requirements and preventing regressions during feature development.

What are the limitations of using automated React architecture diagnostics?

Automated React architecture diagnostics are intended for use during feature development, bug fixes, or pre-commit checks. They report code quality issues by analyzing concerns in a codebase but require developer intervention to implement the suggested fixes and improve the health score.