Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

input-handling

/input-handling

Doradza w obsłudze wejścia w aplikacjach terminalowych: tryb raw, parsowanie klawiatury, mysz, wklejanie, fokus, formularze i projekt skrótów klawiszowych.

Licencja
MIT
Ostatnia zmiana repozytorium
18.06.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 18.06.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Doradza w obsłudze wejścia w aplikacjach terminalowych: tryb raw, parsowanie klawiatury, mysz, wklejanie, fokus, formularze i projekt skrótów klawiszowych.

Oryginalny opis (EN)

This skill should be used when the user asks about TUI input handling, raw mode, cbreak mode, terminal keyboard parsing, Esc vs Alt ambiguity, Ctrl-C, shortcuts, focus management, mouse events, scroll wheel, bracketed paste, paste safety, command palettes, forms, text editing, resize events, or keybinding design. PROACTIVELY activate for: raw mode, keyboard input, keybindings, mouse support, paste handling, focus model, terminal forms, text input, vim/emacs-style shortcuts, input conflicts, and cross-platform Windows/macOS/Linux input behavior. Provides: input architecture, shortcut rules, foc

Jak działa

  1. Input contract
  2. Raw mode rules
  3. Keybinding design
  4. Focus model
  5. Paste and mouse safety
  6. Failure modes
  7. Reference files
Sekcje z nagłówków SKILL.md, w oryginale · 59 linii, 430 słów
Podgląd SKILL.md
---
name: input-handling
description: |
  This skill should be used when the user asks about TUI input handling, raw mode, cbreak mode, terminal keyboard parsing, Esc vs Alt ambiguity, Ctrl-C, shortcuts, focus management, mouse events, scroll wheel, bracketed paste, paste safety, command palettes, forms, text editing, resize events, or keybinding design. PROACTIVELY activate for: raw mode, keyboard input, keybindings, mouse support, paste handling, focus model, terminal forms, text input, vim/emacs-style shortcuts, input conflicts, and cross-platform Windows/macOS/Linux input behavior. Provides: input architecture, shortcut rules, focus patterns, paste/mouse safety, and failure-mode triage.
---

# TUI Input Handling, Raw Mode, Keyboard, Mouse, Paste, and Focus

Use this skill when a TUI reads keys, handles shortcuts, supports mouse, edits text, manages focus, or needs safe paste behavior.

## Input contract

- Only enter raw or cbreak mode for interactive TTY sessions.
- Provide non-interactive alternatives for scripts, pipes, and CI.
- Keep input decoding separate from application actions.
- Make every action reachable by keyboard.
- Treat mouse support as optional progressive enhancement.
- Preserve expected terminal shortcuts unless the user can rebind them.

## Raw mode rules

Raw mode disables line discipline and changes signal behavior. Centralize it and restore it reliably. Verify behavior for Ctrl-C, Ctrl-Z/suspend where supported, EOF, resize, terminal close, and fatal exceptions. Passwords and tokens must not echo.

## Keybinding design

Good keybindings are discoverable, consistent, and conflict-aware.

- Always provide visible help for common actions.
- Use `q`, Esc, or Ctrl-C for quit/cancel only when consistent with workflow risk.
- Confirm destructive actions; require stronger confirmation for irreversible work.
- Avoid stealing common terminal, shell, editor, and multiplexer shortcuts unless configurable.
- Support both mnemonic shortcuts and navigational keys where possible.
- Distinguish global shortcuts from focused-widget shortcuts.

## Focus model

Every interactive element needs:

- A stable identity.
- Focus eligibility rules.
- A visible focus indicator that does not rely on color alone.
- Tab/Shift-Tab or arrow navigation when appropriate.
- Clear behavior for disabled, hidden, modal, and nested controls.
- Mouse click behavior that updates focus before activating actions.

## Paste and mouse safety

Enable bracketed paste for shells, editors, command palettes, and multiline inputs. Parse paste start/end markers and treat pasted text as data, not a sequence of commands. For mouse input, validate coordinates against the current layout and ignore stale events after resize.

## Failure modes

| Symptom | Likely cause | Fix |
|--|--|--|
| Esc feels delayed | parser waiting to distinguish Alt prefix | tune timeout or use framework protocol support |
| Ctrl-C does not exit | raw mode swallowed signal | map Ctrl-C explicitly and restore terminal |
| Paste triggers actions | no bracketed paste or paste treated as keystrokes | enable paste protocol and route as text |
| Mouse clicks wrong row | stale layout after resize or scroll | validate coordinates against current viewport |
| Focus disappears | no focused fallback after removing widget | compute next eligible focus target |

## Reference files

- `references/input-protocols.md` - Keyboard, mouse, paste, focus, and resize event details.
- `references/keybinding-design.md` - Shortcut design, conflict avoidance, and forms/editors.
Pliki w paczce (3)
  • SKILL.md 3 KB
  • references/input-protocols.md 2 KB
  • references/keybinding-design.md 1 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · JosiahSiegel/claude-plugin-marketplace90MIT
zenobi-us/dotfiles100MIT
jame581/godotprompter100MIT

Migawka bazy z 13.11.2026 · wersja paczki 8021c2268976 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100tui-troubleshooting
    Diagnozuje awarie interfejsów terminalowych: zawieszenia, pusty ekran, utknięty raw mode, zepsute kolory i kursor oraz różnice w SSH, tmux i ConPTY.
  • 85keyboard-shortcuts
    Pomaga dodawać skróty klawiszowe, rozwiązywać konflikty i sprawdzać zgodność z vimem oraz tabelę przypisań we wtyczkach.
  • 100cursor-keybindings
    Uczy skrótów klawiszowych Cursor i dopasowania skrótów do funkcji AI i poleceń edytora.
  • 100cursor-keybindings
    Uczy skrótów klawiszowych Cursor i ich dostosowywania do własnych potrzeb.
  • 100keyboard-shortcuts
    Audytuje aplikację webową pod kątem brakujących skrótów klawiszowych i wdraża je: rejestr poleceń, paleta poleceń, podpowiedzi kbd, arkusz pomocy, testy oraz zgodność z WCAG 2.1.4.
  • 100terminal-ui
    Podaje wytyczne wydajności i UX dla interfejsów terminalowych (TUI) w TypeScript z Ink i Clack: komponenty, prompty CLI, renderowanie i obsługa klawiatury.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.