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

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

Скилл tanstack-devtools учит агента настраивать отладку кэша Query, дерева Router и полей Form в React-приложениях с библиотеками TanStack.

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

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

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

Скилл содержит правила подключения инструментов отладки для экосистемы TanStack. Он подсказывает ассистенту, как монтировать отдельные панели вроде ReactQueryDevtools и TanStackRouterDevtools или собирать единый интерфейс через компонент TanStackDevtools с плагинами. Внутри описаны настройки плавающего и встроенного режимов, параметры тем, горячих клавиш и ленивой загрузки через React.lazy.

В инструкциях собраны частые ошибки интеграции. Скилл предотвращает вызовы отладчика за пределами QueryClientProvider, лишнюю передачу пропса router внутри существующего контекста и одновременный рендеринг одиночных и объединённых панелей.

Скилл рассчитан строго на библиотеки TanStack в среде React. Для продакшена эти панели по умолчанию вырезаются сборщиком, поэтому отлаживать боевой стенд без специального компонента ReactQueryDevtoolsInProd скилл не рекомендует.

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

  • настроить единую панель TanStack Devtools с плагинами для формы и роутера
  • встроить плавающую панель React Query внутрь нужного провайдера
  • сконфигурировать плагин Vite для удаления отладки из продакшен-бандла
  • настроить ленивую загрузку отладочных панелей через React.lazy

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

  • Добавь ReactQueryDevtools в наш корневой провайдер с ленивой загрузкой
  • Настрой единый TanStackDevtools в vite.config и подключи плагин для роутера
  • Проверь, почему панель TanStackRouterDevtools дублируется на экране

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

1Через Skills CLI (Vercel)

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

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

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

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

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

Вопросы о tanstack-devtools

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

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

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

Он предоставляет агенту справочные паттерны по настройке панелей отладки Query, Router и Form, предотвращая ошибки размещения компонентов в дереве React.

Можно ли совмещать одиночные devtools и единую панель?

Нет, документация скилла прямо предостерегает от этого, потому что одновременный рендеринг приводит к дублированию интерфейсов на экране.

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

SKILL.md · MIT
---
name: tanstack-devtools
description: 'TanStack DevTools for debugging Query, Router, and Form state in React apps. Use when setting up devtools, debugging cache state, or inspecting route trees. Use for devtools, react-query-devtools, router-devtools, form-devtools, debug, inspect, cache-viewer.'
license: MIT
metadata:
  author: oakoss
  version: '1.1'
  source: 'https://tanstack.com/devtools/latest/docs'
user-invocable: false
---

# TanStack DevTools

## Overview

TanStack DevTools provides debugging panels for inspecting Query cache state, Router route trees, and Form field state in React applications. There are two approaches: **standalone devtools** per library (`ReactQueryDevtools`, `TanStackRouterDevtools`) and the **unified TanStack Devtools** panel that combines all libraries into a single interface with plugin architecture.

**When to use:** Setting up devtools for TanStack libraries, debugging query cache behavior, inspecting route matching, monitoring form field state, or combining multiple TanStack devtools into one panel.

**When NOT to use:** Production debugging (devtools are tree-shaken in production by default), non-React frameworks without adapter support, or custom state management unrelated to TанStack libraries.

## Quick Reference

| Pattern                    | API                                       | Key Points                                          |
| -------------------------- | ----------------------------------------- | --------------------------------------------------- |
| Query devtools (floating)  | `<ReactQueryDevtools />`                  | Auto-connects to nearest QueryClient                |
| Query devtools (embedded)  | `<ReactQueryDevtoolsPanel />`             | Embed in custom layout                              |
| Router devtools (floating) | `<TanStackRouterDevtools />`              | Place in root route component                       |
| Router devtools (embedded) | `<TanStackRouterDevtoolsPanel />`         | Requires `router` prop outside provider             |
| Form devtools              | `<ReactFormDevtoolsPanel />`              | Plugin for unified devtools                         |
| Unified devtools           | `<TanStackDevtools plugins={[...]} />`    | Single panel for all TanStack libraries             |
| Vite plugin                | `devtools()` in vite config               | Source injection, enhanced logs, production removal |
| Production devtools        | `ReactQueryDevtoolsInProd`                | Opt-in for production environments                  |
| Lazy loading               | `React.lazy(() => import(...))`           | Reduce bundle size in development                   |
| Open hotkey                | `config={{ openHotkey: ['Shift', 'D'] }}` | Keyboard shortcut for unified panel                 |

## Unified Devtools Config

| Option           | Type                                                                                              | Purpose                          |
| ---------------- | ------------------------------------------------------------------------------------------------- | -------------------------------- |
| `position`       | `'top-left' \| 'top-right' \| 'bottom-left' \| 'bottom-right' \| 'middle-left' \| 'middle-right'` | Trigger button location          |
| `panelLocation`  | `'top' \| 'bottom'`                                                                               | Panel slide direction            |
| `theme`          | `'dark' \| 'light'`                                                                               | Panel color scheme               |
| `defaultOpen`    | `boolean`                                                                                         | Open panel on load               |
| `hideUntilHover` | `boolean`                                                                                         | Hide trigger until hover         |
| `openHotkey`     | `KeyboardKey[]`                                                                                   | Toggle panel shortcut            |
| `inspectHotkey`  | `KeyboardKey[]`                                                                                   | Source inspector shortcut        |
| `requireUrlFlag` | `boolean`                                                                                         | Only activate with URL parameter |

## Common Mistakes

| Mistake                                                 | Correct Pattern                                                              |
| ------------------------------------------------------- | ---------------------------------------------------------------------------- |
| Importing devtools in production bundle                 | Standalone devtools auto-tree-shake; use `React.lazy` for code-splitting     |
| Passing `router` prop when inside RouterProvider        | Omit `router` prop; devtools auto-detect context                             |
| Using `ReactQueryDevtools` position for panel placement | `buttonPosition` controls logo position; `position` controls panel edge      |
| Mixing standalone and unified devtools                  | Choose one approach; both rendering causes duplicate panels                  |
| Rendering devtools outside QueryClientProvider          | Place `ReactQueryDevtools` inside provider or pass `client` prop             |
| Using `TanStackRouterDevtools` outside route tree       | Place in root route component or pass `router` prop explicitly               |
| Forgetting Vite plugin for unified devtools             | Add `devtools()` from `@tanstack/devtools-vite` to vite config               |
| Using unified devtools without framework adapter        | Install both `@tanstack/react-devtools` and library-specific plugin packages |

## Delegation

- **Devtools setup review**: Use `Task` agent to verify correct placement and configuration
- **Bundle size analysis**: Use `Explore` agent to check devtools are tree-shaken in production
- **Code review**: Delegate to `code-reviewer` agent

> If the `tanstack-query` skill is available, delegate query-specific debugging patterns to it.
> Otherwise, recommend: `npx skills add oakoss/agent-skills --skill tanstack-query`
>
> If the `tanstack-router` skill is available, delegate route debugging patterns to it.
> Otherwise, recommend: `npx skills add oakoss/agent-skills --skill tanstack-router`
>
> If the `tanstack-form` skill is available, delegate form state management and validation patterns to it.

## References

- [Query devtools setup, modes, and options](references/query-devtools.md)
- [Router devtools setup, route inspection, and options](references/router-devtools.md)
- [Form devtools and unified devtools patterns](references/form-devtools.md)

© oakoss · MIT · oakoss/agent-skills

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

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

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

tanstack-devtools tanstack-skills Скилл tanstack-devtools учит агента подключать единую панель отладки TanStack в проектах на React. Помогает настроить плагины для Query, Router и рабочих процессов TanStack AI. CX Codex +1 2 400установок 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-vue-router-skilld skilld-dev Скилл tanstack-vue-router-skilld для работы с @tanstack/vue-router — типобезопасным роутером Vue. Учит агента правилам настройки, file-based маршрутов, композаблов с Ref, линков и лоадеров. CX Codex +1 101установок tanstack-query-best-practices DeckardGer Скилл tanstack-query-best-practices для Claude Code собирает правила TanStack Query для React: ключи запросов, кеш, мутации и SSR. Включается при работе над загрузкой данных, чтобы соблюдать одну схему. CX Codex +1 13 400установок devtools vercel-labs Скилл devtools для Claude Code добавляет панель отладки в json-render-приложения: показывает дерево компонентов, состояние и действия, стримит патчи и помогает выбирать элементы. CX Codex +1 8 400установок react-devtools callstackincubator Скилл react-devtools подключает агента к запущенному React или React Native приложению и отдаёт дерево компонентов, пропсы, хуки и данные профайлера. CX Codex +1 2 700установок

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

Весь набор →
rust Скилл подсказывает паттерны Rust для ownership, async-кода, веб-сервисов, CLI и тестов. Пригодится при разработке и ревью Rust-проектов. CX Codex +1 128установок github-cli Скилл github-cli обучает ИИ-агента шаблонам работы с утилитой gh: создание PR, разбор задач, запуск экшенов и запросы к GraphQL API прямо в терминале. CX Codex +1 128установок resend Помогает агенту настроить отправку писем через Resend API, шаблоны React Email, верификацию доменов и вебхуки Svix. CX Codex +1 127установок tanstack-pacer Даёт агенту карту TanStack Pacer: дебаунс, троттлинг, лимиты, очереди и React-хуки. Ограничивает частоту срабатывания обработчиков и запросов. CX Codex +1 126установок seo-optimizer Скилл seo-optimizer про SEO-архитектуру: JSON-LD, сигналы E-E-A-T, кластеры тем и аудит контента на 30 пунктов. Ставится в Claude, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. CX Codex +1 125установок performance-optimizer Скилл performance-optimizer оптимизирует скорость и масштабируемость приложений от фронтенда до базы данных. Помогает найти узкие места в API, настроить кеширование и устранить проблему N+1 в запросах. CX Codex +1 124установок storybook-stories Скилл storybook-stories создаёт истории Storybook и тесты взаимодействия в формате CSF3. Помогает изолированно разрабатывать интерфейсы, настраивать снимки Chromatic и тестировать доступность. CX Codex +1 124установок shell-integration Скилл shell-integration для Claude Code содержит шаблоны интеграции с Bash, Zsh и Fish: автодополнения, хуки и переносимые скрипты. CX Codex +1 123установок

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

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