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

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

Настраивает headless-таблицы TanStack Table v8 в React: серверная пагинация, фильтры и сортировка без циклических ререндеров.

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

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

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

Скилл даёт ассистенту правила работы с библиотекой TanStack Table v8 для React. Он помогает выстраивать архитектуру useReactTable: типизированные колонки через createColumnHelper, подключение моделей строк вроде getCoreRowModel или getFilteredRowModel, а также интеграцию с серверными запросами.

Инструкции предотвращают типовые ошибки: потерю мемоизации данных и колонок, вызовы устаревшего API v7 или импорты из @tanstack/table-core вместо @tanstack/react-table. Для проектов с React 19 скилл требует директиву 'use no memo', потому что компилятор пока не совместим с v8.

Группировка строк на клиенте начинает тормозить на 10k+ строк, поэтому скилл советует переводить такие объёмы на серверную обработку.

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

  • настроить серверную пагинацию и сортировку вместе с TanStack Query
  • устранить бесконечные ререндеры из-за нестабильных ссылок на columns и data
  • внедрить виртуализацию больших списков через TanStack Virtual
  • собрать фасетные фильтры с подсчётом уникальных значений

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

  • Сделай таблицу заказов на TanStack Table v8 с серверной пагинацией и сортировкой
  • Исправь бесконечный ререндер в компоненте UserTable.tsx на useReactTable
  • Добавь пиннинг левой колонки с действиями и фасетный фильтр по статусу

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

1Через Skills CLI (Vercel)

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

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

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

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

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

Вопросы о tanstack-table

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

Выполните в терминале команду npx skills add oakoss/agent-skills --skill tanstack-table -a claude-code.

Что делает скилл tanstack-table?

Он обучает ИИ-агента архитектуре TanStack Table v8 для React, включая настройку моделей строк, серверную фильтрацию и предотвращение циклических ререндеров.

Зачем скилл требует директиву 'use no memo'?

React 19 Compiler пока не совместим с TanStack Table v8. Директива отключает авто-мемоизацию в компонентах с таблицей и предотвращает сбои рендера.

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

SKILL.md · MIT
---
name: tanstack-table
description: |
  TanStack Table v8 headless data tables for React. Covers column definitions, sorting, filtering (fuzzy/faceted), server-side pagination with TanStack Query, infinite scroll, virtualization (TanStack Virtual), column/row pinning, row expanding/grouping, column resizing, and reusable Shadcn-styled components. Prevents 15 documented errors including infinite re-renders, React Compiler incompatibility, and server-side state mismatches.

  Use when building data tables, fixing table performance, implementing server-side pagination, adding filtering/sorting, or debugging table state issues.
license: MIT
metadata:
  author: oakoss
  version: '1.1'
  source: 'https://tanstack.com/table/latest/docs'
user-invocable: false
---

# TanStack Table

## Overview

TanStack Table is a **headless** table library — it provides state management and logic but no UI. You supply the rendering; it handles sorting, filtering, pagination, selection, and more.

**When to use:** Complex data tables with sorting/filtering/pagination, server-side data, large datasets (1000+ rows with virtualization), row selection/expanding/grouping.

**When NOT to use:** Simple static tables (use `<table>` directly), display-only lists (use a list component), spreadsheet-like editing (consider AG Grid).

## Quick Reference

| Pattern           | API / Config                                         | Key Points                                   |
| ----------------- | ---------------------------------------------------- | -------------------------------------------- |
| Basic table       | `useReactTable({ data, columns, getCoreRowModel })`  | Memoize data/columns to prevent re-renders   |
| Column helper     | `createColumnHelper<T>()`                            | Type-safe column definitions                 |
| Column groups     | `columnHelper.group({ header, columns })`            | Nested headers; don't pin group columns      |
| Sorting           | `getSortedRowModel()` + `onSortingChange`            | `manualSorting: true` for server-side        |
| Filtering         | `getFilteredRowModel()` + `onColumnFiltersChange`    | `manualFiltering: true` for server-side      |
| Pagination        | `getPaginationRowModel()` + `onPaginationChange`     | `manualPagination: true` + `pageCount`       |
| Row selection     | `enableRowSelection` + `onRowSelectionChange`        | Set `getRowId` for stable selection keys     |
| Column visibility | `onColumnVisibilityChange`                           | Toggle with `column.toggleVisibility()`      |
| Column pinning    | `enableColumnPinning` + `initialState.columnPinning` | Don't pin group columns (known bug)          |
| Row expanding     | `getExpandedRowModel()` + `getSubRows`               | For nested/tree data                         |
| Column resizing   | `enableColumnResizing` + `columnResizeMode`          | `onChange` for live, `onEnd` for performant  |
| Row grouping      | `getGroupedRowModel()` + `aggregationFn`             | Performance degrades at 10k+ rows            |
| Server-side       | `manual*: true` flags + include state in queryKey    | All state in query key for proper refetching |
| Infinite scroll   | `useInfiniteQuery` + flatten pages                   | Combine with TanStack Virtual for best perf  |
| Virtualization    | `useVirtualizer` from `@tanstack/react-virtual`      | Disable when container hidden (tabs/modals)  |
| React 19 Compiler | `'use no memo'` directive                            | Required until v9 fixes compiler compat      |

## Common Operations

| Task              | Method                         |
| ----------------- | ------------------------------ |
| Sort column       | `column.toggleSorting()`       |
| Filter column     | `column.setFilterValue(value)` |
| First page        | `table.firstPage()`            |
| Next page         | `table.nextPage()`             |
| Previous page     | `table.previousPage()`         |
| Last page         | `table.lastPage()`             |
| Go to page        | `table.setPageIndex(n)`        |
| Select row        | `row.toggleSelected()`         |
| Hide column       | `column.toggleVisibility()`    |
| Get original data | `row.original`                 |
| Pin column        | `column.pin('left')`           |
| Resize column     | `header.getResizeHandler()`    |
| Expand row        | `row.toggleExpanded()`         |

## Row Models

| Import                   | Purpose                 |
| ------------------------ | ----------------------- |
| `getCoreRowModel`        | Required                |
| `getSortedRowModel`      | Sorting                 |
| `getFilteredRowModel`    | Filtering               |
| `getPaginationRowModel`  | Pagination              |
| `getExpandedRowModel`    | Expanding               |
| `getGroupedRowModel`     | Grouping                |
| `getFacetedRowModel`     | Faceted filter counts   |
| `getFacetedUniqueValues` | Unique values per facet |
| `getFacetedMinMaxValues` | Min/max per facet       |

## Common Mistakes

| Mistake                                     | Correct Pattern                                            |
| ------------------------------------------- | ---------------------------------------------------------- |
| Unstable data/columns reference             | Memoize with `useMemo` or define outside component         |
| Missing `manual*` flags for server-side     | Set `manualPagination`, `manualSorting`, `manualFiltering` |
| Query key missing table state               | Include pagination, sorting, filters in queryKey           |
| Import from `@tanstack/table-core`          | Import from `@tanstack/react-table`                        |
| Using v7 `useTable` / `Header` / `accessor` | Use v8 `useReactTable` / `header` / `accessorKey`          |
| Pinning group columns                       | Pin individual columns within the group, not parent        |
| Grouping on 10k+ rows                       | Use server-side grouping or disable for large datasets     |
| Column filter not clearing on page change   | Reset `pageIndex` to 0 when filters change                 |
| Missing `'use no memo'` with React Compiler | Add directive to components using `useReactTable`          |
| Missing `getRowId` with row selection       | Set `getRowId: (row) => row.id` for stable selection keys  |
| Filter value type mismatch                  | Match value types; clear with `undefined`, not `null`      |

## Delegation

- **Table pattern discovery**: Use `Explore` agent
- **Server integration review**: Use `Task` agent
- **Code review**: Delegate to `code-reviewer` agent

> If the `tanstack-query` skill is available, delegate data fetching, caching, and infinite query patterns to it.
> If the `tanstack-virtual` skill is available, delegate standalone virtualization patterns to it.
> If the `tanstack-router` skill is available, delegate URL search param sync for server-side table state to it.
> If the `tanstack-start` skill is available, delegate server functions for server-side data loading to it.

## References

- [Column definitions, helpers, visibility, and selection](references/column-definitions.md)
- [Filtering: column, global, fuzzy, and faceted](references/filtering.md)
- [Server-side patterns with TanStack Query](references/server-side-patterns.md)
- [Infinite scroll with cursor pagination](references/infinite-scroll.md)
- [Reusable table components (Shadcn-styled)](references/reusable-components.md)
- [Virtualization for large datasets](references/virtualization.md)
- [Column and row pinning](references/column-row-pinning.md)
- [Row expanding and grouping](references/expanding-grouping.md)
- [Known issues and solutions (15 documented)](references/known-issues.md)
- [v7 to v8 migration guide](references/v7-migration.md)

© oakoss · MIT · oakoss/agent-skills

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

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

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

tanstack-table tanstack-skills Скилл учит агента настраивать headless-таблицы на TanStack Table v8. Он помогает правильно собрать сортировку и фильтрацию без поломки рендеров. CX Codex +1 5 700установок tanstack-table Claude Skills Maintainers Настраивает таблицы TanStack Table v8 с пагинацией и сортировкой на сервере. Пригодится при интеграции React с Cloudflare Workers и базой D1. CX Codex +1 520установок tanstack-vue-table-skilld skilld-dev Скилл tanstack-vue-table-skilld обучает агента правилам @tanstack/vue-table v9: явной регистрации фич в tableFeatures, атомарному состоянию и миграции с v8. Пригодится при сборке headless-таблиц на Vue 3. CX Codex +1 144установок table-builder patricio0312rev Скилл table-builder генерирует таблицы данных на React с пагинацией, фильтрами, сортировкой и поддержкой серверного или клиентского рендеринга. CX Codex +1 293установок tanstack-virtual tanstack-skills Скилл подсказывает агенту, как подключить TanStack Virtual и рисовать только видимые строки в больших списках, таблицах и сетках. CX Codex +1 2 600установок tanstack-wasp-drone Legion Code Inc. Субагент tanstack-wasp-drone помогает внедрять библиотеки TanStack в проекты на SvelteKit и Svelte 5 с учётом SSR и рун. CX Codex ★ 96звёзд репо tanstack-vue-virtual-skilld skilld-dev Скилл tanstack-vue-virtual-skilld помогает писать, проверять и отлаживать виртуализированные списки и сетки во Vue с @tanstack/vue-virtual. Пригодится и для лент чата с прокруткой к концу. CX Codex +1 129установок table-generation lingzhi227 Скилл table-generation для Claude Code, Codex, Cursor и других платформ преобразует JSON и CSV в публикационные LaTeX-таблицы с выделением лучших результатов, многострочными блоками и подписями. CX Codex +1 1 700установок

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

Весь набор →
design-system Скилл design-system для Claude Code собирает дизайн-систему с токенами, темами и архитектурой компонентов. Задаёт структуру для dark mode, CVA-вариантов и доступности. CX Codex +1 160установок zustand Скилл помогает настроить Zustand v5 в React: от типизированных хранилищ и middleware до SSR, тестов и миграции с Redux или Context. CX Codex +1 158установок tanstack-start По TanStack Start описывает серверные функции, SSR со стримингом, middleware и деплой. CX Codex +1 156установок pglite Скилл по PGlite: подсказывает агенту, как поднять сборку PostgreSQL 17.4 на WASM в браузере или Node.js, выбрать хранилище и настроить live-запросы. CX Codex +1 156установок changesets Скилл changesets помогает вести версии и changelog пакетов в монорепозитории. Он пригодится для согласованных релизов и публикации пакетов в npm. CX Codex +1 154установок opentofu Помогает писать и проверять конфигурации OpenTofu и Pulumi. Помогает управлять инфраструктурой, состоянием и окружениями из кода. CX Codex +1 153установок arktype-validation Скилл arktype-validation для Claude Code описывает схемы ArkType строками в синтаксисе TypeScript, включая морфы и рантайм-валидацию данных и переменных окружения через ArkEnv. CX Codex +1 153установок tanstack-router Скилл tanstack-router настраивает типобезопасную файловую маршрутизацию в React через @tanstack/react-router. Помогает с лоадерами данных, валидацией параметров поиска и разделением кода. CX Codex +1 150установок

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

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