OpenParable
Skip to content
← Back to skills

React Skills

Development
react-skills

React Skills is an Agent Skill for development published in the llama-farm/llamafarm repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

React 18 patterns for LlamaFarm Designer. Covers components, hooks, TanStack Query, and testing.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/llama-farm/llamafarm/blob/HEAD/.claude/skills/react-skills/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/react-skills, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

React Skills for LlamaFarm Designer

Best practices and patterns for React 18 development in the Designer subsystem.

Tech Stack

  • React 18.2 with StrictMode
  • TypeScript 5.2+ for type safety
  • TanStack Query v5 for server state management
  • React Router v7 for client-side routing
  • TailwindCSS with tailwind-merge and clsx for styling
  • Radix UI primitives for accessible components
  • Vite for build tooling
  • Vitest + React Testing Library for testing

Directory Structure

designer/src/
  api/          # API service functions
  components/   # React components (feature-organized)
  contexts/     # React context providers
  hooks/        # Custom hooks
  lib/          # Utility functions (cn, etc.)
  types/        # TypeScript type definitions
  utils/        # Helper functions
  test/         # Test utilities and mocks

Core Patterns

Component Composition

  • Use composition over inheritance
  • Prefer small, focused components
  • Use forwardRef for components that wrap DOM elements
  • Apply displayName to forwardRef components for DevTools

State Management

  • Local UI state: useState, useReducer
  • Server state: TanStack Query (useQuery, useMutation)
  • Shared UI state: React Context with custom hooks
  • Form state: Controlled components with validation

Hooks

  • Follow Rules of Hooks (top-level, consistent order)
  • Create custom hooks for reusable logic
  • Use query key factories for TanStack Query
  • Memoize expensive computations with useMemo
  • Stabilize callbacks with useCallback

Styling

  • Use cn() from lib/utils to merge Tailwind classes
  • Use cva (class-variance-authority) for component variants
  • Follow dark mode conventions with dark: prefix

Related Guides

Quick Reference

// Utility for merging Tailwind classes
import { cn } from '@/lib/utils'
cn('base-class', condition && 'conditional-class', className)

// Query key factory pattern
export const projectKeys = {
  all: ['projects'] as const,
  lists: () => [...projectKeys.all, 'list'] as const,
  list: (ns: string) => [...projectKeys.lists(), ns] as const,
}

// Context with validation hook
const MyContext = createContext<MyContextType | undefined>(undefined)
export function useMyContext() {
  const ctx = useContext(MyContext)
  if (!ctx) throw new Error('useMyContext must be within MyProvider')
  return ctx
}

Testing

import { renderWithProviders } from '@/test/utils'
import { screen } from '@testing-library/react'

test('renders component', () => {
  renderWithProviders(<MyComponent />)
  expect(screen.getByText('Hello')).toBeInTheDocument()
})