react-doctor
Skill32 starsChanged 6 months agoMITView on GitHub
Scans React codebases for security, performance, correctness, accessibility and architecture issues and reports a 0-100 health score, with severity-ranked findings and a regression check to run after changes. Can also run a focused UI design audit and a runtime performance trace.
52 other projects use a version of this.
Adopted by
Most recently taken up by
- uptimekit/uptimekittheir own version, first seen Nov 8, 2026
- PunGrumpy/docker-doctortheir own version, first seen Nov 8, 2026
- compozy/compozytheir own version, first seen Nov 7, 2026
- PostHog/posthog-fosstheir own version, first seen Nov 6, 2026
- theexperiencecompany/gaiatheir own version, first seen Nov 3, 2026
- JuankCadavid/akili-specstheir own version, first seen Nov 2, 2026
Used with
Projects with it also use turborepo, make-interfaces-feel-better and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
VercelSkillturborepo
Turborepo monorepo build system guidance. Triggers on: turbo.json, task pipelines, dependsOn, caching, remote cache, the "turbo" CLI, --filter, --affected, CI optimization, environment variables, internal packages, monorepo structure/best practices, and boundaries.
Also in 5 projects that use this
studio-lgtmSkillmake-interfaces-feel-better
Apply design engineering best practices to polish UI components - use when reviewing or improving interfaces, animations, typography, or interaction details.
Also in 4 projects that use this
AnasX7Skillbetter-accessibility
Helps your project comply with accessibility standards and best practices.
Also in 3 projects that use this
AnasX7Skillbetter-layout
Helps with grouping, alignment, reading order, progressive disclosure and other details that make a good layout.
Also in 3 projects that use this
SentrySkillvercel-composition-patterns
Also in 6 projects that use this
VercelSkillgh-stack
Manages stacked PRs and splits multi-part work into reviewable branches with gh-stack. Use for stack creation, viewing, edits, push, submit, sync, rebase, merge, or checkout; when asked to split or isolate work for review; whenever a user mentions a stack, branch layers, dependent PRs, or gh stack; or when a stack is checked out.
Also in 3 projects that use this
- +2 more from AnasX7
Other versions52 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 52
- makeplane/plane★ 62ksame name
- gogs/gogs★ 48ksame name
- PostHog/posthog★ 40ksame name
- millionco/react-doctor★ 15ksame name
- humanlayer/humanlayer★ 13ksame name
- ArcReel/ArcReel★ 6.3ksame name
- transformerlab/transformerlab-app★ 5.2ksame name
- pgrok/pgrok★ 3.6ksame name
- Shelf-nu/shelf.nu★ 3.1ksame name
- compozy/compozy★ 2.9ksame name
42 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository170 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- accessibility-agentsSkill
- accessibility-catalogueSkill
- addyosmani-qualitySkill
- ai-graphic-design-skillSkill
- algorithmic-artSkill
- anatomySkill
- animate-css-skillSkill
- animate-skillSkill
- anthropics-skillsSkill
- antvis-chart-skillsSkill
- apple-hig-skillsSkill
- assimovt-productskillsSkill
- awesome-design-skillsSkill
- baseline-uiSkill
- bencium-ux-designerSkill
- brand-design-mdSkill
- building-componentsSkill
- callstack-agent-skillsSkill
- cc-slidevSkill
- chadboyda-gtmSkill
- claud3Skill
- claude2figmaSkill
- claudedesignskillsSkill
- claude-pm-skillsSkill
- claude-wireframe-skillSkill
- cloudai-threejsSkill
- cloudflare-web-perfSkill
- color-expertSkill
- composio-artifactsSkill
- content-catalogueSkill
- content-strategySkill
- copywriting-skillSkill
- coreyhaines-marketingSkill
- creative-directorSkill
- css-animation-skillSkill
- d3js-skillSkill
- dark-pattern-auditSkill
- data-analysis-skillSkill
- data-viz-agentSkill
- deanpeters-pm-skillsSkill
- design-auditorSkill
- design-briefSkill
- design-catalogueSkill
- design-consultationSkill
- design-debt-auditSkill
- design-engineering-catalogueSkill
- designer-skillsSkill
- design-for-aiSkill
- design-htmlSkill
- design-impact-reportingSkill
- design-labSkill
- design-motion-principlesSkill
- design-negotiationSkill
- design-review-garrytanSkill
- design-sprintSkill
- design-system-governanceSkill
- design-tokens-skillSkill
- design-with-claudeSkill
- digidai-pmSkill
- The first 60 shown.
The file
Files
react-doctor
Catalogue stub — full skill: millionco/react-doctor
<!-- das:install:start — generated from stub.yaml by `npm run generate`; edit stub.yaml, not this block -->Decision tree
- Is the full skill already installed?
- Global:
f=~/.agents/skills/react-doctor/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer" - Project:
f=.agents/skills/react-doctor/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer" installed→ the skill is installed asreact-doctor, invoke it and proceedpointer→ go to step 2
- Global:
Detect scope, then install:
[ -e ~/.agents/skills/react-doctor ] && echo "global" || echo "project"Global:
npx skills add millionco/react-doctor --skill react-doctor -g -yProject:
npx skills add millionco/react-doctor --skill react-doctor -yClaude Code: send a command as a chat message starting with
!to run it without leaving the conversation.
Heads-up
- Requires: Node.js with network access, because the skill runs
npx react-doctor@latestat use time; the /doctor workflow fetches a remote playbook from www.react.doctor with curl on every run - License: Modified MIT, GitHub shows NOASSERTION (prior written permission needed to use it as AI training or evaluation data, or to sell it as a hosted service)
- Large download (~120 MB): the skills CLI gives up cloning after 300 s; if it times out, retry with
SKILLS_CLONE_TIMEOUT_MS=900000.
<!-- das:install:end -->Invoke after install
- Skill name:
react-doctor - Trigger phrases: "react doctor", "React audit", "React performance", "React security", "component quality"
What it does
Runs npx react-doctor@latest against a React codebase to detect regressions in security, rendering performance, correctness, accessibility and architectural soundness. Returns a 0-100 score and findings ranked by severity, with component locations and remediation guidance. Use it after React changes (--scope changed) or for a full cleanup pass. A /doctor command runs a full local triage loop from a playbook the skill fetches from react.doctor, a design mode runs a focused UI audit, and scan <url> records a Chrome DevTools trace of a slow interaction. Because it executes the latest published package and a remote playbook at use time, review what it runs in sensitive repos.
When NOT to use
- Non-React projects
- A WCAG-focused accessibility pass or compliance write-up (use
fixing-accessibilityorwcag-audit-patterns) - Core Web Vitals and general web performance work beyond React (use
addyosmani-quality)
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

