← ClaudeAtlas

react-troubleshootlisted

Resolves React bugs, errors, and unexpected behavior via reproduce → root cause → fix → verify (React edition of SuperClaude /sc:troubleshoot). Covers infinite re-renders, hydration mismatches, stale closures, state not updating, build/type errors, failing tests. Use for "fix this error", "why doesn't this work", "bug", "blank screen".
riseshinee/superclaude-react · ★ 0 · Web & Frontend · score 70
Install: claude install-skill riseshinee/superclaude-react
# react-troubleshoot Symptom: `$ARGUMENTS` ## Flags | Flag | Meaning | |---|---| | `--fix` | Apply the fix once the cause is confirmed (otherwise present cause + fix and ask) | | `--trace` | Record evidence (logs, code locations) for each hypothesis as you go | ## Behavioral Flow 1. **Detect** — Confirm the stack with `react-stack` (React version and framework matter for diagnosis). Then get a fresh `react-map` and use it to locate code, following its token budget rules. 2. **Reproduce** — Get the full error, stack trace, and repro path. Where possible: - Build/type/test errors → run the command yourself - Runtime/UI bugs → use **Playwright MCP** to inspect console logs and network 3. **Hypothesize** — Pick up to 3 candidate causes from the symptom table below, ordered by likelihood. 4. **Confirm the cause** — Read code, add logs, or build a minimal repro until the cause is **confirmed**. Don't fix before that. 5. **Fix** — Fix the cause, not the symptom. Add a regression test when feasible. 6. **Verify** — Re-run the repro, run related tests, remove temporary logs. ## Symptom Table | Symptom | Common cause | Check | |---|---|---| | `Too many re-renders` | setState during render, `onClick={fn()}` | Handler passed as reference, not called | | Effect infinite loop | Object/array/function dependency recreated every render | Referential stability of dependencies | | Stale values (stale closure) | Effect/interval/callback captured old state | Missing deps, functional u