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

tanstack-vue-store-skilld — скилл для Claude Code

Скилл tanstack-vue-store-skilld для Claude Code направляет агента при разработке стейт-менеджмента на @tanstack/vue-store в проектах на Vue. Подключается при импорте библиотеки и настройке хранилищ.

MIT 100 установок ★ 186 обновлён 2026-10-10

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

Что делает tanstack-vue-store-skilld

Скилл задаёт правила интеграции @tanstack/vue-store версии 0.11.1 и ядра @tanstack/store. Он объясняет агенту работу хуков useSelector, useAtom и экспериментального кортежа _useStore, а также запрещает вызывать устаревший useStore в новом коде.

Основное внимание уделено предотвращению лишних ререндеров. По умолчанию useSelector сравнивает значения через строгое равенство ===, поэтому при возврате нового объекта или массива из селектора агент обязан передавать опцию { compare: shallow }. Вызовы хуков должны оставаться строго внутри setup или области эффекта, иначе отписка через onScopeDispose не сработает.

Для работы требуется Vue 3 или Vue 2.5+ с установленным пакетом @vue/composition-api. Скилл также предостерегает от импорта несуществующего метода createStoreContext, который упоминался в релизе 0.11.0, но отсутствует в сборке 0.11.1.

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

  • настроить подписку на срезы стейта через хук useSelector
  • организовать атомарное состояние с помощью createAtom и useAtom
  • предотвратить лишние ререндеры объектов передачей функции shallow
  • перевести устаревшие вызовы useStore на актуальный API версии 0.11

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

  • Создай глобальное хранилище на @tanstack/vue-store и подключи срез данных в компоненте через useSelector
  • Сделай атомарный счётчик с помощью createAtom и вызови useAtom внутри script setup
  • Обнови старый компонент с useStore на useSelector с проверкой через shallow

Как установить tanstack-vue-store-skilld

1Через Skills CLI (Vercel)

npx skills add skilld-dev/vue-ecosystem-skills --skill tanstack-vue-store-skilld -a claude-code

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

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

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

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

Вопросы о tanstack-vue-store-skilld

Как установить tanstack-vue-store-skilld в Claude Code?

Выполните команду npx skills add skilld-dev/vue-ecosystem-skills --skill tanstack-vue-store-skilld -a claude-code в терминале.

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

Он обучает ИИ-агента правильным паттернам библиотеки @tanstack/vue-store, управлению подписками, работе с селекторами и безопасной очистке ресурсов.

Какие зависимости нужны для работы библиотеки?

Требуется Vue версии ^3.0.0 либо ^2.5.0 в связке с @vue/composition-api@^1.2.1. Ядро @tanstack/store уже реэкспортируется адаптером и не требует отдельной установки.

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

SKILL.md · MIT
---
name: tanstack-vue-store-skilld
description: "Vue adapter for TanStack Store, a framework agnostic type-safe store. ALWAYS use when writing code importing \"@tanstack/vue-store\" in a Vue app. Covers the useSelector, useAtom, useStore (deprecated), and _useStore hooks, the re-exported @tanstack/store core API (createStore, createAtom, createAsyncAtom, batch, flush, shallow), debugging, best practices, and migration between @tanstack/vue-store versions."
license: MIT
---

# @tanstack/[email protected]

Vue adapter for TanStack Store. Exact core dependency: `@tanstack/[email protected]` (package.json:41). `src/index.ts:1` re-exports the whole core, so Vue apps import everything from `@tanstack/vue-store` alone.

## Quick start

```ts
import { createStore, createAtom, shallow, useAtom, useSelector } from '@tanstack/vue-store'

// Module scope: create once, import anywhere
const counter = createStore({ count: 0 })
const countAtom = createAtom(0)

// Inside <script setup>
const count = useSelector(counter, (s) => s.count)                             // slice
const pair = useSelector(counter, (s) => ({ n: s.count }), { compare: shallow }) // object slice
const [n, setN] = useAtom(countAtom)                                           // read + write
setN((prev) => prev + 1)
```

Read refs in templates as `{{ count }}`, in script as `count.value`.

## Hooks (this package's own exports)

| Hook | Signature | Use |
|---|---|---|
| `useSelector` | `(source, selector?, options?) => Readonly<Ref<TSelected>>` | Primary read hook. Store, atom, or any `{ get, subscribe }` source. Omit the selector to subscribe to the whole value. |
| `useAtom` | `(atom, options?) => [Readonly<Ref<TValue>>, atom.set]` | Read plus write for one writable atom. The setter takes a value or an updater function (`src/useAtom.ts:20-27`). |
| `_useStore` | `(store, selector, options?) => [selected, actions or setState]` | Experimental read+write tuple. The selector argument is required (`src/_useStore.ts:30`). Returns `store.actions` when the store has an actions factory, else `store.setState` (`src/_useStore.ts:37-38`). |
| `useStore` | deprecated | Alias for `useSelector`. Third argument is a bare `compare` function, not an options object (`src/useStore.ts:14-23`). Prefer `useSelector`. |

`options` is `UseSelectorOptions`: `{ compare?: (a, b) => boolean }` (`src/useSelector.ts:4-6`).

Details, behavior notes, and pitfalls: [Vue hooks reference](./references/vue-hooks.md)

## Rules that prevent bugs

- Default compare is strict `===` (`src/useSelector.ts:15-17`). When the selector builds a fresh object or array, pass `{ compare: shallow }` or the ref updates on every notification. Primitive selectors need no custom compare.
- Call the hooks inside component setup or another effect scope. `useSelector` unsubscribes via `onScopeDispose` (`src/useSelector.ts:54-56`); outside a scope, cleanup never runs.
- Returned refs are `readonly`. Write through `store.setState`, `atom.set`, store `actions`, or the second tuple element of `useAtom`/`_useStore`.
- Keep selectors cheap. The selector runs on every notification of the source (`src/useSelector.ts:46-52`); move expensive computation into a derived `createStore`.
- Do not import `createStoreContext` from this package. The 0.11.0 release notes list it, but the 0.11.1 source exports only `useSelector`, `useAtom`, `useStore`, `_useStore` plus the core re-export (`src/index.ts`, `dist/index.d.ts`). See [release 0.11.0](https://github.com/TanStack/store/releases/tag/%40tanstack%2Fvue-store%400.11.0).

## Core re-exports from `@tanstack/store`

- `createStore(initialValue)` -> `Store<T>`; `createStore((prev?) => T)` -> `ReadonlyStore<T>` (derived); `createStore(initialValue, actionsFactory)` -> `Store<T, TActions>` with typed `store.actions`.
- `Store`: `state` getter, `get()`, `setState(updater)`, `subscribe(observerOrFn)` returning `{ unsubscribe }`, bound `actions`. `ReadonlyStore` omits `setState` and `actions`.
- `createAtom(initialValue)` -> writable `Atom<T>`; `createAtom(fn)` -> computed `ReadonlyAtom<T>`. `AtomOptions.compare` controls change detection.
- `createAsyncAtom(() => Promise<T>)` -> `ReadonlyAtom` of a `{ status }` discriminated union: `'pending' | 'done' | 'error'`.
- `batch(fn)` groups updates into one notification cycle; `flush()` drains pending effects. `shallow(a, b)` compares `Object.is`, then Map and Set contents, Date timestamps, and own keys including symbols.
- `toObserver()` normalizes callbacks or RxJS-style observers for `subscribe`.
- Types: `Observer`, `Subscription`, `Subscribable`, `Readable`, `Atom`, `ReadonlyAtom`, `AtomOptions`, `StoreActionMap`, `StoreActionsFactory`, and others.

Full surface with cautions: [core API reference](./references/core-api.md)

## Best practices

- Use `useSelector`, never the deprecated `useStore`, for new code (`src/useSelector.ts:39`).
- Define stores in plain modules outside components. This is the documented sharing pattern ([Vue quick start](https://tanstack.com/store/latest/docs/framework/vue/quick-start)).
- Select fine-grained slices. The component re-renders only when the selected value changes.
- Write state through `store.setState((prev) => next)` updater functions; updates are immutable.
- Group multiple updates in `batch(() => { ... })` so subscribers notify once with the final state.
- Derive with `createStore(() => ...)`; derived stores recompute when dependencies change, and `prev` accumulates values.
- Co-locate writes with an actions factory so `_useStore` returns typed actions (`src/_useStore.ts:37-38`).
- Use `createAsyncAtom` for async data instead of hand-rolled pending and error flags.
- Observe state outside components with `store.subscribe(() => ...)`; it returns `{ unsubscribe }`.

Recipes and full examples: [patterns reference](./references/patterns.md)

## Migration

Version-specific changes and upgrade steps, most recent first: [migration reference](./references/migration.md)

Highlights:

- 0.11.x: `useSelector` introduced as primary hook; `useStore` deprecated; default compare is `===`, replacing the pre-0.11 `shallow` default and `{ equal }` option.
- 0.9.0 breaking: `new Store()` -> `createStore()`; `new Derived()` -> derived `createStore(fn)`; `new Effect()` removed in favor of `store.subscribe()`.

## Environment

- Vue `^3.0.0` or `^2.5.0` through `vue-demi`. Vue 2 needs the optional peer `@vue/composition-api@^1.2.1` (package.json:50-58).
- Exact core pin `@tanstack/[email protected]`; core APIs are re-exported, so no separate core install is needed in Vue apps.
- Dual format: ESM via the `import` condition (`dist/index.js`), CJS via `require` (`dist/index.cjs`); types at `dist/index.d.cts`; `sideEffects: false`.
- TypeScript 5.6 through 5.9 are tested (package.json:62-66).

© skilld-dev · MIT · skilld-dev/vue-ecosystem-skills

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

Все скиллы по теме «Фронтенд и UI» →
tanstack-store oakoss Объясняет агенту устройство TanStack Store: стор, производные значения, батчи и эффекты. Описывает общее состояние нескольких компонентов. CX Codex +1 113установок vue-pinia-best-practices github.com/vuejs-ai Скилл vue-pinia-best-practices с лучшими практиками Pinia: как избежать ошибок при настройке хранилищ, сохранить реактивность и правильно организовать state management в Vue-проекте. CX Codex +1 18 500установок tanstack-query oakoss Помогает агенту писать запросы и мутации на TanStack Query v5, переводить код с v4 и настраивать инвалидацию кэша. CX Codex +1 170установок vue-best-practices github.com/vuejs-ai Скилл vue-best-practices задаёт стандарты разработки на Vue 3 с Composition API и TypeScript. Пригодится при написании SFC-компонентов, composables и настройке реактивности. CX Codex +1 45 800установок vue Anthony Fu Скилл vue для Claude Code помогает писать компоненты Vue 3 и разбирать Composition API. Он подключается при работе с SFC, макросами defineProps и defineEmits, наблюдателями и встроенными компонентами. CX Codex +1 36 900установок clerk-vue-patterns clerk Скилл clerk-vue-patterns для Claude Code подсказывает, как связать Clerk с Vue 3. Он включается при работе с композаблами, защитой маршрутов и авторизацией через Pinia. CX Codex +1 14 700установок

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

Весь набор →
floating-ui-vue-skilld Скилл floating-ui-vue-skilld помогает писать позиционирование всплывающих окон, тултипов и меню через @floating-ui/vue 2.0.1 во Vue 3.3+. CX Codex +1 119установок vue-data-ui-skilld Скилл vue-data-ui-skilld помогает агенту работать с библиотекой графиков vue-data-ui для Vue 3: выбирать компоненты, настраивать темы и разбирать ошибки. CX Codex +1 118установок unovis-vue-skilld Скилл unovis-vue-skilld для Claude Code помогает писать и отлаживать код на Vue 3 с компонентами @unovis/vue. Используется для построения графиков и обновления интеграции с Unovis 1.7.0. CX Codex +1 112установок vitepress-skilld Скилл vitepress-skilld даёт агенту справочник по API, настройкам и CLI VitePress 1.6.4 при сборке сайтов документации. CX Codex +1 110установок tanstack-ai-vue-skilld Скилл tanstack-ai-vue-skilld помогает писать и отлаживать Vue 3-код с @tanstack/ai-vue: чат, генерация медиа и типизированные инструменты. CX Codex +1 110установок formkit-core-skilld Скилл formkit-core-skilld для Claude Code помогает писать, отлаживать и проверять код для @formkit/core: узлов, значений, событий и хуков. CX Codex +1 105установок unhead-vue-skilld Скилл unhead-vue-skilld помогает ИИ-агенту настраивать теги head, метаданные SEO и скрипты в проектах на Vue 3 через библиотеку @unhead/vue. CX Codex +1 105установок tanstack-vue-router-skilld Скилл tanstack-vue-router-skilld для работы с @tanstack/vue-router — типобезопасным роутером Vue. Учит агента правилам настройки, file-based маршрутов, композаблов с Ref, линков и лоадеров. CX Codex +1 101установок

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

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