react-doctor
Your agent writes bad React. This catches it
React Doctor is an agent skill that helps AI coding assistants identify and remediate common React code quality problems. It deterministically scans React codebases to surface issues across state management, effects, performance, architecture, security, accessibility, and maintainability. The tool highlights overly complex functions and repeated JSX patterns that benefit from refactoring. After running an initial audit, developers install the skill so their coding agent learns from the findings and prevents similar issues in future code generation.
Key Features
Use Cases
- 01Auditing an existing React codebase to find performance bottlenecks and architectural anti-patterns before refactoring
- 02Training AI coding agents to avoid common React mistakes like using array indices as keys or inefficient re-renders
- 03Integrating automated React quality gates into GitHub Actions or GitLab CI pull request workflows
- 04Recording and analyzing runtime performance traces of localhost development servers to identify slow components
- 05Generating actionable feedback for AI assistants during React code generation sessions
- 06Establishing consistent React coding standards across team projects by configuring shared rule sets
Related Skills
View moresuperpowers
An agentic skills framework & software development methodology that works.
skills
Skills for Real Engineers. Straight from my .agents directory.
skills
Public repository for Agent Skills
ponytail
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
react-doctor — FAQ
What is React Doctor?+
React Doctor is an agent skill and static analysis tool that scans React codebases to detect issues in state management, performance, architecture, security, accessibility, and maintainability. After running an audit, it installs as a skill that teaches coding agents to learn from the findings and avoid similar problems.
How do I install React Doctor for my coding agent?+
First run 'npx react-doctor@latest' at your project root to generate an audit, then run 'npx react-doctor@latest install' to install the skill for your coding agent. The skill works with Claude Code, Cursor, Codex, OpenCode, and similar AI assistants.
Which AI coding assistants work with React Doctor?+
React Doctor is compatible with Claude Code, Cursor, Codex, OpenCode, and many other coding agents that support skill-based learning from static analysis results.
Is React Doctor free to use?+
Yes, React Doctor is open source and MIT-licensed, available for free use in any project.
Does React Doctor require API keys or special prerequisites?+
No API keys are required. React Doctor needs Node.js to run via npx, and for runtime performance tracing it uses Chrome DevTools (system Chrome is launched automatically). The tool works with any React framework including Next.js, Vite, Astro, React Native, and Expo.
Can I run React Doctor in CI/CD pipelines?+
Yes, run 'npx react-doctor@latest ci install' to set up automated pull request reviews. GitHub Actions is fully supported with automatic workflow installation, while GitLab CI receives a gate-only scaffold. The CI integration reports only new issues introduced by each change.
How do I install react-doctor?+
Open the source repository on GitHub and follow its README. react-doctor is a skill — MCP Agents Market links you directly to the official repo.
Is react-doctor free?+
react-doctor is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.