Skip to main content
subagent CX Codex

react-specialist · voltagent/awesome-codex-subagents — Codex subagent: what it does, how to install

react-specialist — a subagent for debugging React component behavior, state flow, and render bugs. It isolates root causes and applies targeted fixes.

MIT ★ 6,505 updated 2026-10-05

Install into Codex · Manually: put the files in place All methods and platforms ↓
.codex/agents/react-specialist.toml
Open on GitHub

What react-specialist does

The subagent targets React component behavior, state flow issues, and rendering bugs. It begins by mapping the execution boundary, tracing entry points, data paths, and external dependencies. It isolates the design gap or root cause before suggesting changes.

Its review covers effect cleanups, stale closures, controlled or uncontrolled input behavior, and keyboard accessibility. If a framework integrates client and server rendering, it inspects that boundary directly.

The instructions forbid adding broad architectural abstractions for localized behavior changes unless the parent agent explicitly demands them. Output includes the exact modified path, root cause rationale, validated failure modes, and remaining environment risks.

What it helps with

  • diagnose unexpected re-renders and state desynchronization
  • resolve effect cleanup failures and stale closure bugs
  • fix controlled and uncontrolled input handling in forms
  • check keyboard navigation semantics on updated interactive elements

Example prompts for the agent

  • Find what triggers excessive re-renders in the UserFeed component and apply the smallest fix
  • Inspect useEffect dependency safety in useAuthSession to stop stale closure bugs
  • Verify loading and error states for the controlled inputs in CheckoutForm

How to install react-specialist

Manually: put the files in place

.codex/agents/react-specialist.toml

Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about react-specialist

How to install react-specialist in Codex?

Save the subagent configuration into .codex/agents/react-specialist.toml inside your project directory.

What does react-specialist do?

It diagnoses React component behavior, fixes rendering issues, and validates hook dependency safety.

Which model is configured for this subagent?

The subagent configuration defines gpt-5.6-sol as its model.

Source text

react-specialist.toml · MIT
# react-specialist

Use when a task needs a React-focused agent for component behavior, state flow, rendering bugs, or modern React patterns.

Own React tasks as production behavior and contract work, not checklist execution.

Prioritize smallest safe changes that preserve established architecture, and make explicit where compatibility or environment assumptions still need verification.

Working mode:
1. Map the exact execution boundary (entry point, state/data path, and external dependencies).
2. Identify root cause or design gap in that boundary before proposing changes.
3. Implement or recommend the smallest coherent fix that preserves existing behavior outside scope.
4. Validate the changed path, one failure mode, and one integration boundary.

Focus on:
- component ownership boundaries and state flow clarity
- rendering correctness under async updates and transitions
- event handling, derived state, and effect dependency safety
- accessibility and keyboard semantics for changed interactions
- client/server boundary behavior when framework integration exists
- performance hotspots caused by unnecessary renders or unstable keys
- preserving existing design-system and component patterns

Quality checks:
- verify changed user flow through loading, success, and failure states
- confirm effects clean up correctly and avoid stale closure bugs
- check controlled/uncontrolled input behavior for forms touched
- ensure accessibility regressions are avoided in interactive elements
- call out integration checks needed for API contract or routing changes

Return:
- exact module/path and execution boundary you analyzed or changed
- concrete issue observed (or likely risk) and why it happens
- smallest safe fix/recommendation and tradeoff rationale
- what you validated directly and what still needs environment-level validation
- residual risk, compatibility notes, and targeted follow-up actions

Do not introduce broad architectural abstractions for a localized behavior change unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Similar subagents

All subagents for Frontend and UI →

react-specialist by other authors comes first.

react-specialist VoltAgent Community react-specialist — a subagent for improving existing React code, from performance and state flow to architecture and tests. Use it when a project needs focused technical changes. CX Codex 815installs react-patterns manutej A skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode that teaches the agent modern React patterns, from hooks and component composition to state management. Covers React 18+, Server Components, and memoization. CX Codex +1 474installs react-development manutej react-development — a skill that feeds your coding agent React patterns: components, hooks, state and effects, taken from the official react.dev docs. CX Codex +1 470installs react-expert 0xfurai react-expert is a Claude Code subagent for React refactoring, performance work, and complex state changes. It can handle tasks involving hooks, context, and unnecessary renders. CX Codex ★ 1,029repo stars react-zustand-cursorrules-prompt-file PatrickJS The react-zustand-cursorrules-prompt-file Cursor rule guides Zustand use in React and TypeScript projects, covering store design, unnecessary re-renders, and separation of server and client state. CX Codex +1 ★ 41,178repo stars react-mobx sanjeed5 react-mobx sets MobX best practices for React in Cursor: enforces makeObservable and RootStore architecture with fine-grained observer components. CX Codex +1 ★ 3,589repo stars react-state-fallback alexj11324 react-state-fallback is a Claude Code rule that enforces reactive fallbacks instead of copying props into component state. It prevents stale UI bugs during parent updates. CX Codex +1 ★ 88repo stars

From the same set176

The whole set →
swift-expert swift-expert — a subagent for Swift work on iOS and macOS. Treats production code as a contract, not a checklist: maps execution boundaries, identifies root causes, applies minimal changes, and validates impact on the rest of the codebase. CX Codex ★ 6,505repo stars sql-pro sql-pro designs SQL queries, reviews execution plans, debugs schema mismatches, and evaluates database migrations. CX Codex ★ 6,505repo stars spring-boot-engineer spring-boot-engineer — a subagent for Spring Boot tasks: configuration, data layers, APIs, transactions, and security. Maps execution boundaries, identifies root causes, and proposes minimal safe changes that preserve architecture. CX Codex ★ 6,505repo stars rust-engineer rust-engineer — a subagent for Rust work centered on ownership correctness, lifetimes, and async behavior. Targets systems code where borrowing errors or synchronization bugs have high cost. CX Codex ★ 6,505repo stars rails-expert rails-expert traces Rails changes from request entry point to persistence and response. Use it to investigate bugs or scope a fix that stays within the project’s existing conventions. CX Codex ★ 6,505repo stars python-pro python-pro — a subagent for Python tasks that require tracing execution behavior, typing contracts, exception semantics, packaging structure, and architecture boundaries. Finds root causes instead of surface fixes. CX Codex ★ 6,505repo stars powershell-7-expert powershell-7-expert handles modern PowerShell 7 automation across Windows, Linux, and macOS, focusing on .NET tooling, pipeline contracts, and CI jobs. CX Codex ★ 6,505repo stars powershell-5.1-expert The powershell-5.1-expert subagent handles Windows PowerShell 5.1 work, including .NET Framework interop, legacy remoting, and administration scripts. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open