react-doctor

Diagnose React codebase issues across correctness, accessibility, performance, and maintainability.

130|14|Updated Apr 30, 2026
One-click install
npx skills add https://github.com/dmae97/oh-my-kimi --skill react-doctor-dmae97
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: react-doctor
Source: https://github.com/dmae97/oh-my-kimi/tree/main/templates/skills/agents/react-doctor
Command: npx skills add https://github.com/dmae97/oh-my-kimi --skill react-doctor-dmae97

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires react-doctor@latest.

What problem does it solve?

react-doctor helps you quickly identify and understand quality problems in React-based applications so you can improve correctness, performance, accessibility, and maintainability.

Core Features & Use Cases

  • React health diagnostics: Detects issues across React, Next.js, Vite, and React Native codebases.
  • Focused component, hook, and route review: Checks loading/error/empty and responsive states by inspecting the smallest relevant slices of the app.
  • Actionable findings with gating: Runs existing local gates (lint/typecheck/tests/build when available) before using React Doctor as an extra signal, then guides what to fix vs defer.

Quick Start

Use react-doctor to score and analyze the current React codebase from the project root and return findings you can act on.

Frequently Asked Questions about react-doctor

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

FAQPage Schema
How do I diagnose React component and hook render-path bugs?

Run a React health diagnostic from your project root to detect component and hook render-path bugs. The audit inspects loading, error, and empty states, then runs local gates like lint and typecheck before returning actionable findings to guide fixes.

Can I use a React code review tool with Next.js, Vite, and React Native projects?

Yes, React diagnostics support Next.js, Vite, Expo, and React Native projects. The tool detects framework and package configurations automatically, then applies targeted code review logic to check accessibility, performance, and maintainability issues across those environments.

What is the best way to audit React accessibility and performance issues?

Audit React accessibility and performance by executing local gates first, then applying external diagnostics as an extra signal. This approach identifies what to fix immediately versus defer, producing a report of fixed items, deferred items, and remaining risk.

Do I need existing lint and test configurations to run React diagnostics?

No, existing local gates like lint, typecheck, tests, and build are optional. The diagnostic tool runs them when available as a baseline signal, then applies its own analysis to identify correctness and accessibility issues regardless of your current setup.

How do I fix React regressions identified by an automated audit?

Fix React regressions by reviewing the audit output, which categorizes results into fixed versus deferred items. The diagnostic report highlights remaining risk and guides you on which component, hook, or route issues to address immediately versus defer for later.

What are the limitations of running a React codebase health check?

The health check focuses on the smallest relevant slices of your app rather than the entire codebase, and relies on optional local gates for baseline signals. It prioritizes targeted reading of relevant files, so undiscovered issues may remain outside the inspected scope.