zustand · oakoss — скилл для Claude Code: что делает и как установить
Скилл помогает настроить Zustand v5 в React: от типизированных хранилищ и middleware до SSR, тестов и миграции с Redux или Context.
MIT 158 установок ★ 29 обновлён 2026-08-17
npx skills add oakoss/agent-skills --skill zustand -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/zustand/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/zustand/
1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill zustand -a codex2Вручную: положить файлы
.agents/skills/zustand/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill zustand -a cursor2Вручную: положить файлы
.cursor/skills/zustand/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install oakoss/agent-skills skills/zustand2Вручную: положить файлы
.github/skills/zustand/SKILL.md1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill zustand -a gemini-cli2Командой платформы
gemini skills install https://github.com/oakoss/agent-skills --path skills/zustandВручную: положить файлы
.devin/skills/zustand/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill zustand -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.