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

zustand · oakoss — скилл для Claude Code: что делает и как установить

Скилл помогает настроить Zustand v5 в React: от типизированных хранилищ и middleware до SSR, тестов и миграции с Redux или Context.

MIT 158 установок ★ 29 обновлён 2026-08-17

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

Что делает zustand

Скилл разбирает клиентское глобальное состояние в Zustand v5: типизацию хранилищ, селекторы, middleware persist, devtools, immer и subscribeWithSelector, а также разбиение больших хранилищ на slices. В нём есть рекомендации для SSR и Next.js, vanilla-хранилищ, сброса состояния и тестирования с Vitest и Jest.

Для middleware в TypeScript используется синтаксис с двойными скобками: create<T>()(...). При SSR глобальный singleton может передавать состояние между запросами, поэтому скилл описывает провайдер с createStore и React Context. Zustand рассчитан на React 18 и новее; для createWithEqualityFn нужна peer dependency use-sync-external-store.

Скилл также помогает разбирать проблемы гидратации и переходить с Redux, Context или Zustand v4. Для серверных данных с кэшированием и повторной валидацией он рекомендует TanStack Query, а не Zustand.

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

  • настроить типизированное хранилище Zustand v5 с middleware
  • разбить большое хранилище на slices по доменам
  • устранить лишние перерисовки с помощью селекторов
  • настроить persist и разобраться с гидратацией в Next.js
  • перенести состояние с Redux, Context или Zustand v4

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

  • Настрой типизированное хранилище Zustand v5 для состояния корзины и добавь persist.
  • Раздели большое хранилище приложения на slices и подбери порядок middleware.
  • Разбери проблему гидратации Zustand в Next.js и предложи вариант с createStore и React Context.

Как установить zustand

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill zustand -a claude-code

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

~/.claude/skills/zustand/SKILL.md

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

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

Вопросы о zustand

Как установить zustand в Claude Code?

Выполните npx skills add oakoss/agent-skills --skill zustand -a claude-code. Файл скилла появится по пути ~/.claude/skills/zustand/SKILL.md.

Что делает скилл zustand?

Он подсказывает, как строить хранилища Zustand v5 для React, подключать middleware, работать с SSR и тестировать состояние. Также он охватывает миграцию с Redux, Context и Zustand v4.

Какая версия React нужна для Zustand v5?

Нужен React 18 или новее, поскольку Zustand использует useSyncExternalStore. Если применяется createWithEqualityFn, нужна peer dependency use-sync-external-store.

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

SKILL.md · MIT
---
name: zustand
description: |
  Zustand v5 state management for React. Covers TypeScript stores with double-parentheses syntax, persist middleware with hydration handling, devtools, subscribeWithSelector, slices pattern for large apps, SSR/Next.js provider pattern, immer middleware, auto-generating selectors, testing, and vanilla stores.

  Use when setting up global state, configuring persist middleware, implementing slices pattern, migrating from Redux or Context, testing stores, or troubleshooting hydration and TypeScript issues.
license: MIT
metadata:
  author: oakoss
  version: '1.0'
  source: 'https://zustand.docs.pmnd.rs'
user-invocable: false
---

# Zustand State Management

## Overview

Zustand v5 is a lightweight global state manager for React built on `useSyncExternalStore`. Requires React 18+ (uses `useSyncExternalStore` internally). When using `createWithEqualityFn`, install `use-sync-external-store` as a peer dependency. It provides type-safe stores, atomic selectors for minimal re-renders, composable middleware (persist, devtools, immer, subscribeWithSelector), and a slices pattern for large applications. Use Zustand for client-only global state; use TanStack Query for server-fetched data.

**When to use:** Client-side global state, persistent user preferences, complex multi-domain stores, cross-component state sharing, vanilla (non-React) state management.

**When NOT to use:** Server state with caching needs (use TanStack Query), single-component state (use useState), simple prop drilling scenarios.

## Quick Reference

| Pattern               | API                                     | Key Points                                       |
| --------------------- | --------------------------------------- | ------------------------------------------------ |
| Basic store           | `create<T>()((set) => ({...}))`         | Double parentheses required for TS               |
| Atomic selector       | `useStore(state => state.bears)`        | Only re-renders when selected value changes      |
| Multiple values       | `useShallow(state => ({a, b}))`         | Import from `zustand/react/shallow`              |
| Persist               | `persist(fn, { name })`                 | localStorage with SSR hydration handling         |
| Devtools              | `devtools(fn, { name })`                | Redux DevTools integration                       |
| SubscribeWithSelector | `subscribeWithSelector(fn)`             | Subscribe to state slices outside React          |
| Middleware order      | `devtools(persist(fn))`                 | Outer to inner wrapping                          |
| Slices pattern        | `StateCreator<Combined, [], [], Slice>` | Split store by domain                            |
| SSR provider          | `createStore` + React Context           | Per-request stores prevent data leaks            |
| Immer                 | `immer(fn)`                             | Safe nested state mutations                      |
| Vanilla store         | `createStore` from `zustand/vanilla`    | Use outside React                                |
| Reset store           | `set(store.getInitialState())`          | Use `getInitialState()` for reliable reset       |
| Derived values        | `useStore(s => s.items.length)`         | Compute in selector                              |
| Auto selectors        | `createSelectors(store)`                | Generate `store.use.field()` hooks automatically |

## Common Mistakes

| Mistake                                                                   | Correct Pattern                                                                                   |
| ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| Using `create<T>(...)` with single parentheses                            | Use `create<T>()(...)` double parentheses for correct TypeScript middleware inference             |
| Selecting full state object with `useStore(state => state)`               | Use atomic selectors like `state.bears` or `useShallow` to avoid unnecessary re-renders           |
| Importing `useShallow` from `zustand/shallow`                             | Import from `zustand/react/shallow`; `zustand/shallow` exports the plain `shallow` function only  |
| Creating new object references in selectors causing infinite loops        | Use separate primitive selectors or wrap with `useShallow` from `zustand/react/shallow`           |
| Using a global singleton store with SSR or Next.js                        | Use the `StoreContext` provider pattern with `createStore` to prevent data leaks between requests |
| Tracking initial state manually for reset                                 | Use `store.getInitialState()` which Zustand provides automatically                                |
| Using Zustand for server-fetched data that needs caching and revalidation | Use TanStack Query for server state; reserve Zustand for client-only global state                 |

## Delegation

- **Store architecture and slices design**: Use `Plan` agent to define domain boundaries, slice interfaces, and middleware composition order
- **Hydration and SSR debugging**: Use `Task` agent to diagnose persist middleware issues, hydration mismatches, and Next.js provider setup
- **Migration from v4 to v5**: Use `Explore` agent to find deprecated import paths, single-parentheses patterns, and legacy middleware usage
- **Testing strategy**: Use `Task` agent to set up store mocks and test isolation patterns

## References

- [Store patterns, TypeScript, and core API](references/store-patterns.md)
- [Middleware: persist, devtools, immer, subscribeWithSelector, and custom](references/middleware.md)
- [Slices pattern and large store architecture](references/slices-pattern.md)
- [SSR, Next.js, and hydration handling](references/ssr-hydration.md)
- [Testing stores with Vitest and Jest](references/testing.md)
- [Migration guide: Redux, Context, and v4 to v5](references/migration.md)

© oakoss · MIT · oakoss/agent-skills

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

Все скиллы по теме «Фронтенд и UI» →

Сначала — zustand от других авторов.

zustand vercel-labs Интегрирует Zustand в json-render и синхронизирует состояние приложения. Связывает Zustand-хранилища с компонентами, которые рендерит json-render. CX Codex +1 1 900установок zustand pedronauck Скилл zustand для Claude Code подсказывает, как создавать и организовывать хранилища Zustand. Он подключается к задачам с общим состоянием интерфейса на клиенте. CX Codex +1 369установок zustand pproenca С 43 правилами по Zustand: архитектура сторов, селекторы, предотвращение лишних ре-рендеров. Подключается при написании или рефакторинге стора. CX Codex +1 463установок zustand bobmatnyc По zustand — минимальный стейт-менеджер для React на хуках, без провайдеров и лишнего кода. Ведёт глобальное состояние без Redux. CX Codex +1 503установок zustand-patterns OrchestKit Скилл zustand-patterns для Claude Code помогает проектировать хранилища на Zustand 5.x с типизацией в TypeScript. Подключается при настройке слайсов, селекторов useShallow и цепочек middleware. CX Codex +1 1 500установок zustand-state-management Mindrally Скилл zustand-state-management задаёт правила архитектуры сторов Zustand в React и TypeScript: от нарезки слайсов до SSR и тестов. Помогает избежать лишних ререндеров и ошибок гидратации. CX Codex +1 1 000установок zustand-5 prowler-cloud Скилл с паттернами управления состоянием в Zustand 5: базовые хранилища, селекторы, persist-middleware и разделение логики на слайсы. Помогает писать чистый реактивный код без лишних ре-рендеров. CX Codex +1 912установок zustand-state-builder patricio0312rev Скилл zustand-state-builder для Claude Code управляет состоянием приложения через Zustand: лёгкий API, TypeScript, сохранение в хранилище и devtools. CX Codex +1 264установок zustand-state existential-birds Скилл zustand-state для Claude Code помогает создавать хранилища Zustand, выбирать данные селекторами, сохранять их в localStorage и подключать devtools. CX Codex +1 261установок zustand-store-ts Microsoft Скилл zustand-store-ts для Claude Code и GitHub Copilot, который задаёт шаблон стора Zustand на TypeScript. Включается, когда в React-проекте нужно глобальное состояние с подписками и раздельными state/actions. CX Codex +1 3установок

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

Весь набор →
threejs Помогает создавать 3D-сцены на Three.js, подключать WebGPU и React Three Fiber. Помогает настраивать шейдеры, загружать модели и повышать производительность. CX Codex +1 167установок accessibility Скилл accessibility помогает создавать и проверять интерфейсы по WCAG 2.2 AA: от семантической HTML-разметки до клавиатурной навигации и поддержки скринридеров. CX Codex +1 164установок react-performance Скилл react-performance для Claude Code собирает паттерны оптимизации React и включается автоматически в задачах о скорости приложения. CX Codex +1 163установок design-system Скилл design-system для Claude Code собирает дизайн-систему с токенами, темами и архитектурой компонентов. Задаёт структуру для dark mode, CVA-вариантов и доступности. CX Codex +1 160установок tanstack-start По TanStack Start описывает серверные функции, SSR со стримингом, middleware и деплой. CX Codex +1 156установок pglite Скилл по PGlite: подсказывает агенту, как поднять сборку PostgreSQL 17.4 на WASM в браузере или Node.js, выбрать хранилище и настроить live-запросы. CX Codex +1 156установок tanstack-table Настраивает headless-таблицы TanStack Table v8 в React: серверная пагинация, фильтры и сортировка без циклических ререндеров. CX Codex +1 155установок changesets Скилл changesets помогает вести версии и changelog пакетов в монорепозитории. Он пригодится для согласованных релизов и публикации пакетов в npm. CX Codex +1 154установок

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

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