react-doctor

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? React codebases accumulate lint violations, accessibility gaps, bundle bloat, and architecture problems that are hard to triage manually. This Skill runs automated diagnostics and produces a 0–100 health score so regressions are caught before code is committed. ## Core Features & Use Cases - Regression checks: Run a changed-scope scan after editing React code to verify the health score did not drop before committing. - Full triage workflow: The /doctor command fetches a canonical scan → filter → triage → fix → validate playbook that edits the working tree directly without committing or opening PRs. - Focused design audits: Run design-tagged rules covering UI composition, typography, interaction, accessibility, and motion. - Rule configuration: Explain, disable, re-severity, or tag-ignore rules via rules subcommands that edit doctor.config.* or package.json#reactDoctor in place. - Use Case: After finishing a feature, ask the agent to run react-doctor on changed files; if the score regresses, it fixes errors first, then warnings, before you commit. ## Quick Start Ask the agent to run react-doctor on the changed files and fix any regressions before committing.

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 for issues before committing?

Run npx react-doctor@latest --verbose --scope changed to scan only issues introduced versus the base branch. If the 0–100 health score dropped, fix the regressions before committing.

How do I disable or configure a React lint rule?

Use npx react-doctor@latest rules explain <rule> to understand it, then apply the narrowest control: rules disable, rules set <rule> warn, rules category off, or rules ignore-tag. These edit doctor.config.* or package.json#reactDoctor in place.

What does the /doctor command do?

The /doctor command fetches a canonical triage playbook from react.doctor and follows a scan, filter, triage, fix, validate loop. It edits the working tree directly but never commits or opens pull requests.

Can I run only accessibility and UI design checks?

Yes, run npx react-doctor@latest design --verbose to select only design-tagged rules covering UI composition, typography, interaction, accessibility, and motion, including rules that stay opt-in during a general scan.

Why does a disabled rule still not run after I set it to warn?

Tag-based ignores in ignore.tags disable every rule carrying that tag before linting, so a rule-level override cannot re-enable a tag-ignored rule. Remove the tag with rules unignore-tag first.