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

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

Скилл для Claude Code даёт агенту карту TanStack Pacer: дебаунс, троттлинг, лимиты, очереди и React-хуки. Ограничивает частоту срабатывания обработчиков и запросов.

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

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

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

Скилл описывает агенту ядро TanStack Pacer: классы Debouncer, Throttler, RateLimiter, Queuer, AsyncQueuer, AsyncBatcher и React-хуки на уровнях инстанса, колбэка, состояния и значения. Внутри таблица «паттерн → API → что важно» и отдельный список типичных ошибок.

Польза в мелочах, на которых легко промахнуться. У Debouncer нет опции maxWait — для ровного темпа нужен Throttler, где leading и trailing включены по умолчанию. Отклонённые вызовы RateLimiter молчат, поэтому обратную связь пользователю даёт onReject. Фиксированное окно пропускает всплески на границах, скользящее их сглаживает.

Скилл говорит и о том, когда Pacer не нужен. Разовая задержка решается через setTimeout, лимиты на уровне инфраструктуры — задача middleware или API-шлюза, а сложное планирование отдают очереди вроде BullMQ. Загрузку данных и кеш скилл передаёт tanstack-query, если тот установлен.

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

  • задебаунсить поле поиска, чтобы запрос уходил после паузы
  • ограничить частоту обращений к внешнему API
  • сгладить обработчик скролла или ресайза через throttle
  • поставить асинхронные задачи в очередь с лимитом параллельности
  • собрать пачку операций в один запрос

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

  • Настрой дебаунс для поля поиска через useDebouncedCallback, чтобы запрос уходил после паузы в вводе.
  • Добавь к запросам RateLimiter со скользящим окном и покажи пользователю сообщение через onReject.
  • Собери AsyncQueuer для загрузки файлов с ограничением числа параллельных задач.

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

1Через Skills CLI (Vercel)

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

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

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

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

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

Вопросы о tanstack-pacer

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

Выполните npx skills add oakoss/agent-skills --skill tanstack-pacer -a claude-code. Скилл появится по пути ~/.claude/skills/tanstack-pacer/SKILL.md.

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

Описывает для агента API TanStack Pacer: дебаунс, троттлинг, лимиты, очереди и батчинг, а также React-хуки и список частых ошибок.

Чем debounce отличается от throttle в Pacer?

Дебаунс ждёт паузы в вызовах, троттлинг держит ровный интервал. У Debouncer нет maxWait, так что для гарантированной частоты берут Throttler.

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

SKILL.md · MIT
---
name: tanstack-pacer
description: 'TanStack Pacer for rate limiting, throttling, debouncing, and async queuing. Use when controlling execution frequency, managing API rate limits, debouncing user input, or queuing async tasks. Use for pacer, throttle, debounce, rate-limit, queue, async-throttle, rate-limiting.'
license: MIT
metadata:
  author: oakoss
  version: '1.1'
  source: 'https://tanstack.com/pacer/latest'
user-invocable: false
---

# TanStack Pacer

## Overview

TanStack Pacer is a lightweight, type-safe library for controlling function execution timing through debouncing, throttling, rate limiting, queuing, and batching. It provides framework-agnostic core classes with dedicated React hooks at multiple abstraction levels (instance, callback, state, value).

**When to use:** Debouncing search input, throttling scroll/resize handlers, enforcing API rate limits, queuing async tasks with concurrency control, batching multiple operations into single requests.

**When NOT to use:** Simple one-off delays (use `setTimeout`), server-side rate limiting at the infrastructure level (use middleware/API gateway), complex job scheduling (use a task queue like BullMQ).

## Quick Reference

| Pattern           | API                                         | Key Points                                                 |
| ----------------- | ------------------------------------------- | ---------------------------------------------------------- |
| Debounce function | `Debouncer` / `debounce(fn, opts)`          | Waits for inactivity; no `maxWait` option by design        |
| Throttle function | `Throttler` / `throttle(fn, opts)`          | Even spacing; `leading` and `trailing` both default `true` |
| Rate limit        | `RateLimiter` / `rateLimit(fn, opts)`       | Fixed or sliding window; rejects calls over limit          |
| Queue items       | `Queuer` / `queue(fn, opts)`                | FIFO default; supports LIFO, priority, expiration          |
| Async queue       | `AsyncQueuer` / `asyncQueue(fn, opts)`      | Concurrency control, retry, error callbacks                |
| Async batch       | `AsyncBatcher` / `asyncBatch(fn, opts)`     | Collects items, processes as batch after wait/maxSize      |
| React debounce    | `useDebouncer` / `useDebouncedCallback`     | Instance hook vs simple callback hook                      |
| React throttle    | `useThrottler` / `useThrottledCallback`     | Instance hook vs simple callback hook                      |
| React rate limit  | `useRateLimiter` / `useRateLimitedCallback` | Instance hook vs simple callback hook                      |
| React queue       | `useQueuer` / `useQueuedState`              | Instance hook vs state-integrated hook                     |
| React async queue | `useAsyncQueuer` / `useAsyncQueuedState`    | Concurrency + state management                             |
| React batch       | `useBatcher` / `useAsyncBatcher`            | Sync and async batching hooks                              |
| State hooks       | `useDebouncedState`, `useThrottledState`    | Integrate with React state directly                        |
| Value hooks       | `useDebouncedValue`, `useThrottledValue`    | Create derived debounced/throttled values                  |

## Common Mistakes

| Mistake                                 | Correct Pattern                                                              |
| --------------------------------------- | ---------------------------------------------------------------------------- |
| Using `maxWait` on Debouncer            | Debouncer has no `maxWait`; use Throttler for evenly spaced execution        |
| Creating instances inside render        | Create with hooks (`useDebouncer`, `useThrottler`) to manage lifecycle       |
| Ignoring `maybeExecute` return          | Rate limiter and throttler may reject calls; check state or use callbacks    |
| Using debounce when throttle is needed  | Debounce waits for pause; throttle guarantees max-once-per-interval          |
| Not cleaning up on unmount              | React hooks handle cleanup automatically; manual instances need `cancel()`   |
| Using Queuer when items can be dropped  | Queuers process every item; use throttle/debounce if dropping is acceptable  |
| Fixed window when sliding is needed     | Fixed windows allow bursts at boundaries; sliding window gives smoother rate |
| Forgetting `onReject` on RateLimiter    | Rejected calls are silent by default; add `onReject` for user feedback       |
| Not passing `enabled: false` to disable | All utilities support `enabled` option to temporarily disable processing     |

## Delegation

> If the `tanstack-query` skill is available, delegate data fetching and cache management tasks to it. TanStack Pacer complements Query for controlling request frequency.
> Otherwise, recommend: `npx skills add oakoss/agent-skills --skill tanstack-query`

- **Execution timing patterns**: Use this skill
- **Data fetching and caching**: Delegate to `tanstack-query`
- **Component architecture**: Delegate to framework-specific skills

## References

- [Throttle and debounce patterns](references/throttle-debounce.md)
- [Rate limiting patterns](references/rate-limiting.md)
- [Queuing and async queuing](references/queuing.md)
- [React hooks and integration](references/react-integration.md)

© oakoss · MIT · oakoss/agent-skills

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

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

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

tanstack-pacer tanstack-skills Скилл tanstack-pacer для Claude Code помогает выбирать и применять утилиты управления вызовами функций. Он включается при задачах с задержкой, ограничением частоты, очередями или пакетной обработкой. CX Codex +1 3 900установок vueuse-shared-skilld skilld-dev Скилл vueuse-shared-skilld добавляет в Claude Code, Cursor и другие редакторы знание API @vueuse/shared v15.0.0 — фреймворк-агностичных реактивных утилит для Vue. CX Codex +1 137установок 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-virtual tanstack-skills Скилл подсказывает агенту, как подключить TanStack Virtual и рисовать только видимые строки в больших списках, таблицах и сетках. CX Codex +1 2 600установок tanstack-start-cursorrules-prompt-file PatrickJS Правило tanstack-start-cursorrules-prompt-file для Cursor описывает структуру TanStack Start и типобезопасную разработку с SSR. Активируется в проектах Start, маршрутах TanStack Router и конфигурации Vinxi. CX Codex +1 ★ 41 178звёзд репо

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

Весь набор →
python-uv Скилл python-uv обучает ИИ-агента вести Python-проекты через uv: от uv init и управления зависимостями до рабочих пространств и сборки пакетов. Помогает отказаться от связки pip и poetry. CX Codex +1 129установок 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-devtools Скилл tanstack-devtools учит агента настраивать отладку кэша Query, дерева Router и полей Form в React-приложениях с библиотеками TanStack. CX Codex +1 125установок 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установок

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

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