keybinding-collision-check

Validate keybindings for ASCII and control-key collisions with core terminal behavior.

12|1|Updated Oct 31, 2025
One-click install
npx skills add https://github.com/robkam/ytreenova --skill keybinding-collision-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: keybinding-collision-check
Source: https://github.com/robkam/ytreenova/tree/main/.ai/skills/keybinding-collision-check
Command: npx skills add https://github.com/robkam/ytreenova --skill keybinding-collision-check

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validate ytnova keybinding changes for ASCII/control-key collisions and keep menus/help/tests synchronized.

Core Features & Use Cases

  • Collision rules to prevent bindings that collide with core terminal behavior (Tab, Enter, Escape) and to preserve VI navigation when VI_KEYS is enabled.
  • Synchronization of input handling, footer/menu/help text, tests, and configuration surfaces to maintain consistent behavior.
  • Use Case: When adding or changing keybindings, run this check to ensure surfaces remain reachable and all related UI elements stay consistent.

Quick Start

Run the check after adding or updating keybindings to verify there are no collisions and to propagate updates to menus and help text.

Frequently Asked Questions about keybinding-collision-check

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check for terminal keybinding collisions when adding new keyboard shortcuts?

To check for terminal keybinding collisions, run a validation routine that detects ASCII and control-key conflicts with core terminal behavior like Tab, Enter, and Escape. This ensures new keyboard shortcuts do not override existing navigation rules or break UI synchronization across all surfaces.

Why do my custom keyboard shortcuts conflict with VI_KEYS navigation in the terminal?

Custom keyboard shortcuts conflict with VI_KEYS navigation when they collide with reserved ASCII or control keys. Running a collision detection check verifies that new bindings preserve VI navigation rules and prevents overlapping input handling in terminal UIs.

What is the best way to synchronize help text and menus after changing keybindings?

The best way to synchronize help text and menus after changing keybindings is to run a synchronization check. This propagates updates across input handling, footer text, and configuration surfaces to maintain consistent behavior and reachability across all UI elements.

Does this keybinding validation support both default and VI_KEYS terminal builds?

Yes, this keybinding validation supports both default and VI_KEYS terminal builds. It enforces deterministic behavior by checking collision rules and synchronization across all UI surfaces, ensuring consistent input handling regardless of the active navigation mode.

When should I run a keybinding collision check during UI development?

You should run a keybinding collision check immediately after adding or updating keyboard shortcuts. This prevents ASCII and control-key collisions with core terminal behavior and ensures menus, help text, and tests remain synchronized before deploying UI changes.