pi-react-doctor

Unofficial Pi skill wrapper for React Doctor (by Million.co) — scans React codebases for security, performance, correctness, and architecture issues.

Packages

Package details

skill

Install pi-react-doctor from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-react-doctor
Package
pi-react-doctor
Version
1.0.0
Published
Jul 15, 2026
Downloads
159/mo · 159/wk
Author
im-nick
License
MIT
Types
skill
Size
11.7 KB
Dependencies
0 dependencies · 0 peers
Pi manifest JSON
{
  "skills": [
    "./skills"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-react-doctor

Pi skill wrapper for React Doctor — the deterministic React codebase scanner by Million.co.

Your coding agent stops writing bad React.

npm license upstream

What it does

Adds the React Doctor skill to Pi. React Doctor deterministically scans your React codebase and catches issues across state & effects, performance, architecture, security, and accessibility. Works with Next.js, Vite, TanStack, React Native, Expo — anything React.

Install

pi install npm:pi-react-doctor

Or locally for a single project:

pi install -l npm:pi-react-doctor

Usage

The skill triggers when you:

  • Type /doctor in a React project
  • Ask Pi to "scan my React code" or "triage diagnostics"
  • Finish a feature and want a regression check before committing

Quick scan (changed files only)

Pi will run:

npx react-doctor@latest --verbose --scope changed

Full cleanup pass

Say /doctor and Pi fetches the canonical local-triage playbook from react.doctor — a scan → filter → triage → fix → validate loop that edits the working tree directly.

Rule management

Pi can also explain, disable, or tune individual rules:

npx react-doctor@latest rules explain react-doctor/no-array-index-as-key
npx react-doctor@latest rules disable react-doctor/no-array-index-as-key
npx react-doctor@latest rules set react-doctor/no-danger warn

Requirements

  • Pi coding agent
  • Node.js ≥ 20.19.0 (react-doctor CLI is auto-fetched via npx)

How it works

This package is a thin skill wrapper. It registers the react-doctor skill in Pi, which:

  1. Detects React projects (presence of react in package.json)
  2. Runs npx react-doctor@latest with the right flags
  3. Fetches the canonical triage playbook from react.doctor for full passes
  4. Surfaces diagnostics with fix recipes

The actual scanning engine lives in the react-doctor npm package — this wrapper handles Pi integration only.

Credits

React Doctor is built and maintained by Million.co. This package is an unofficial Pi skill wrapper — all scanning logic, rules, and playbooks belong to the upstream project. Huge thanks to the Million team for building an incredible tool.

If React Doctor saves your team hours, consider sponsoring them on GitHub.

Related

License

MIT — same as upstream.