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