# data-loading

Скилл data-loading помогает настраивать загрузку данных в TanStack Router: кэш, состояния ожидания, ошибки и контекст роутера.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 230 установок · ★ 15341 у репозитория
- Автор: TanStack
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/TanStack/router/tree/HEAD/packages/router-core/skills/router-core/data-loading/SKILL.md
- Обновлён: 2026-10-25
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/data-loading

## Что делает

Скилл разбирает route loader и использование данных через `useLoaderData`, задаёт ключи кэша через `loaderDeps` и настраивает SWR-параметры `staleTime`, `gcTime` и `preloadStaleTime`. В нём также описаны состояния ожидания через `pendingComponent`, `pendingMs` и `pendingMinMs`, обработка ошибок и порядок выполнения `beforeLoad` перед `loader`.

Отдельные разделы посвящены контексту роутера, фабрике `createRootRouteWithContext`, внедрению зависимостей и вызову `router.invalidate`. Для отложенных данных скилл показывает связку промисов без `await` и компонента `Await`. Он рассчитан на TanStack Router и требует `router-core`.

При SSR относительный `fetch('/api/posts')` может сломаться в Node и других серверных средах; для TanStack Start нужен серверный вызов или абсолютный URL, полученный из origin.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add TanStack/router --skill data-loading -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/data-loading/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/data-loading/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add TanStack/router --skill data-loading -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/data-loading/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add TanStack/router --skill data-loading -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/data-loading/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install TanStack/router packages/router-core/skills/router-core/data-loading
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/data-loading/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add TanStack/router --skill data-loading -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/TanStack/router --path packages/router-core/skills/router-core/data-loading
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/data-loading/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add TanStack/router --skill data-loading -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/TanStack/router/tree/HEAD/packages/router-core/skills/router-core/data-loading/SKILL.md

## Когда брать
- загрузить данные в route loader
- связать search-параметры с ключом кэша
- настроить stale-while-revalidate для маршрутов
- показать состояние ожидания и обработать ошибку
- передать зависимости через контекст роутера

## Примеры запросов агенту
- Настрой загрузку постов через `loader` и чтение результата в компоненте маршрута.
- Свяжи `offset` и `limit` из search-параметров с `loaderDeps` и кэшем.
- Покажи быстрые данные сразу, а комментарии загрузи через `Await` без ожидания в `loader`.

## Похожие
- [threejs-gltf-loading](https://affpapa.org/nevibecode/skills/threejs-gltf-loading.md) — скилл · 11200 установок
- [loading-states](https://affpapa.org/nevibecode/skills/loading-states.md) — скилл · 2700 установок
- [loading-sequence](https://affpapa.org/nevibecode/skills/loading-sequence.md) — скилл · 1700 установок
- [loading-assets](https://affpapa.org/nevibecode/skills/loading-assets.md) — скилл · 1100 установок
- [openspec-context-loading](https://affpapa.org/nevibecode/skills/openspec-context-loading.md) — скилл · 1100 установок
- [loading-states-and-perceived-performance](https://affpapa.org/nevibecode/skills/loading-states-and-perceived-performance.md) — скилл · 1000 установок

Из того же набора: [tanstack/router](https://affpapa.org/nevibecode/by/tanstack/router.md) — 25 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
