tanstack-pacer · oakoss — скилл для Claude Code: что делает и как установить
Скилл для Claude Code даёт агенту карту TanStack Pacer: дебаунс, троттлинг, лимиты, очереди и React-хуки. Ограничивает частоту срабатывания обработчиков и запросов.
MIT 126 установок ★ 29 обновлён 2026-08-17
npx skills add oakoss/agent-skills --skill tanstack-pacer -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/tanstack-pacer/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/tanstack-pacer/
1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill tanstack-pacer -a codex2Вручную: положить файлы
.agents/skills/tanstack-pacer/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill tanstack-pacer -a cursor2Вручную: положить файлы
.cursor/skills/tanstack-pacer/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install oakoss/agent-skills skills/tanstack-pacer2Вручную: положить файлы
.github/skills/tanstack-pacer/SKILL.md1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill tanstack-pacer -a gemini-cli2Командой платформы
gemini skills install https://github.com/oakoss/agent-skills --path skills/tanstack-pacerВручную: положить файлы
.devin/skills/tanstack-pacer/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill tanstack-pacer -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.