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

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

Скилл для Claude Code помогает проектировать реактивное клиентское хранилище на TanStack DB: живые запросы, связи коллекций и оптимистичные изменения. Описывает локальные данные и синхронизацию.

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

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

Что делает tanstack-db

Скилл подсказывает, как описывать типизированные коллекции, строить useLiveQuery с фильтрацией, сортировкой, объединениями и агрегациями, а также добавлять записи, менять и удалять их с оптимистичным обновлением. Он охватывает синхронизацию через обработчики onInsert, onUpdate и onDelete, интеграцию с ElectricSQL и хранение через localStorage.

В материалах разобраны режимы загрузки коллекций, транзакции между коллекциями и обработка отката. Для React-приложения скилл советует импортировать API из @tanstack/react-db, а для REST-коллекций установить @tanstack/query-db-collection. Без обработчиков сохранения данные коллекции сами на сервер не отправятся.

TanStack DB находится в бете, поэтому API может меняться между релизами. Скилл также подсказывает выносить создание коллекций за пределы компонентов и задавать для них getKey.

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

  • описать типизированные коллекции с ключами записей
  • собрать живой запрос с фильтрами и объединением коллекций
  • добавить оптимистичное создание, изменение и удаление записей
  • настроить обработчики сохранения и синхронизацию с сервером
  • подключить коллекцию ElectricSQL или локальное хранилище

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

  • Помоги создать коллекцию TanStack DB для задач и настроить для неё getKey.
  • Составь useLiveQuery, который фильтрует задачи и объединяет их с коллекцией проектов.
  • Покажи, как добавить оптимистичное обновление и сохранить изменения через onUpdate.

Как установить tanstack-db

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill tanstack-db -a claude-code

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

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

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

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

Вопросы о tanstack-db

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

Выполните npx skills add oakoss/agent-skills --skill tanstack-db -a claude-code. Файл скилла появится по пути ~/.claude/skills/tanstack-db/SKILL.md.

Что делает tanstack-db?

Скилл помогает работать с коллекциями TanStack DB, живыми запросами и оптимистичными изменениями. В нём также разобраны синхронизация с сервером и локальное хранение.

Нужно ли отдельно настраивать синхронизацию с сервером?

Да. Для сохранения изменений задайте обработчики onInsert, onUpdate и onDelete; без них коллекции не синхронизируются с сервером автоматически.

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

SKILL.md · MIT
---
name: tanstack-db
description: 'TanStack DB reactive client-side database with live queries and optimistic mutations. Use when building reactive UIs with local-first data, sync engines, or optimistic updates. Use for tanstack-db, live queries, optimistic mutations, sync engine, reactive database, local-first.'
license: MIT
metadata:
  author: oakoss
  version: '1.3'
  source: 'https://tanstack.com/db/latest'
user-invocable: false
---

# TanStack DB

## Overview

TanStack DB is a reactive client store built on differential dataflow that extends TanStack Query with collections, live queries, and optimistic mutations. It normalizes data into typed collections, enables sub-millisecond cross-collection queries, and provides instant optimistic updates with automatic rollback on failure.

**When to use:** Reactive UIs needing local-first data, cross-collection joins with live updates, optimistic mutations with automatic sync, real-time sync via ElectricSQL or other backends, apps that outgrow TanStack Query's per-query caching model.

**When NOT to use:** Simple fetch-and-display (TanStack Query alone suffices), server-components-only apps, purely synchronous local state (useState/Zustand), GraphQL with normalized caching (Apollo/urql).

> TanStack DB is currently in **beta**. APIs may change between releases.

## Quick Reference

| Pattern             | API                                                         | Key Points                                            |
| ------------------- | ----------------------------------------------------------- | ----------------------------------------------------- |
| Create collection   | `createCollection(queryCollectionOptions({...}))`           | Define typed set of objects with `getKey`             |
| Live query (React)  | `useLiveQuery((q) => q.from({...}).where(...))`             | Auto-updates when underlying data changes             |
| Filter              | `.where(({ t }) => eq(t.field, value))`                     | Supports `eq`, `gt`, `lt`, `like`, `and`, `or`, `not` |
| Select fields       | `.select(({ t }) => ({ id: t.id, name: t.name }))`          | Project specific fields from collections              |
| Order results       | `.orderBy(({ t }) => t.field, 'asc')`                       | Sort ascending or descending                          |
| Join collections    | `.join({ b: collB }, ({ a, b }) => eq(...), 'inner')`       | Cross-collection joins with type safety               |
| Group and aggregate | `.groupBy(...).select(({ t }) => ({ count: count(t.id) }))` | Supports `count`, `sum`, `avg`, `min`, `max`          |
| Insert              | `collection.insert({ ...data })`                            | Optimistic insert, syncs via `onInsert` handler       |
| Update              | `collection.update(key, (draft) => { ... })`                | Immer-style draft mutation, syncs via `onUpdate`      |
| Delete              | `collection.delete(key)`                                    | Optimistic delete, syncs via `onDelete` handler       |
| Electric sync       | `electricCollectionOptions({ shapeOptions: {...} })`        | Real-time Postgres sync via ElectricSQL               |
| Live query coll.    | `liveQueryCollectionOptions({ query })`                     | Derived collection from live query definition         |
| Local storage       | `localStorageCollectionOptions({...})`                      | Persistent local data, syncs across tabs              |

## Sync Modes (v0.5+)

| Mode            | Behavior                                             | Use Case                          |
| --------------- | ---------------------------------------------------- | --------------------------------- |
| Eager (default) | Loads all records on collection init                 | Small datasets (< 1k rows)        |
| On-demand       | Loads only what queries request (predicate pushdown) | Large datasets, selective loading |
| Progressive     | Fast first paint, full dataset syncs in background   | Best of both, scales to 100k+     |

## Common Mistakes

| Mistake                                        | Correct Pattern                                             |
| ---------------------------------------------- | ----------------------------------------------------------- |
| Using TanStack Query directly for local state  | Use collections with live queries for reactive local data   |
| Forgetting `getKey` in collection config       | Always provide `getKey` to identify items uniquely          |
| Not providing persistence handlers             | Define `onInsert`/`onUpdate`/`onDelete` to sync with server |
| Using `useQuery` instead of `useLiveQuery`     | `useLiveQuery` provides reactive cross-collection queries   |
| Creating collections inside components         | Define collections at module scope, outside components      |
| Importing from `@tanstack/db` in React apps    | Import from `@tanstack/react-db` (re-exports core)          |
| Expecting automatic server sync without config | Collections require explicit persistence handlers for sync  |
| Not installing collection type package         | Install `@tanstack/query-db-collection` for REST API usage  |

## Delegation

> If the `tanstack-query` skill is available, delegate TanStack Query-specific patterns (query keys, cache invalidation, SSR) to it.
> Otherwise, recommend: `npx skills add oakoss/agent-skills --skill tanstack-query`
> If the `electricsql` skill is available, delegate ElectricSQL setup, shapes, auth proxy, and write patterns to it.
> Otherwise, recommend: `pnpm dlx skills add oakoss/agent-skills -s electricsql -a claude-code -y`
> If the `local-first` skill is available, delegate architecture decisions, sync engine comparison, and conflict resolution to it.
> Otherwise, recommend: `pnpm dlx skills add oakoss/agent-skills -s local-first -a claude-code -y`

- **Query pattern discovery**: Use `Explore` agent
- **Architecture review**: Use `Task` agent

## References

- [Setup, installation, and collection configuration](references/setup.md)
- [Live queries, filtering, joins, and aggregations](references/live-queries.md)
- [Optimistic mutations, persistence handlers, and sync patterns](references/mutations.md)
- [ElectricSQL integration, electric collections, and txid patterns](references/electricsql-integration.md)
- [Error class hierarchy, transaction states, and rollback patterns](references/error-handling.md)
- [Local-only and localStorage collections with cross-tab sync](references/local-and-storage-collections.md)
- [Cross-collection transactions, joins, batching, and lifecycle](references/multi-collection.md)

© oakoss · MIT · oakoss/agent-skills

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

Все скиллы по теме «Фронтенд и UI» →

Сначала — tanstack-db от других авторов.

tanstack-db tanstack-skills Скилл помогает агенту работать с TanStack DB: коллекциями, живыми запросами и оптимистичными мутациями в клиентском приложении. CX Codex +1 1 700установок tanstack-table Claude Skills Maintainers Настраивает таблицы TanStack Table v8 с пагинацией и сортировкой на сервере. Пригодится при интеграции React с Cloudflare Workers и базой D1. CX Codex +1 520установок clerk-tanstack-patterns clerk Скилл clerk-tanstack-patterns для Claude Code подсказывает, как настроить авторизацию Clerk в TanStack React Start. Активируется при работе с createServerFn, защитой маршрутов через beforeLoad и middleware. CX Codex +1 16 400установок tanstack-query-best-practices DeckardGer Скилл tanstack-query-best-practices для Claude Code собирает правила TanStack Query для React: ключи запросов, кеш, мутации и SSR. Включается при работе над загрузкой данных, чтобы соблюдать одну схему. CX Codex +1 13 400установок tanstack-query tanstack-skills Скилл подсказывает агенту, как работать с TanStack Query v5: кэширование, инвалидация, мутации и оптимистичные обновления. CX Codex +1 10 500установок tanstack-start-best-practices DeckardGer Скилл tanstack-start-best-practices для Claude Code собирает правила и паттерны для full-stack приложений на TanStack Start. Помогает настраивать серверные функции, сессии и потоковый SSR. CX Codex +1 10 000установок tanstack-router tanstack-skills Скилл по TanStack Router для React и Solid: файловый роутинг, поисковые параметры и загрузка данных с проверкой типов. CX Codex +1 5 200установок

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

Весь набор →
valkey Скилл помогает настраивать Valkey и Redis-совместимое хранилище: от кэша и лимитов запросов до очередей и миграции с Redis. Пригодится при проектировании схемы данных и Docker Compose. CX Codex +1 142установок remotion Скилл для Remotion: агент собирает видео из React-компонентов и держит анимацию в таймлайне, а не в CSS. CX Codex +1 141установок vite Описывает конфиг Vite, плагины, dev-сервер, сборку, SSR и переменные окружения. Задачи: правка vite.config.ts и сборка библиотек. CX Codex +1 138установок postgres-tuning Скилл postgres-tuning для Claude Code, Codex, Cursor и других агентов, который даёт инструкции по настройке производительности PostgreSQL 17/18+. Охватывает async I/O, анализ планов запросов, индексы, autovacuum, pgvector и PgBouncer. CX Codex +1 136установок prompt-engineering Скилл prompt-engineering для Claude Code собирает приёмы проектирования промптов: цепочки рассуждений, ReAct-циклы, шаблоны системных промптов, extended thinking и сжатие контекста. CX Codex +1 135установок react-error-handling Скилл react-error-handling помогает проектировать предохранители и запасные интерфейсы в React, чтобы сбой в дочернем компоненте не ломал всё приложение. CX Codex +1 134установок frontend-builder Скилл frontend-builder помогает спроектировать и собрать интерфейс на React или Next.js: от компонентов и состояния до форм, стилей и обработки ошибок. Пригодится при создании веб-приложения или выборе архитектуры. CX Codex +1 134установок mise Обучает агента работать с mise — менеджером версий инструментов, переменных окружения и задач. CX Codex +1 133установок

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

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