tanstack-db · oakoss — скилл для Claude Code: что делает и как установить
Скилл для Claude Code помогает проектировать реактивное клиентское хранилище на TanStack DB: живые запросы, связи коллекций и оптимистичные изменения. Описывает локальные данные и синхронизацию.
MIT 136 установок ★ 29 обновлён 2026-08-17
npx skills add oakoss/agent-skills --skill tanstack-db -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/tanstack-db/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/tanstack-db/
1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill tanstack-db -a codex2Вручную: положить файлы
.agents/skills/tanstack-db/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill tanstack-db -a cursor2Вручную: положить файлы
.cursor/skills/tanstack-db/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install oakoss/agent-skills skills/tanstack-db2Вручную: положить файлы
.github/skills/tanstack-db/SKILL.md1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill tanstack-db -a gemini-cli2Командой платформы
gemini skills install https://github.com/oakoss/agent-skills --path skills/tanstack-dbВручную: положить файлы
.devin/skills/tanstack-db/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill tanstack-db -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.