SkillFoxx
Telegram

TanStack Agent Skills

Четыре скилла с приоритетными правилами для TanStack Query, Router и Start: кеш, маршруты, серверные функции.

  • 230 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Минимальный доступ

Почему такой уровень

  • Скиллы состоят из Markdown-правил: ничего не запускают и никуда не обращаются, только меняют то, как агент пишет код TanStack.
Все причины и проверки

deckardger/tanstack-agent-skillsАвтор:DeckardGer

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/tanstack-agent-skills

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Минимальный доступИнструмент ничего не запускает и не ходит в сеть.

  • Скиллы состоят из Markdown-правил: ничего не запускают и никуда не обращаются, только меняют то, как агент пишет код TanStack.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

TanStack Agent Skills — четыре скилла с практическими правилами для проектов на TanStack. `tanstack-query` охватывает ключи запросов, кеш (`staleTime`, `gcTime`, инвалидацию), мутации с оптимистичными обновлениями, повторы при ошибках, префетч, бесконечные списки и гидратацию при серверном рендеринге. `tanstack-router` описывает типобезопасную маршрутизацию: файловые маршруты, загрузчики данных, параметры поиска, разделение кода и предзагрузку. `tanstack-start` собирает правила для полноценных приложений: серверные функции `createServerFn`, промежуточные обработчики, аутентификацию, защиту от CSRF и потоковый SSR. Четвертый скилл, `tanstack-integration`, связывает Query с Router и Start: общий `QueryClient` в контексте маршрутизатора, загрузчики, наполняющие кеш, и согласованная дегидратация. Каждое правило лежит отдельным файлом в `rules/` с приоритетом от CRITICAL до LOW, объяснением, плохим и хорошим примером и условием применимости.

Для кого. React-разработчикам на TanStack Query, Router или Start, которые просят агента писать и ревьюить такой код по проверенным правилам.

Подходит, если

  • Агент пишет первый `useQuery` в проекте, и ему нужны разумные ключи и время жизни кеша.
  • Мутация должна обновлять интерфейс сразу и откатываться при ошибке сервера.
  • Маршруты проекта растут, а параметры поиска и загрузчики остаются без типов.
  • Код ревьюят на дубли запросов и расхождения гидратации при серверном рендеринге.
  • Серверные функции TanStack Start защищают проверкой входных данных и сессией.

Не подходит, если

  • Проект работает на другой библиотеке данных, например SWR или Redux Toolkit Query: правила написаны под API TanStack.
  • Ищется генератор проекта или CLI: скиллы дают правила и каркас не создают.
  • Приложение на Vue, Solid или Svelte: в правилах описаны хуки и компоненты React.
  • Еще выбирается сама библиотека: скиллы исходят из того, что TanStack уже принят в проект.

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

Проверь работу с данными в проекте по правилам TanStack Query и поправь ключи запросов и staleTime.

Ограничения

Скиллы советуют, но ничего не проверяют: линтера и команд запуска нет, агент применяет правила по описанию. Покрыты Query, Router, Start и их связка, а Form, Table и другие пакеты TanStack в репозитории не описаны. Приоритеты от CRITICAL до LOW расставил автор, и они не заменяют документацию библиотеки, особенно после крупных релизов. Установка через `npx skills add` кладет файлы в каталоги найденных агентов, а для Cursor допустима ручная раскладка в `.cursor/`. Последний коммит датирован сентябрем 2026 года.

Как отключить. Удалите из каталога скиллов агента четыре папки: `tanstack-query`, `tanstack-router`, `tanstack-start` и `tanstack-integration`.

Частые вопросы

Как поставить TanStack Agent Skills в Claude Code?

Выполните `npx skills add DeckardGer/tanstack-agent-skills`. Скиллы подключаются автоматически и срабатывают, когда агент видит задачу про запросы, маршруты или серверные функции TanStack.

Какие пакеты TanStack покрыты?

Query, Router и Start, а также их совместная работа в скилле `tanstack-integration`. Form, Table и остальные пакеты в репозитории не описаны.

Что лежит в файле правила?

Приоритет (CRITICAL, HIGH, MEDIUM или LOW), объяснение, плохой пример, хороший пример и контекст: когда правило применять, а когда пропустить.

Что важнее всего в TanStack Query?

Критичными помечены правила о структуре ключей запросов и о кеше: `staleTime`, `gcTime` и инвалидация. Ниже идут мутации и обработка ошибок, затем префетч, бесконечные списки и серверный рендеринг.

Работают ли скиллы в Cursor?

Да. Скиллы подходят любому агенту, который читает `AGENTS.md`, а в Cursor их можно положить вручную в `.cursor/`.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Официальный CLI для создания приложений TanStack Start и Router с машиночитаемым JSON-выводом для кодинг-агентов

CLIРасширенный доступ1,3 тыс.

Авторские скиллы под Angular, React, Next.js, TypeScript и Django плюс шесть общинных для Java, Elixir и Electron

СкиллМинимальный доступ668

Плагин со скиллами для Rstack: настройка, переход на v2, отладка и разбор сборок Rspack, Rsbuild, Rslib, Rspress и Rstest.

ПлагинМинимальный доступ98

Скилл React Router

React Router agent skill

Официальный скилл React Router: агент определяет режим приложения и работает по документации установленной версии

СкиллМинимальный доступ56,6 тыс.

Скиллы Material UI

Material UI agent skills

Четыре официальных скилла Material UI: стилизация, темы, интеграция с Next.js и совместная работа с Tailwind CSS

СкиллМинимальный доступ99,3 тыс.

Сборник из 31 скилла для Claude Code и других агентов: интерфейсы, React, Postgres, код-ревью, SEO и браузерная автоматизация

СкиллРасширенный доступ219

Коротко о README

Репозиторий оформлен по стандарту Agent Skills, в корне лежат `AGENTS.md` и `CLAUDE.md`. Дополнения к правилам принимаются при условии, что примеры рабочие, а приоритеты обоснованы. Лицензия MIT.

Бейдж для README

Исходный SKILL.md

---
name: tanstack-query-best-practices
description: TanStack Query (React Query) best practices for data fetching, caching, mutations, and server state management. Activate when building data-driven React applications with server state.
---

# TanStack Query Best Practices

Comprehensive guidelines for implementing TanStack Query (React Query) patterns in React applications. These rules optimize data fetching, caching, mutations, and server state synchronization.

## When to Apply

- Creating new data fetching logic
- Setting up query configurations
- Implementing mutations and optimistic updates
- Configuring caching strategies
- Integrating with SSR/SSG
- Refactoring existing data fetching code

## Rule Categories by Priority

| Priority | Category | Rules | Impact |
|----------|----------|-------|--------|
| CRITICAL | Query Keys | 5 rules | Prevents cache bugs and data inconsistencies |
| CRITICAL | Caching | 5 rules | Optimizes performance and data freshness |
| HIGH | Mutations | 6 rules | Ensures data integrity and UI consistency |
| HIGH | Error Handling | 3 rules | Prevents poor user experiences |
| MEDIUM | Prefetching | 4 rules | Improves perceived performance |
| MEDIUM | Parallel Queries | 2 rules | Enables dynamic parallel fetching |
| MEDIUM | Infinite Queries | 3 rules | Prevents pagination bugs |
| MEDIUM | SSR Integration | 4 rules | Enables proper hydration |
| LOW | Performance | 4 rules | Reduces unnecessary re-renders |
| LOW | Offline Support | 2 rules | Enables offline-first patterns |

## Quick Reference

### Query Keys (Prefix: `qk-`)

- `qk-array-structure` — Always use arrays for query keys
- `qk-include-dependencies` — Include all variables the query depends on
- `qk-hierarchical-organization` — Organize keys hierarchically (entity → id → filters)

Сообщить о проблеме