zustand-state — скилл для Claude Code: управление состоянием без Redux
Скилл zustand-state для Claude Code помогает создавать хранилища Zustand, выбирать данные селекторами, сохранять их в localStorage и подключать devtools.
Apache-2.0 261 установок ★ 89 обновлён 2026-09-15
npx skills add existential-birds/beagle --skill zustand-state -a claude-codeЧто делает zustand-state
Zustand минимализирует код: нет провайдеров, нет обёрток, состояние создаётся одной функцией create(). Селекторы позволяют компонентам подписываться только на нужные части хранилища, что снижает количество перерендеров. Скилл включает примеры плоских обновлений, работы с вложенными объектами и доступа к состоянию вне React-компонентов через getState() и subscribe().
Для производительности используй useShallow при выборе нескольких значений — это предотвращает ненужные перерендеры при неглубоких изменениях. Vanilla-магазин createStore работает без React, что пригодится в скриптах и утилитах.
Перед мёржем кода с persist убедись, что ключи хранилища явные и в localStorage не попадают токены или API-ключи. Если используешь devtools в боевой сборке, оставь одну строку комментария в PR, объясняя почему.
Какие задачи решает
- создать глобальное хранилище состояния без провайдеров
- оптимизировать перерендеры компонентов через селекторы
- сохранить состояние в localStorage с persist-middleware
- отладить изменения состояния через DevTools
- управлять состоянием вне React-компонентов
Примеры запросов агенту
- Создай хранилище для счётчика с методом increase, подпиши компонент только на bears
- Обнови вложенное состояние без Redux-like боёплейтов
- Добавь localStorage-синхронизацию с persist-middleware
Как установить zustand-state
1Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill zustand-state -a claude-code2Вручную: положить файлы
~/.claude/skills/zustand-state/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/zustand-state/
1Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill zustand-state -a codex2Вручную: положить файлы
.agents/skills/zustand-state/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill zustand-state -a cursor2Вручную: положить файлы
.cursor/skills/zustand-state/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install existential-birds/beagle plugins/beagle-react/skills/zustand-state2Вручную: положить файлы
.github/skills/zustand-state/SKILL.md1Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill zustand-state -a gemini-cli2Командой платформы
gemini skills install https://github.com/existential-birds/beagle --path plugins/beagle-react/skills/zustand-stateВручную: положить файлы
.devin/skills/zustand-state/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill zustand-state -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о zustand-state
Как установить zustand-state в Claude Code?
Выполни npx skills add existential-birds/beagle --skill zustand-state -a claude-code, затем отвори ~/.claude/skills/zustand-state/SKILL.md.
Что делает zustand-state?
Скилл предоставляет примеры и шаблоны для Zustand — библиотеки управления состоянием. Показывает, как создавать хранилища, писать селекторы, оптимизировать перерендеры и подключать middleware для persistence и отладки.
Чем Zustand отличается от Redux?
Zustand не требует провайдеров и редюсеров — состояние инициализируется одной функцией. Обновления проще, бойлерплейта меньше, но для очень больших приложений с чётко разделённой логикой Redux может быть яснее структурно.
Исходный текст
SKILL.md · Apache-2.0
---
name: zustand-state
description: Zustand state management for React and vanilla JavaScript. Use when creating stores, using selectors, persisting state to localStorage, integrating devtools, or managing global state without Redux complexity. Triggers on zustand, create(), createStore, useStore, persist, devtools, immer middleware.
---
# Zustand State Management
Minimal state management - no providers, minimal boilerplate.
## Quick Reference
```typescript
import { create } from 'zustand'
interface BearState {
bears: number
increase: (by: number) => void
}
const useBearStore = create<BearState>()((set) => ({
bears: 0,
increase: (by) => set((state) => ({ bears: state.bears + by })),
}))
// In component - select only what you need
const bears = useBearStore((state) => state.bears)
const increase = useBearStore((state) => state.increase)
```
## State Updates
```typescript
// Flat updates (auto-merged at one level)
set({ bears: 5 })
set((state) => ({ bears: state.bears + 1 }))
// Nested objects (manual spread required)
set((state) => ({
nested: { ...state.nested, count: state.nested.count + 1 }
}))
// Replace entire state (no merge)
set({ bears: 0 }, true)
```
## Selectors & Performance
```typescript
// Good - subscribes only to bears
const bears = useBearStore((state) => state.bears)
// Bad - rerenders on any change
const state = useBearStore()
// Multiple values with useShallow (prevents rerenders with shallow comparison)
import { useShallow } from 'zustand/react/shallow'
const { bears, fish } = useBearStore(
useShallow((state) => ({ bears: state.bears, fish: state.fish }))
)
// Array destructuring also works
const [bears, fish] = useBearStore(
useShallow((state) => [state.bears, state.fish])
)
```
## Access Outside Components
```typescript
// Get current state (non-reactive)
const state = useBearStore.getState()
// Update state
useBearStore.setState({ bears: 5 })
// Subscribe to changes
const unsub = useBearStore.subscribe((state) => console.log(state))
unsub() // unsubscribe
```
## Vanilla Store (No React)
```typescript
import { createStore } from 'zustand/vanilla'
const store = createStore((set) => ({
bears: 0,
increase: (by) => set((state) => ({ bears: state.bears + by })),
}))
store.getState().bears
store.setState({ bears: 10 })
store.subscribe((state) => console.log(state))
```
## Additional Documentation
- **Middleware**: See [references/middleware.md](references/middleware.md) for persist, devtools, immer
- **Patterns**: See [references/patterns.md](references/patterns.md) for slices, testing, best practices
- **TypeScript**: See [references/typescript.md](references/typescript.md) for advanced typing patterns
## Key Patterns
| Pattern | When to Use |
|---------|-------------|
| Single selector | One piece of state needed |
| `useShallow` | Multiple values, avoid rerenders |
| `getState()` | Outside React, event handlers |
| `subscribe()` | External systems, logging |
| Vanilla store | Non-React environments |
## Gates (persist and devtools)
Before merging code that uses these middlewares (see [references/middleware.md](references/middleware.md) for setup):
1. **`persist`** — **Pass when** persisted keys are explicit (`partialize` or a reviewed full-state snapshot) and the JSON written to storage cannot include auth tokens, API keys, or other secrets.
2. **`devtools` in shipped bundles** — **Pass when** DevTools runs only in development (env gate), or you leave a one-line note in the PR explaining why it stays enabled in production.
© existential-birds · Apache-2.0 · existential-birds/beagle