# Send React to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "react",
    "name": "React",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/ivangdavila/react",
    "canonicalUrl": "https://clawhub.ai/ivangdavila/react",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/react",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=react",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "memory-template.md",
      "setup.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "react",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T21:33:00.707Z",
      "expiresAt": "2026-05-14T21:33:00.707Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=react",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=react",
        "contentDisposition": "attachment; filename=\"react-1.0.4.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "react"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/react"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/react",
    "downloadUrl": "https://openagent3.xyz/downloads/react",
    "agentUrl": "https://openagent3.xyz/skills/react/agent",
    "manifestUrl": "https://openagent3.xyz/skills/react/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/react/agent.md"
  }
}
```
## Documentation

### React

Production-grade React engineering. This skill transforms how you build React applications — from component architecture to deployment.

### When to Use

Building React components, pages, or features
Implementing state management (useState, Context, Zustand, TanStack Query)
Working with React 19 (Server Components, use(), Actions)
Optimizing performance (memo, lazy, Suspense)
Debugging rendering issues, infinite loops, stale closures
Setting up project architecture and folder structure

### Architecture Decisions

Before writing code, make these decisions:

DecisionOptionsDefaultRenderingSPA / SSR / Static / HybridSSR (Next.js)State (server)TanStack Query / SWR / use()TanStack QueryState (client)useState / Zustand / JotaiZustand if sharedStylingTailwind / CSS Modules / styledTailwindFormsReact Hook Form + Zod / nativeRHF + Zod

Rule: Server state (API data) and client state (UI state) are DIFFERENT. Never mix them.

### Component Rules

// ✅ The correct pattern
export function UserCard({ user, onEdit }: UserCardProps) {
  // 1. Hooks first (always)
  const [isOpen, setIsOpen] = useState(false)
  
  // 2. Derived state (NO useEffect for this)
  const fullName = \`${user.firstName} ${user.lastName}\`
  
  // 3. Handlers
  const handleEdit = useCallback(() => onEdit(user.id), [onEdit, user.id])
  
  // 4. Early returns
  if (!user) return null
  
  // 5. JSX (max 50 lines)
  return (...)
}

RuleWhyNamed exports onlyRefactoring safety, IDE supportProps interface exportedReusable, documentedMax 50 lines JSXExtract if biggerMax 300 lines fileSplit into componentsHooks at topReact rules + predictable

### State Management

Is it from an API?
├─ YES → TanStack Query (NOT Redux, NOT Zustand)
└─ NO → Is it shared across components?
    ├─ YES → Zustand (simple) or Context (if rarely changes)
    └─ NO → useState

### TanStack Query (Server State)

// Query key factory — prevents key typos
export const userKeys = {
  all: ['users'] as const,
  detail: (id: string) => [...userKeys.all, id] as const,
}

export function useUser(id: string) {
  return useQuery({
    queryKey: userKeys.detail(id),
    queryFn: () => fetchUser(id),
    staleTime: 5 * 60 * 1000, // 5 min
  })
}

### Zustand (Client State)

// Thin stores, one concern each
export const useUIStore = create<UIState>()((set) => ({
  sidebarOpen: true,
  toggleSidebar: () => set((s) => ({ sidebarOpen: !s.sidebarOpen })),
}))

// ALWAYS use selectors — prevents unnecessary rerenders
const isOpen = useUIStore((s) => s.sidebarOpen)

### Server Components (Default in Next.js App Router)

// Server Component — runs on server, zero JS to client
async function ProductList() {
  const products = await db.products.findMany() // Direct DB access
  return <ul>{products.map(p => <ProductCard key={p.id} product={p} />)}</ul>
}

// Client Component — needs 'use client' directive
'use client'
function AddToCartButton({ productId }: { productId: string }) {
  const [loading, setLoading] = useState(false)
  return <button onClick={() => addToCart(productId)}>Add</button>
}

Server ComponentClient Componentasync/await ✅useState ✅Direct DB ✅onClick ✅No bundle sizeAdds to bundleuseState ❌async ❌

### use() Hook

// Read promises in render (with Suspense)
function Comments({ promise }: { promise: Promise<Comment[]> }) {
  const comments = use(promise) // Suspends until resolved
  return <ul>{comments.map(c => <li key={c.id}>{c.text}</li>)}</ul>
}

### useActionState (Forms)

'use client'
async function submitAction(prev: State, formData: FormData) {
  'use server'
  // ... server logic
  return { success: true }
}

function Form() {
  const [state, action, pending] = useActionState(submitAction, {})
  return (
    <form action={action}>
      <input name="email" disabled={pending} />
      <button disabled={pending}>{pending ? 'Saving...' : 'Save'}</button>
      {state.error && <p>{state.error}</p>}
    </form>
  )
}

### Performance

PriorityTechniqueImpactP0Route-based code splitting🔴 HighP0Image optimization (next/image)🔴 HighP1Virtualize long lists (tanstack-virtual)🟡 MediumP1Debounce expensive operations🟡 MediumP2React.memo on expensive components🟢 Low-MedP2useMemo for expensive calculations🟢 Low-Med

React Compiler (React 19+): Auto-memoizes. Remove manual memo/useMemo/useCallback.

### Rendering Traps

// ❌ Renders "0" when count is 0
{count && <Component />}

// ✅ Explicit boolean
{count > 0 && <Component />}

// ❌ Mutating state — React won't detect
array.push(item)
setArray(array)

// ✅ New reference
setArray([...array, item])

// ❌ New key every render — destroys component
<Item key={Math.random()} />

// ✅ Stable key
<Item key={item.id} />

### Hooks Traps

// ❌ useEffect cannot be async
useEffect(async () => { ... }, [])

// ✅ Define async inside
useEffect(() => {
  async function load() { ... }
  load()
}, [])

// ❌ Missing cleanup — memory leak
useEffect(() => {
  const sub = subscribe()
}, [])

// ✅ Return cleanup
useEffect(() => {
  const sub = subscribe()
  return () => sub.unsubscribe()
}, [])

// ❌ Object in deps — triggers every render
useEffect(() => { ... }, [{ id: 1 }])

// ✅ Extract primitives or memoize
useEffect(() => { ... }, [id])

### Data Fetching Traps

// ❌ Sequential fetches — slow
const users = await fetchUsers()
const orders = await fetchOrders()

// ✅ Parallel
const [users, orders] = await Promise.all([fetchUsers(), fetchOrders()])

// ❌ Race condition — no abort
useEffect(() => {
  fetch(url).then(setData)
}, [url])

// ✅ Abort controller
useEffect(() => {
  const controller = new AbortController()
  fetch(url, { signal: controller.signal }).then(setData)
  return () => controller.abort()
}, [url])

### AI Mistakes to Avoid

Common errors AI assistants make with React:

MistakeCorrect PatternuseEffect for derived stateCompute inline: const x = a + bRedux for API dataTanStack Query for server stateDefault exportsNamed exports: export function XIndex as key in dynamic listsStable IDs: key={item.id}Fetching in useEffectTanStack Query or loader patternsGiant components (500+ lines)Split at 50 lines JSX, 300 lines fileNo error boundariesAdd at app, feature, component levelIgnoring TypeScript strictEnable strict: true, fix all errors

### Hooks

HookPurposeuseStateLocal stateuseEffectSide effects (subscriptions, DOM)useCallbackStable function referenceuseMemoExpensive calculationuseRefMutable ref, DOM accessuse()Read promise/context (React 19)useActionStateForm action state (React 19)useOptimisticOptimistic UI (React 19)

### File Structure

src/
├── app/                 # Routes (Next.js)
├── features/            # Feature modules
│   └── auth/
│       ├── components/  # Feature components
│       ├── hooks/       # Feature hooks
│       ├── api/         # API calls
│       └── index.ts     # Public exports
├── shared/              # Cross-feature
│   ├── components/ui/   # Button, Input, etc.
│   └── hooks/           # useDebounce, etc.
└── providers/           # Context providers

### Setup

See setup.md for first-time configuration. Uses memory-template.md for project tracking.

### Core Rules

Server state ≠ client state — API data goes in TanStack Query, UI state in useState/Zustand. Never mix.
Named exports only — export function X not export default. Enables safe refactoring.
Colocate, then extract — Start with state near usage. Lift only when needed.
No useEffect for derived state — Compute inline: const total = items.reduce(...). Effects are for side effects.
Stable keys always — Use item.id, never index for dynamic lists.
Max 50 lines JSX — If bigger, extract components. Max 300 lines per file.
TypeScript strict: true — No any, no implicit nulls. Catch bugs at compile time.

### Related Skills

Install with clawhub install <slug> if user confirms:

frontend-design-ultimate — Build complete UIs with React + Tailwind
typescript — TypeScript patterns and strict configuration
nextjs — Next.js App Router and deployment
testing — Testing React components with Testing Library

### Feedback

If useful: clawhub star react
Stay updated: clawhub sync
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: ivangdavila
- Version: 1.0.4
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-07T21:33:00.707Z
- Expires at: 2026-05-14T21:33:00.707Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/react)
- [Send to Agent page](https://openagent3.xyz/skills/react/agent)
- [JSON manifest](https://openagent3.xyz/skills/react/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/react/agent.md)
- [Download page](https://openagent3.xyz/downloads/react)