react-doctor

Detect React anti-patterns, performance regressions, accessibility gaps, and hook misuse in .tsx/.jsx files.

2|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/hamzaPixl/pixl-ai --skill react-doctor-hamzapixl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: react-doctor
Source: https://github.com/hamzaPixl/pixl-ai/tree/main/packages/crew/skills/react-doctor
Command: npx skills add https://github.com/hamzaPixl/pixl-ai --skill react-doctor-hamzapixl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

React development often introduces performance regressions, accessibility gaps, and anti-patterns that are hard to spot in code review, leading to user-facing bugs and degraded UX. This Skill automates scanning changed components and directories to surface those issues early with concrete file:line references and remediation suggestions.

Core Features & Use Cases

  • Anti-pattern detection: Finds unnecessary useEffect, missing dependency arrays, prop drilling, index-as-key, inline object/array creation, and direct DOM manipulation.
  • Performance auditing: Flags large re-renders, missing memoization, heavy imports for lazy-loading, image optimization issues, and improper client component usage.
  • Accessibility & design checks: Reports missing alt text, labels, button text, keyboard navigability issues, color-contrast problems, and AI slop visual anti-patterns with file:line and recommended fixes.
  • Scoped scanning: Targets git-diff changed .tsx/.jsx files, a specified directory, or the entire src/ to fit code-review and feature-completion workflows.
  • Reference-driven: Points to curated reference docs for performance and design rationale.

Quick Start

Run react-doctor on the changed files or src/ to generate a health report with critical, warning, and info findings.

Frequently Asked Questions about react-doctor

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

FAQPage Schema
How do I audit React components for performance and accessibility issues?

React performance and accessibility auditing detects anti-patterns, missing memoization, and keyboard navigability gaps. It scans changed .tsx/.jsx files or directories and produces file:line findings grouped by severity with remediation suggestions.

What are common React anti-patterns to look for in a code review?

Common React anti-patterns include unnecessary useEffect, missing dependency arrays, prop drilling, index-as-key, and inline object creation. Scanning flags these issues alongside direct DOM manipulation and improper client component usage with specific file:line references.

Can I scan only the changed React files instead of the entire src directory?

Yes, you can scope scanning to target git-diff changed .tsx/.jsx files, a specified component directory, or the entire src directory. This flexibility fits code-review workflows and feature-completion checks without processing the whole codebase.

Does this React audit check for accessibility and design anti-patterns?

Yes, the React audit checks for accessibility and design anti-patterns by reporting missing alt text, labels, button text, and keyboard navigability issues. It also flags color-contrast problems and AI slop visual anti-patterns with recommended fixes.

What is the best way to catch React hook misuse before production?

The best way to catch React hook misuse is to run an automated scan on changed .tsx/.jsx files that identifies missing dependency arrays and improper useEffect usage. This produces file:line findings grouped by severity to fix issues early.

What frontend performance issues can a React codebase scan detect?

A React codebase scan detects large re-renders, missing memoization, heavy imports needing lazy-loading, and image optimization issues. It references frontend performance anti-pattern catalogs to provide rationale for each flagged issue.