tanstack-store · oakoss — скилл для Claude Code: что делает и как установить
Скилл для Claude Code объясняет агенту устройство TanStack Store: стор, производные значения, батчи и эффекты. Описывает общее состояние нескольких компонентов.
MIT 113 установок ★ 29 обновлён 2026-08-17
npx skills add oakoss/agent-skills --skill tanstack-store -a claude-codeЧто делает tanstack-store
Скилл — это справочник по @tanstack/store для агента: таблица паттернов (new Store, setState, subscribe, new Derived, batch, new Effect) и список типичных ошибок, где рядом с каждой стоит правильный вариант. Агент открывает его, когда в задаче всплывает общее состояние, производные вычисления или группировка обновлений.
Сам скилл — это SKILL.md с сигнатурами и правилами, без генераторов кода. Отдельный раздел отдаёт смежные задачи другим скиллам: серверное состояние и кеш уходят к tanstack-query, формы к tanstack-form; если их нет, агент предложит доставить их через npx skills add.
Производное значение не начнёт отслеживать зависимости, пока не вызван mount(), а незакрытая подписка на Derived или Effect останется висеть после размонтирования. В React берите @tanstack/react-store: адаптер реэкспортирует Store, Derived, Effect и batch, поэтому ядро отдельно ставить не нужно.
Какие задачи решает
- Завести общий стор и обновлять его без мутаций
- Посчитать производное значение сразу из нескольких сторов
- Схлопнуть пачку обновлений в одно уведомление подписчиков
- Повесить побочный эффект на изменение зависимости
- Выбрать пакет-адаптер под React, Vue или Svelte
Примеры запросов агенту
- Сделай общий стор на
@tanstack/storeдля корзины и производное значение с итоговой суммой. - В обработчике три
setStateподряд — перепиши черезbatch, чтобы подписчики срабатывали один раз. derived.stateне обновляется после изменения стора. Посмотри код и скажи, чего не хватает сmount().
Как установить tanstack-store
1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill tanstack-store -a claude-code2Вручную: положить файлы
~/.claude/skills/tanstack-store/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/tanstack-store/
1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill tanstack-store -a codex2Вручную: положить файлы
.agents/skills/tanstack-store/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill tanstack-store -a cursor2Вручную: положить файлы
.cursor/skills/tanstack-store/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install oakoss/agent-skills skills/tanstack-store2Вручную: положить файлы
.github/skills/tanstack-store/SKILL.md1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill tanstack-store -a gemini-cli2Командой платформы
gemini skills install https://github.com/oakoss/agent-skills --path skills/tanstack-storeВручную: положить файлы
.devin/skills/tanstack-store/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill tanstack-store -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о tanstack-store
Как установить tanstack-store в Claude Code?
Запустите npx skills add oakoss/agent-skills --skill tanstack-store -a claude-code. Файл скилла появится в ~/.claude/skills/tanstack-store/SKILL.md.
Что делает tanstack-store?
Даёт агенту готовую шпаргалку по API TanStack Store: создание стора, подписка, производные значения, эффекты и батчинг. Плюс разбор частых ошибок вроде чтения derived.state без монтирования.
Нужно ли ставить ядро вместе с пакетом-адаптером?
Нет. Пакеты для React, Vue, Solid, Angular и Svelte реэкспортируют Store, Derived, Effect и batch, так что хватает одного адаптера.
Исходный текст
SKILL.md · MIT
---
name: tanstack-store
description: 'TanStack Store for framework-agnostic reactive state management with derived state and batching. Use when managing shared state, creating derived computations, or building framework-agnostic state logic. Use for tanstack-store, store, state, derived, batch, subscribe, reactive-state.'
license: MIT
metadata:
author: oakoss
version: '1.1'
source: 'https://tanstack.com/store/latest'
user-invocable: false
---
# TanStack Store
## Overview
TanStack Store is a lightweight, framework-agnostic reactive state management library with type-safe updates, derived computations, batched mutations, and effect management. It powers the core of TanStack libraries internally and can be used as a standalone state solution. Framework adapters are available for React, Vue, Solid, Angular, and Svelte.
**Core primitives:**
- **Store** — reactive container with `setState`, subscriptions, and lifecycle hooks
- **Derived** — lazily computed values that track Store/Derived dependencies
- **Effect** — side-effect runner triggered by dependency changes
- **batch** — groups multiple updates so subscribers fire once
**When to use:** Shared reactive state across components, derived/computed values from multiple stores, batched state updates, framework-agnostic state logic reusable across React/Vue/Solid/Angular/Svelte, lightweight alternative to Redux/Zustand/MobX.
**When NOT to use:** Server state and caching (TanStack Query), complex normalized state with middleware (Redux Toolkit), form state management (TanStack Form), simple component-local state (useState/useSignal).
**Key characteristics:**
- Tiny bundle size with zero dependencies
- Immutable update model (always return new references from `setState`)
- Lazy evaluation for Derived values (recompute only when accessed after change)
- Explicit mount/unmount lifecycle for Derived and Effect (no automatic cleanup)
## Installation
| Package | Use Case |
| ------------------------- | ------------------------------- |
| `@tanstack/store` | Framework-agnostic core |
| `@tanstack/react-store` | React adapter (re-exports core) |
| `@tanstack/vue-store` | Vue adapter |
| `@tanstack/solid-store` | Solid adapter |
| `@tanstack/angular-store` | Angular adapter |
| `@tanstack/svelte-store` | Svelte adapter |
Framework packages re-export the core `Store`, `Derived`, `Effect`, and `batch` — install only the framework package, not both.
## Quick Reference
| Pattern | API | Key Points |
| -------------------- | ------------------------------------ | -------------------------------------------------- |
| Create store | `new Store(initialState, options?)` | Generic over `TState` and `TUpdater` |
| Read state | `store.state` | Synchronous property access |
| Previous state | `store.prevState` | Value before last `setState` call |
| Update state | `store.setState((prev) => newState)` | Accepts updater function or direct value |
| Subscribe | `store.subscribe(listener)` | Returns unsubscribe function |
| Derived value | `new Derived({ deps, fn })` | Lazily recomputes when dependencies change |
| Mount derived | `derived.mount()` | Required to activate dependency tracking |
| Derived from derived | Nest `Derived` in another `deps` | Forms a computation graph |
| Batch updates | `batch(() => { ... })` | Subscribers notified once after all updates |
| Side effects | `new Effect({ deps, fn, eager? })` | Runs fn when dependencies change |
| Mount effect | `effect.mount()` | Required to start listening |
| React binding | `useStore(store, selector?)` | Re-renders only when selected value changes |
| Shallow compare | `useStore(store, selector, shallow)` | Prevents re-renders for structurally equal objects |
| Lifecycle: subscribe | `onSubscribe` option | Fires on first subscriber, cleanup on last |
| Lifecycle: update | `onUpdate` option | Fires after every state change |
| Custom updater | `updateFn` option | Replace default setState behavior |
| Previous deps | `fn: ({ prevDepVals })` | Compare current vs previous dependency values |
| Dep vals access | `fn: ({ currDepVals })` | Array ordered by `deps` declaration order |
## Common Mistakes
| Mistake | Correct Pattern |
| ------------------------------------------------- | --------------------------------------------------------------------- |
| Reading `derived.state` without mounting | Call `derived.mount()` before accessing state |
| Forgetting to unmount derived/effect | Store the cleanup function and call it on teardown |
| Multiple `setState` calls without batching | Wrap related updates in `batch()` to avoid intermediate recomputation |
| Selecting objects in `useStore` without `shallow` | Pass `shallow` as third argument to prevent unnecessary re-renders |
| Mutating state object directly | Always return a new object from `setState` updater |
| Subscribing inside render without cleanup | Use `useStore` hook in React instead of manual `subscribe` |
| Creating stores inside React components | Instantiate stores outside components or in a ref/useState |
| Not including all deps in Derived | List every Store/Derived dependency in the `deps` array |
| Mounting Derived deps after the parent | Mount leaf dependencies before parent Derived values |
| Using `@tanstack/store` with React directly | Install `@tanstack/react-store` which re-exports core |
## Delegation
- **Server state and caching**: Delegate to the `tanstack-query` skill if available. Otherwise, recommend: `npx skills add oakoss/agent-skills --skill tanstack-query`
- **React component patterns**: Delegate to framework-specific skills for component architecture
- **Form state management**: Delegate to the `tanstack-form` skill if available. Otherwise, recommend: `npx skills add oakoss/agent-skills --skill tanstack-form`
- **Query pattern discovery**: Use `Explore` agent to find examples in the codebase
- **Code review**: Delegate to `code-reviewer` agent for store architecture review
## References
- [Core concepts: Store, setState, subscriptions, and lifecycle hooks](references/core-concepts.md)
- [Derived state: computed values, dependency tracking, and batching](references/derived-state.md)
- [React integration: useStore hook, selectors, and performance](references/react-integration.md)
© oakoss · MIT · oakoss/agent-skills
Похожие скиллы
Все скиллы по теме «Фронтенд и UI» →Сначала — tanstack-store от других авторов.