К основному содержанию
скилл CX Codex

react-state-machine — скилл для Claude Code: возможности и установка

Скилл react-state-machine для Claude Code помогает проектировать React-машины состояний на XState v5. Он разбирает сложные асинхронные сценарии, многошаговые формы и логику интерфейса с множеством флагов.

MIT 201 установок ★ 80 обновлён 2026-07-18

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add bobmatnyc/claude-mpm-skills --skill react-state-machine -a claude-code
Открыть на GitHub

Что делает react-state-machine

Скилл помогает описывать поведение React-интерфейса через состояния, события и переходы с помощью XState v5 и модели акторов. Он предлагает типобезопасные схемы для асинхронных процессов, например загрузки данных с обработкой ошибки и повтором запроса. Для простого состояния компонента рассматривается useMachine, а для выборочных перерисовок — связка useActorRef и useSelector.

В материалах также разобраны тестирование через createActor, подключение общего состояния через React Context и визуализация в Stately Studio. Скилл пригодится при проектировании многошаговых форм, анимации модальных окон и медиаплееров. Для простого переключателя без асинхронной логики исходник рекомендует useState; для кэширования серверных данных — React Query или TanStack Query.

Какие задачи решает

  • описать состояния и переходы асинхронного интерфейса
  • заменить разрозненные флаги загрузки и ошибки одной машиной
  • спроектировать логику многошаговой формы
  • подключить выборочные обновления React-компонента

Примеры запросов агенту

  • Спроектируй машину состояний XState v5 для загрузки данных с ошибкой и повторным запросом.
  • Помоги заменить флаги загрузки и ошибки в React на машину состояний.
  • Покажи, как подключить машину состояний к многошаговой форме и протестировать её через createActor.

Как установить react-state-machine

1Через Skills CLI (Vercel)

npx skills add bobmatnyc/claude-mpm-skills --skill react-state-machine -a claude-code

2Вручную: положить файлы

~/.claude/skills/react-state-machine/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/react-state-machine/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о react-state-machine

Как установить react-state-machine в Claude Code?

Выполни npx skills add bobmatnyc/claude-mpm-skills --skill react-state-machine -a claude-code. Файл скилла находится по пути ~/.claude/skills/react-state-machine/SKILL.md.

Что делает react-state-machine?

Скилл помогает строить React-машины состояний на XState v5: описывать события и переходы, подключать акторы и выбирать подходящий способ интеграции с React.

Когда для React лучше выбрать машину состояний, а не useState?

Машины состояний рассматриваются для сложных асинхронных процессов, многошаговых форм и ситуаций с множеством флагов. Для простого переключателя без асинхронной логики скилл рекомендует useState.

Исходный текст

SKILL.md · MIT
---
name: react-state-machine
description: "Building reusable React state machine skills with XState v5 and the actor model"
user-invocable: false
disable-model-invocation: true
version: 1.0.1
category: development
author: Claude MPM Team
license: MIT
progressive_disclosure:
  entry_point:
    summary: "Build type-safe, visualizable React state machines using XState v5's actor model for predictable UI behavior"
    when_to_use: "Complex async flows, multi-step forms, modal animations, media players, boolean flag explosion, defensive coding patterns"
    quick_start: "1. Define states/events with setup() 2. Use promise actors for async 3. useMachine for simple, useActorRef+useSelector for performance 4. Test with createActor 5. Visualize in Stately Studio"
  references:
    - xstate-v5-patterns.md
    - react-integration.md
    - skills-architecture.md
    - testing-patterns.md
    - decision-trees.md
    - real-world-patterns.md
    - error-handling.md
    - performance.md
    - persistence-hydration.md
    - migration-guide.md
    - composition-patterns.md
context_limit: 700
tags:
  - react
  - state-machine
  - xstate
  - actors
  - async
  - forms
  - ui-logic
requires_tools: []
---

# React State Machines with XState v5

## Overview

State machines make impossible states unrepresentable by modeling UI behavior as explicit states, transitions, and events. XState v5 (2.5M+ weekly npm downloads) unifies state machines with the actor model—every machine is an independent entity with its own lifecycle, enabling sophisticated composition patterns.

## When to Use This Skill

**Trigger patterns:**
- Boolean flag explosion: multiple `isLoading`, `isError`, `isSuccess` flags
- Implicit states: writing `if (isLoading && !isError && data)` to derive mode
- Defensive coding: guards before state updates to prevent invalid transitions
- Timing coordination: timeouts, delays, debouncing across states
- State dependencies: one state depends on another to update correctly

**Do not use for:**
- Simple boolean toggles with no async (useState is simpler)
- Single form fields with basic validation (useReducer suffices)
- Server state caching (React Query/TanStack Query handles this)
- Static data transformations (useMemo is better)
- Simple counters or toggles (useState is clearer)

**See decision-trees.md for comprehensive decision guidance**

## Core Mental Model

**Finite states** represent modes of behavior: `idle`, `loading`, `success`, `error`. A component can only be in ONE state at a time.

**Context (extended state)** stores quantitative data that doesn't define distinct states. The finite state says "playing"; context says *what* at *what volume*.

**Events** trigger transitions between states. Events are objects: `{ type: 'SUBMIT', data: formData }`.

**Guards** conditionally allow/block transitions: `{ guard: 'hasValidInput' }`.

**Actions** are fire-and-forget side effects during transitions or state entry/exit.

**Invoked actors** are long-running processes (API calls, subscriptions) with lifecycle management and cleanup.

## Quick Start: XState v5 setup() Pattern

```typescript
import { setup, assign, fromPromise } from 'xstate';

const fetchMachine = setup({
  types: {
    context: {} as { data: User | null; error: string | null },
    events: {} as 
      | { type: 'FETCH'; userId: string }
      | { type: 'RETRY' }
  },
  actors: {
    fetchUser: fromPromise(async ({ input, signal }) => {
      const res = await fetch(`/api/users/${input.userId}`, { signal });
      if (!res.ok) throw new Error(res.statusText);
      return res.json();
    })
  },
  actions: {
    setData: assign({ data: ({ event }) => event.output }),
    setError: assign({ error: ({ event }) => event.error.message })
  }
}).createMachine({
  id: 'fetch',
  initial: 'idle',
  context: { data: null, error: null },
  states: {
    idle: { on: { FETCH: 'loading' } },
    loading: {
      invoke: {
        src: 'fetchUser',
        input: ({ event }) => ({ userId: event.userId }),
        onDone: { target: 'success', actions: 'setData' },
        onError: { target: 'failure', actions: 'setError' }
      }
    },
    success: { on: { FETCH: 'loading' } },
    failure: { on: { RETRY: 'loading' } }
  }
});
```

## React Integration Decision Tree

| Use Case | Hook | Why |
|----------|------|-----|
| Simple component state | `useMachine` | Straightforward, re-renders on all changes |
| Performance-critical | `useActorRef` + `useSelector` | Selective re-renders only |
| Global/shared state | `createActorContext` | React Context integration |

**Basic pattern:**
```typescript
import { useMachine } from '@xstate/react';

function Toggle() {
  const [snapshot, send] = useMachine(toggleMachine);
  return (
    <button onClick={() => send({ type: 'TOGGLE' })}>
      {snapshot.matches('inactive') ? 'Off' : 'On'}
    </button>
  );
}
```

**Performance pattern:**
```typescript
import { useActorRef, useSelector } from '@xstate/react';

const selectCount = (s) => s.context.count;
const selectLoading = (s) => s.matches('loading');

function Counter() {
  const actorRef = useActorRef(counterMachine);
  const count = useSelector(actorRef, selectCount);
  const loading = useSelector(actorRef, selectLoading);
  // Only re-renders when count or loading changes
}
```

## Anti-Patterns to Avoid

❌ **State explosion**: Flat states for orthogonal concerns. Use parallel states instead.

❌ **Sending events from actions**: Never `send()` inside `assign`. Use `raise` for internal events.

❌ **Impure guards**: Guards must be pure—no side effects, no external mutations.

❌ **Subscribing to entire state**: Use focused selectors with `useSelector`.

❌ **Not memoizing model**:
```typescript
// WRONG
const model = Model.fromJson(layout);  // New model every render

// CORRECT
const modelRef = useRef(Model.fromJson(layout));
```

## Navigation to References

### Core Patterns
- **xstate-v5-patterns.md**: Complete v5 API, statecharts (hierarchy/parallel/history), promise actors
- **react-integration.md**: useMachine vs useActorRef, Context patterns, side effect handling
- **testing-patterns.md**: Unit testing, mocking actors, visualization debugging

### Decision Making & Best Practices
- **decision-trees.md**: When to use state machines vs useState/useReducer/React Query, machine splitting strategies
- **real-world-patterns.md**: Complete examples - auth flows, file uploads, wizards, undo/redo, shopping carts
- **error-handling.md**: Error boundaries, retry strategies, circuit breakers, graceful degradation
- **performance.md**: Selector memoization, React.memo integration, machine splitting for performance

### Advanced Topics
- **persistence-hydration.md**: localStorage persistence, SSR/Next.js hydration, snapshot serialization
- **migration-guide.md**: Step-by-step migration from useState/useReducer with before/after examples
- **composition-patterns.md**: Actor communication, machine composition, higher-order machines, systemId
- **skills-architecture.md**: Input/output parameterization, library structure

## Key Reminders

1. **setup() is the v5 way**: Strong TypeScript inference, actor registration, action definitions
2. **Invoke for async, actions for sync**: Actions are fire-and-forget; invoked actors have lifecycle
3. **Finite states for modes, context for data**: Don't create states for every data variation
4. **Visualize first**: Stately Studio (stately.ai/editor) makes machines living documentation

## Red Flags

- More than 3-4 boolean flags → Need state machine
- Writing `if (a && !b && c)` to determine mode → States should be explicit
- Bugs from invalid state combinations → Machine prevents impossible states
- Can't explain state transitions to stakeholders → Visualization solves this

## Related Skills

- **react**: Parent skill for React patterns
- **nextjs**: Server/client state coordination
- **test-driven-development**: Test machines with createActor before UI integration

© Claude MPM Team · MIT · bobmatnyc/claude-mpm-skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
state-machine Owl-Listener Скилл state-machine для Claude Code помогает спроектировать поведение интерфейса через конечные автоматы: состояния, переходы, события и гарды. Исключает невозможные комбинации вроде одновременного показа загрузки и ошибки. CX Codex +1 2 600установок godot-state-machine-advanced thedivergentai Скилл godot-state-machine-advanced для иерархических конечных автоматов и pushdown-автоматов в Godot: готовые скрипты для вложенных состояний, стеков и валидации переходов. CX Codex +1 573установок react-state-management Seth Hobson Скилл react-state-management помогает выбрать и настроить управление состоянием в React: локальное, глобальное, серверное, URL и состояние форм. CX Codex +1 15 286установок state-ux-flow-builder patricio0312rev Скилл state-ux-flow-builder помогает собрать единые состояния загрузки, ошибки, пустого результата и успеха для экранов с данными. Пригодится при проектировании сложных UI-переходов. CX Codex +1 264установок syncfusion-react-query-builder Syncfusion Inc Скилл syncfusion-react-query-builder помогает внедрить визуальный конструктор фильтров Syncfusion в React-приложения. Генерирует интерфейсы правил и переводит условия в SQL или Mongo. CX Codex +1 739установок react-hook-form-zod ovachiever Скилл react-hook-form-zod учит агента собирать формы на React Hook Form с валидацией через Zod. Одна схема работает и на клиенте, и на сервере. CX Codex +1 725установок

Из того же набора143

Весь набор →
nextjs Раскладывает переменные окружения Next.js по файлам .env* и объясняет, какое значение победит при запуске, сборке и деплое. CX Codex +1 212установок tauri Описывает паттерны событий Tauri: двустороннюю коммуникацию, потоки данных и обмен сообщениями между окнами. Показывает работу с real-time обновлениями в настольных приложениях. CX Codex +1 210установок react-advanced Скилл react-advanced для Claude Code задаёт правила работы с React 19: внедрение React Compiler, Actions, конкурентный рендеринг и отказ от лишнего useMemo. CX Codex +1 209установок react-hooks-composition Скилл react-hooks-composition для Claude Code помогает собирать React-хуки для загрузки данных, поиска с задержкой и контекстов. Связывает состояние интерфейса с запросами к API. CX Codex +1 206установок code-quality-scoring Скилл code-quality-scoring для Claude Code оценивает здоровье кодовой базы, техдолг и готовность к облаку. Оценивает проект целиком перед рефакторингом. CX Codex +1 206установок anthropic Справочник по официальному Anthropic SDK: сообщения, стриминг, вызов функций и изображения. Описывает встраивание Claude в приложение. CX Codex +1 204установок espocrm Скилл по разработке под EspoCRM. Следит за метаданными, сервисами и хуками, чтобы агент не ломал архитектуру платформы. CX Codex +1 202установок code-production-process Скилл code-production-process для Claude Code запускает шестиступенчатый контроль качества при нетривиальных изменениях: более 50 строк кода или несколько исходных файлов. CX Codex +1 201установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой