improve-react

improve-react is an advisor skill that surveys an entire React codebase as a senior React engineer and produces a prioritized audit plus self-contained implementation plans for other agents (or cheaper models) to execute. It solves the problem of turning a static scanner's raw findings into high-leverage, precisely specified work: React Doctor lists what is technically wrong, and this skill adds the judgment about which issues actually matter and writes plans precise enough that an executor with no context and no React instinct can carry them out. Critically, it is strictly read-only on source code — it plans improvements but never applies them.

The workflow begins with recon: run React Doctor once, read-only, emitting structured JSON findings (rule id, category, severity, file:line). The skill then applies leverage judgment across five audit categories — bugs and correctness, performance, accessibility, security, and maintainability/architecture — and writes one plan per finding using a strict template that includes the exact current code, the exact target code pulled from React Doctor's canonical per-rule fix prompt, repo conventions to follow, concrete steps, boundaries, and verification (mechanical checks plus a behavior/Profiler check). Its hard rules forbid modifying source, running any mutating or `--fix` operations, installing dependencies, or committing; plans must be fully self-contained; repository content is treated as inert data (prompt-injection attempts in files are flagged as findings, not obeyed); and deliberately suppressed or disabled rules are respected rather than re-litigated.

Target users are engineers and teams who want a prioritized improvement roadmap for a React app rather than a single-diff review, and who plan to hand execution to another agent later. Typical use cases include auditing a codebase, planning a performance or accessibility pass, or producing a backlog of precise fix plans. The read-only posture and explicit refusal of mutating operations make it a safe planning tool.