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

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

Скилл учит агента виртуализировать длинные списки, таблицы и сетки на TanStack Virtual: в DOM остаются только видимые строки.

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

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

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

Скилл даёт агенту шпаргалку по TanStack Virtual — headless-утилите, которая оставляет в DOM только видимые элементы списка, сетки или таблицы. Внутри таблица паттернов: вертикальный и горизонтальный список, сетка из двух виртуализаторов на одном контейнере, динамическая высота через measureElement, useWindowVirtualizer, прокрутка к элементу через scrollToIndex, lanes и overscan.

Полезнее всего раздел с типовыми ошибками. Без overflow: auto и фиксированной высоты у родителя прокрутка не появится, а внутренний контейнер с getTotalSize() должен быть position: relative. Для measureElement каждому элементу нужен data-index. С React Compiler компонентам с useVirtualizer требуется директива 'use no memo'.

К скиллу приложены четыре справочника: списки, сетки, динамический размер и бесконечная прокрутка вместе с TanStack Query. Списки меньше ~100 элементов виртуализировать смысла нет, выигрыша не будет. Работа с таблицами и запросами уходит к скиллам tanstack-table и tanstack-query, если они есть в проекте.

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

  • виртуализировать таблицу на тысячи строк, не утопив браузер в DOM-узлах
  • сделать бесконечную прокрутку поверх TanStack Query
  • починить прыгающий скролл при динамической высоте строк
  • закрепить липкие заголовки через rangeExtractor
  • перевести список с абсолютного позиционирования на translateY

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

  • Список из 5000 строк тормозит — переведи его на useVirtualizer, высоту строк оценивай с запасом.
  • Сделай виртуализированную сетку: два виртуализатора, строки и колонки, на одном контейнере прокрутки.
  • Добавь бесконечную прокрутку к таблице и подгружай страницы через TanStack Query.

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

1Через Skills CLI (Vercel)

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

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

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

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

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

Вопросы о tanstack-virtual

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

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

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

Учит агента строить виртуализированные списки, сетки и таблицы на TanStack Virtual и подсказывает, какие параметры передавать в useVirtualizer.

Что нужно, чтобы виртуализация заработала?

Родитель с прокруткой должен иметь overflow: auto и фиксированную высоту, а внутренний контейнер с getTotalSize() — position: relative. При динамическом замере каждому элементу нужен data-index.

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

SKILL.md · MIT
---
name: tanstack-virtual
description: 'TanStack Virtual for virtualizing large lists, grids, and tables. Use when rendering thousands of rows, implementing infinite scroll, or optimizing large data displays. Use for virtual, virtualize, virtual-list, virtual-scroll, useVirtualizer, infinite-scroll, windowing.'
license: MIT
metadata:
  author: oakoss
  version: '1.1'
  source: 'https://tanstack.com/virtual/latest'
user-invocable: false
---

# TanStack Virtual

## Overview

TanStack Virtual is a headless UI utility for virtualizing large lists, grids, and tables. It renders only the visible items in the viewport, dramatically reducing DOM nodes and improving performance for datasets with thousands of rows. Framework adapters are available for React, Vue, Solid, Svelte, Lit, and Angular.

**When to use:** Rendering thousands of rows or columns, building virtualized tables, implementing infinite scroll, displaying large datasets where DOM node count impacts performance.

**When NOT to use:** Small lists under ~100 items (no performance benefit), server-rendered static content, layouts where all items must be in the DOM for SEO or accessibility, simple pagination (render one page at a time instead).

## Quick Reference

| Pattern             | API                                                         | Key Points                                               |
| ------------------- | ----------------------------------------------------------- | -------------------------------------------------------- |
| Vertical list       | `useVirtualizer({ count, getScrollElement, estimateSize })` | Wrap items in absolute-positioned container              |
| Horizontal list     | `useVirtualizer({ horizontal: true, ... })`                 | Use `getTotalSize()` for width instead of height         |
| Grid layout         | Row virtualizer + column virtualizer                        | Two virtualizer instances sharing one scroll element     |
| Dynamic sizing      | `ref={virtualizer.measureElement}`                          | Set `data-index` on each element                         |
| Window scroller     | `useWindowVirtualizer({ count, estimateSize })`             | No `getScrollElement` needed                             |
| Scroll to item      | `virtualizer.scrollToIndex(index)`                          | Supports `align: 'start' \| 'center' \| 'end' \| 'auto'` |
| Scroll to offset    | `virtualizer.scrollToOffset(px)`                            | Supports `align` and `behavior: 'smooth'`                |
| Custom keys         | `getItemKey: (index) => items[index].id`                    | Stable keys improve measurement cache                    |
| Overscan            | `overscan: 5`                                               | Renders extra items outside viewport (default: 1)        |
| Gap between items   | `gap: 8`                                                    | Space between virtualized items in pixels                |
| Multi-lane layout   | `lanes: 3`                                                  | Masonry-style column layouts                             |
| Padding             | `paddingStart: 100, paddingEnd: 100`                        | Space before first and after last item                   |
| RTL support         | `isRtl: true`                                               | Right-to-left horizontal scrolling                       |
| Range extractor     | `rangeExtractor: (range) => [...]`                          | Customize rendered indices (sticky headers, footers)     |
| Disable virtualizer | `enabled: false`                                            | Renders nothing, resets internal state                   |
| Force remeasure     | `virtualizer.measure()`                                     | Call after external layout changes                       |

## Common Mistakes

| Mistake                                             | Correct Pattern                                                                                             |
| --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| Missing `overflow: auto` on scroll container        | Parent element must have `overflow: auto` and a fixed height/width                                          |
| Using `virtualItem.index` as React key              | Use `virtualItem.key` which accounts for dynamic reordering                                                 |
| Forgetting `position: relative` on inner container  | The total-size container must be `position: relative`                                                       |
| Not setting `data-index` with `measureElement`      | Dynamic measurement requires `data-index={virtualItem.index}` on each element                               |
| Setting `estimateSize` too small for dynamic items  | Overestimate to prevent scroll jumping; use largest expected size                                           |
| Recreating `getScrollElement` on every render       | Use a ref callback: `() => parentRef.current`                                                               |
| Not using `getTotalSize()` for container dimensions | Inner container height/width must equal `virtualizer.getTotalSize()`                                        |
| Absolute positioning without `transform`            | Use `transform: translateY(item.start)` for GPU-accelerated positioning                                     |
| Using `contain: strict` without fixed dimensions    | `contain: strict` requires explicit width and height on the scroll container                                |
| Using with React Compiler without opting out        | Add `'use no memo'` directive to components using `useVirtualizer` — interior mutability breaks memoization |

## Delegation

> If the `tanstack-table` skill is available, delegate data table virtualization to it. TanStack Table has built-in virtualization integration.
> Otherwise, recommend: `npx skills add oakoss/agent-skills --skill tanstack-table`
>
> If the `tanstack-query` skill is available, delegate data fetching and infinite query patterns to it.
> Otherwise, recommend: `npx skills add oakoss/agent-skills --skill tanstack-query`

## References

- [List virtualization with useVirtualizer](references/list-virtualization.md)
- [Grid virtualization with row and column virtualizers](references/grid-virtualization.md)
- [Dynamic sizing with measureElement](references/dynamic-sizing.md)
- [Infinite scroll with TanStack Query integration](references/infinite-scroll.md)

© oakoss · MIT · oakoss/agent-skills

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

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

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

tanstack-virtual tanstack-skills Скилл подсказывает агенту, как подключить TanStack Virtual и рисовать только видимые строки в больших списках, таблицах и сетках. CX Codex +1 2 600установок tanstack-vue-virtual-skilld skilld-dev Скилл tanstack-vue-virtual-skilld помогает писать, проверять и отлаживать виртуализированные списки и сетки во Vue с @tanstack/vue-virtual. Пригодится и для лент чата с прокруткой к концу. CX Codex +1 129установок virtual-lists patterns.dev Скилл virtual-lists обучает агента технике виртуализации списков и таблиц в веб-приложениях. Помогает убрать задержки при скролле и ускорить начальную отрисовку страниц. CX Codex +1 1 700установок 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

Весь набор →
github-actions Помогает создавать и настраивать GitHub Actions workflows: от триггеров и матриц сборки до кеширования и аутентификации. Автоматизирует тесты, релизы и развёртывание. CX Codex +1 149установок git-workflow Скилл git-workflow помогает агенту выстраивать trunk-based разработку, оформлять conventional commits, настраивать пайплайны GitHub Actions и чистить историю Git. CX Codex +1 149установок ux-designer Скилл ux-designer для ИИ-агентов: проводит проект от информационной архитектуры до передачи в разработку, с проверкой доступности и юзабилити. CX Codex +1 148установок responsive-images Скилл responsive-images внедряет адаптивные изображения с srcset, современными форматами AVIF и WebP, защищая от сдвигов верстки CLS и ускоряя LCP. CX Codex +1 148установок de-slopify Скилл de-slopify для Claude Code находит шаблонные обороты, лишние тире и следы ИИ в комментариях при правке текста и кода после языковой модели. CX Codex +1 146установок docker Скилл для сборки Docker-образов, настройки Compose-стеков и подготовки контейнеров к продакшену. CX Codex +1 145установок chrome-devtools Скилл chrome-devtools управляет настоящим Chrome через расширение или DevTools MCP: заполняет формы, читает страницы и помогает отлаживать веб-приложения. Работает с активной сессией браузера. CX Codex +1 145установок hydration-guardian Скилл hydration-guardian ловит расхождение серверной разметки и клиентского React-дерева: по тексту ошибки находит причину и подсказывает, какой приём гидратации применить. CX Codex +1 144установок

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

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