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

tanstack-hotkeys — скилл для Claude Code: хоткеи в React

Скилл для агента: подсказывает, как собрать горячие клавиши в React на TanStack Hotkeys — от одиночных комбинаций до записи пользовательских шорткатов.

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

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

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

Скилл даёт агенту справочник по хукам TanStack Hotkeys. Внутри — useHotkey для одной комбинации, useHotkeySequence для цепочек в духе Vim вроде g g, useHotkeyRecorder для записи пользовательских шорткатов. Отдельно идут useKeyHold и useHeldKeys: первый отвечает за одну зажатую клавишу, второй отдаёт список всех нажатых. Общие настройки собирает HotkeysProvider, подписи под платформу рисует formatForDisplay.

Вместо Ctrl в комбинации пишется Mod — библиотека сама разложит его в Cmd на macOS и Ctrl на Windows/Linux. Комбинации с модификатором гасят поведение браузера без отдельной настройки. А вот tabIndex на элементе с опцией target нужен обязательно: без него фокус туда не перейдёт, и хоткей промолчит. С eventType: 'keyup' не забудьте requireReset: true, иначе обработчик будет срабатывать повторно.

Часть работы скилл отдаёт соседям по репозиторию: троттлинг колбэков — скиллу tanstack-pacer, настройку DevTools — tanstack-devtools. Если их в проекте нет, предложит доустановить. Основная цель — React, для приложений на других фреймворках нужна обёртка.

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

  • повесить горячую клавишу на действие в React-компоненте
  • собрать цепочку клавиш в стиле Vim (g g)
  • дать пользователю записать собственный шорткат
  • показать подпись шортката по-разному на macOS и Windows
  • отследить зажатую клавишу без лишних ререндеров

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

  • Добавь в CommandPalette хоткей Mod+K через useHotkey
  • Сделай запись пользовательских шорткатов на useHotkeyRecorder и выведи их через formatForDisplay
  • Нужна последовательность g g для прыжка к началу списка — собери её на useHotkeySequence

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

1Через Skills CLI (Vercel)

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

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

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

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

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

Вопросы о tanstack-hotkeys

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

Выполните npx skills add oakoss/agent-skills --skill tanstack-hotkeys -a claude-code. Файл скилла окажется по пути ~/.claude/skills/tanstack-hotkeys/SKILL.md.

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

Даёт агенту справочник по хукам TanStack Hotkeys: одиночные комбинации, последовательности клавиш, запись шорткатов, отслеживание зажатых клавиш и подписи под платформу.

Почему хоткей не срабатывает на моём элементе?

Проверьте tabIndex у элемента, который передан в опцию target. Без него фокус не переходит, и useHotkey молчит.

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

SKILL.md · MIT
---
name: tanstack-hotkeys
description: 'TanStack Hotkeys for type-safe keyboard shortcuts with React hooks. Use when adding keyboard shortcuts, hotkey sequences, shortcut recording, key hold detection, or platform-aware shortcut display. Use for hotkeys, keyboard-shortcuts, shortcuts, key-binding, Mod key, hotkey-recorder, key-sequences.'
license: MIT
metadata:
  author: oakoss
  version: '1.0'
  source: 'https://tanstack.com/hotkeys/latest'
user-invocable: false
---

# TanStack Hotkeys

## Overview

TanStack Hotkeys is a type-safe keyboard shortcuts library for React with template-string bindings, cross-platform `Mod` key abstraction (Cmd on macOS, Ctrl on Windows/Linux), and SSR-friendly utilities. It provides hooks for single hotkeys, multi-key sequences, shortcut recording, and real-time key state tracking, plus platform-aware display formatting.

**When to use:** Adding keyboard shortcuts to React apps, recording user-defined hotkeys, detecting held modifier keys, displaying platform-specific shortcut labels, implementing Vim-style key sequences.

**When NOT to use:** Non-React apps without a wrapper (core package exists but React is the primary target), complex input handling that needs full keymap management (consider a dedicated keymap library).

## Quick Reference

| Pattern              | API                   | Key Points                                                  |
| -------------------- | --------------------- | ----------------------------------------------------------- |
| Single hotkey        | `useHotkey`           | `Mod` abstracts Cmd/Ctrl; auto-prevents default on combos   |
| Multi-key sequence   | `useHotkeySequence`   | Vim-style sequences like `g g`; configurable timeout        |
| Record shortcuts     | `useHotkeyRecorder`   | User-defined shortcuts; start/stop/cancel recording         |
| Detect key held      | `useKeyHold`          | Boolean for specific key; optimized re-renders              |
| Track all held keys  | `useHeldKeys`         | Array of currently pressed key names                        |
| Track held key codes | `useHeldKeyCodes`     | Map of key names to physical `event.code` values            |
| Global defaults      | `HotkeysProvider`     | Set default options for all hooks; per-hook overrides apply |
| Format for display   | `formatForDisplay`    | Platform-aware: macOS symbols vs Windows/Linux text         |
| Scope to element     | `target` option + ref | Requires `tabIndex` on target element for focus             |
| Conditional hotkeys  | `enabled` option      | Dynamically enable/disable without unmounting               |

## Common Mistakes

| Mistake                                       | Correct Pattern                                                            |
| --------------------------------------------- | -------------------------------------------------------------------------- |
| Missing `tabIndex` on scoped target element   | Add `tabIndex={-1}` (or `0`) to elements using `target` ref for focus      |
| Using `Ctrl` instead of `Mod`                 | Use `Mod` for cross-platform; it maps to Cmd (Mac) or Ctrl (Win/Linux)     |
| Assuming hotkeys fire inside inputs           | `ignoreInputs` defaults to smart detection; set `false` to force firing    |
| Duplicate hotkey registrations without config | Set `conflictBehavior: 'replace'` to override, or `'error'` to catch       |
| Forgetting `preventDefault` is auto-enabled   | Modifier combos auto-prevent; set `preventDefault: false` to allow default |
| Using `keyup` without `requireReset`          | Combine `eventType: 'keyup'` with `requireReset: true` to fire once        |

## Delegation

> If the `tanstack-pacer` skill is available, delegate throttling and debouncing tasks to it. TanStack Pacer is useful for rate-limiting hotkey callbacks.
> Otherwise, recommend: `pnpm dlx skills add oakoss/agent-skills -s tanstack-pacer -a claude-code -y`
>
> If the `tanstack-devtools` skill is available, delegate devtools setup to it.
> Otherwise, recommend: `pnpm dlx skills add oakoss/agent-skills -s tanstack-devtools -a claude-code -y`

- **Keyboard shortcuts and hotkeys**: Use this skill
- **Throttling/debouncing hotkey callbacks**: Delegate to `tanstack-pacer`
- **DevTools integration**: Delegate to `tanstack-devtools`

## References

- [React hooks and configuration](references/react-hooks.md)
- [Sequences and recording](references/sequences-and-recording.md)
- [Formatting and display](references/formatting-and-display.md)

© oakoss · MIT · oakoss/agent-skills

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

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

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

Весь набор →
pnpm-workspace Скилл pnpm-workspace настраивает монорепозитории на базе pnpm и каталоги версий. Помогает агенту связывать локальные пакеты через протокол workspace:. CX Codex +1 195установок icon-design Скилл icon-design помогает выбрать подходящие по смыслу иконки из Lucide, Heroicons или Phosphor и настроить чистый импорт без поломки tree-shaking. CX Codex +1 187установок pdf-tools Скилл pdf-tools для Claude Code, Codex, Cursor, GitHub Copilot и Gemini CLI, который покрывает весь цикл работы с PDF: извлечение текста и таблиц, генерацию, изменение и заполнение форм. CX Codex +1 186установок ssh-remote Скилл ssh-remote помогает ассистенту настраивать SSH-подключения, генерировать ключи Ed25519, пробрасывать порты и безопасно передавать файлы. CX Codex +1 183установок technical-docs Скилл technical-docs для Claude Code помогает писать и обновлять техническую документацию, строить диаграммы Mermaid и сверять документацию с кодом. Помогает вести doc-as-code и проверять покрытие. CX Codex +1 177установок mermaid-diagrams Скилл mermaid-diagrams помогает создавать Mermaid-диаграммы в Markdown: от блок-схем и ERD до графиков, mindmap и архитектурных схем. CX Codex +1 177установок motion Скилл обучает ИИ-агента правильно применять библиотеку Motion (framer-motion) в React и Next.js. Помогает настроить жесты, скролл-эффекты и избежать просадок FPS. CX Codex +1 176установок shadcn-ui Учит агента работать с shadcn/ui: добавлять компоненты через CLI, настраивать темы на oklch и собирать формы с проверкой через Zod. CX Codex +1 176установок

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

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