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

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

Скилл для Claude Code объясняет агенту устройство TanStack Store: стор, производные значения, батчи и эффекты. Описывает общее состояние нескольких компонентов.

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

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

Что делает 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-code

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

~/.claude/skills/tanstack-store/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.

tanstack-store tanstack-skills Скилл по TanStack Store для Claude Code: реактивный стор без привязки к фреймворку с адаптерами для React, Vue, Solid, Angular и Svelte. Помогает агенту писать и обновлять состояние через API Store, Derived, Effect и batch. CX Codex +1 1 900установок tanstack-vue-store-skilld skilld-dev Скилл tanstack-vue-store-skilld для Claude Code направляет агента при разработке стейт-менеджмента на @tanstack/vue-store в проектах на Vue. Подключается при импорте библиотеки и настройке хранилищ. CX Codex +1 100установок tanstack-vue-virtual-skilld skilld-dev Скилл tanstack-vue-virtual-skilld помогает писать, проверять и отлаживать виртуализированные списки и сетки во Vue с @tanstack/vue-virtual. Пригодится и для лент чата с прокруткой к концу. CX Codex +1 129установок tanstack-integration-best-practices DeckardGer Скилл tanstack-integration-best-practices для Claude Code задаёт правила стыковки TanStack Query, Router и Start. Описывает потоки данных, SSR с гидратацией и согласование кэша. CX Codex +1 3 100установок clerk-tanstack-patterns clerk Скилл clerk-tanstack-patterns для Claude Code подсказывает, как настроить авторизацию Clerk в TanStack React Start. Активируется при работе с createServerFn, защитой маршрутов через beforeLoad и middleware. CX Codex +1 16 400установок tanstack-start tanstack-skills Скилл помогает создавать и сопровождать приложения на фреймворке TanStack Start с потоковым SSR, серверными функциями и маршрутизацией. CX Codex +1 4 000установок tanstack-pacer tanstack-skills Скилл tanstack-pacer для Claude Code помогает выбирать и применять утилиты управления вызовами функций. Он включается при задачах с задержкой, ограничением частоты, очередями или пакетной обработкой. CX Codex +1 3 900установок

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

Весь набор →
tanstack-cli Скилл tanstack-cli настраивает сборку библиотек через TanStack Config и Vite с генерацией типов и релизом через conventional commits. CX Codex +1 115установок better-auth Подгружает агенту справочник по better-auth: конфиг, плагины, стратегии сессий и типовые ошибки. Даёт справку при настройке входа, 2FA и организаций. CX Codex +1 114установок meta-skill-creator Скилл meta-skill-creator помогает создавать и проверять агентские скиллы по открытому стандарту Agent Skills. Он пригодится при подготовке SKILL.md, структуры папок и файлов для распространения. CX Codex +1 114установок figma-developer Скилл figma-developer для Claude Code получает из Figma цвета, шрифты и иконки через REST API и собирает CSS-переменные и React-компоненты. Автоматизирует перенос изменений макета в код. CX Codex +1 114установок hono Скилл по веб-фреймворку Hono для создания API и edge-функций на Cloudflare Workers, Bun, Deno и Node.js. CX Codex +1 112установок astro Скилл Claude Code объясняет агенту Astro: коллекции контента, островную гидратацию, view transitions и режимы рендеринга. Описывает статичные сайты с вкраплениями интерактива. CX Codex +1 111установок db-enforcer Скилл db-enforcer для Claude Code проверяет целостность PostgreSQL-схем и согласованность с Prisma. Включается при проектировании схем, подготовке миграций и настройке RLS. CX Codex +1 109установок electricsql Скилл для ИИ-кодинга по ElectricSQL: как стримить строки Postgres в клиент через Shapes, фильтровать их и не пускать запись мимо своего API. CX Codex +1 109установок

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

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