react-doctor

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

Updated Apr 27, 2026
One-click install
npx skills add https://github.com/GSU26SE55/frontend --skill react-doctor-gsu26se55
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: react-doctor
Source: https://github.com/GSU26SE55/frontend/tree/main/.claude/skills/react-doctor
Command: npx skills add https://github.com/GSU26SE55/frontend --skill react-doctor-gsu26se55

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires react-doctor, and 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 commits. ## 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: The design subcommand runs only UI composition, typography, interaction, accessibility, and motion rules. - 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 dropped, it fixes the regressions 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 health score dropped, fix the reported regressions before committing.

How do I run a full React codebase health scan?▼

Run npx react-doctor@latest --verbose, which uses the default full scope. Fix issues by severity, addressing errors first and then warnings, and use the /doctor workflow for a guided triage pass.

How do I disable or configure a react-doctor rule?▼

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

Can react-doctor audit only UI design and accessibility issues?▼

Yes, run npx react-doctor@latest design --verbose to select only design-tagged rules covering UI composition, typography, interaction, accessibility, and motion, including opt-in rules skipped by general scans.

Why is a rule still off after I set it to warn in config?▼

Tags 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, then set the rule severity.