react-doctor

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

Updated Jun 9, 2026
One-click install
npx skills add https://github.com/TOBIASpuchito/Citec --skill react-doctor-tobiaspuchito
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: react-doctor
Source: https://github.com/TOBIASpuchito/Citec/tree/main/citec-frontend/.agents/skills/react-doctor
Command: npx skills add https://github.com/TOBIASpuchito/Citec --skill react-doctor-tobiaspuchito

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 issues that are hard to triage manually. This Skill runs automated diagnostics, assigns a 0-100 health score, and guides a scan-to-fix workflow so regressions are caught before commits. ## Core Features & Use Cases - Regression Checks: Run a changed-scope scan after edits to verify the health score did not drop before committing code. - Full Local Triage: Trigger the /doctor workflow to fetch the canonical playbook and follow a scan, filter, triage, fix, validate loop that edits the working tree directly. - Rule Configuration: Explain any rule, then disable, re-enable, re-severity, or ignore entire categories and tags by editing doctor.config or package.json. - Use Case: After refactoring a React feature, ask the agent to run react-doctor on changed files; if the score drops, it fixes the new errors and warnings before you commit. ## Quick Start Ask the agent to run react-doctor on the changed files and fix any issues that lowered the health score.

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 errors and warnings before committing.

How do I disable a React lint rule that is too noisy?▼

Run npx react-doctor@latest rules explain <rule> to understand it first, then use rules disable <rule> to turn it off. The command edits your doctor.config or package.json reactDoctor key in place while preserving other settings.

What does the react-doctor health score measure?▼

The score is a 0-100 metric reflecting security, performance, correctness, accessibility, and architecture diagnostics found in the codebase. Running with --score outputs only the numeric value for quick regression comparison.

Can I scan only the lines I changed instead of the whole codebase?▼

Yes, use --scope lines to report only issues on changed lines, or --scope changed for issues introduced versus the base branch. The default full scope scans the entire codebase.

Why does a rule stay off even after I set it to warn?▼

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.