keybind-audit
Analyze keybindings across all dotfiles for conflicts, duplicates, and inconsistencies. Use when modifying keybindings or checking for conflicts.
When & Why to Use This Skill
The Keybind Audit skill is a specialized utility designed for developers to maintain and optimize their terminal environments. It systematically scans dotfiles—including configurations for Vim, Neovim, Tmux, Zsh, and Alacritty—to detect keyboard shortcut conflicts, duplicate mappings, and inconsistencies. By providing a centralized audit of keybindings, it ensures a seamless workflow and prevents command interference across different command-line tools.
Use Cases
- Resolving Cross-Tool Conflicts: Identify when the same key combination (e.g., Ctrl+B) is mapped to different functions in Tmux and Zsh to prevent unexpected behavior.
- Dotfile Refactoring and Cleanup: Detect duplicate mappings across multiple files, such as redundant navigation settings in both .vimrc and Neovim lua configurations.
- Workflow Standardization: Ensure consistent navigation patterns (like HJKL or leader-key sequences) are applied uniformly across all terminal-based applications and plugins.
- Pre-Modification Safety Checks: Run an audit before adding new complex keybindings to ensure they don't shadow important defaults or conflict with existing shortcuts.
| name | keybind-audit |
|---|---|
| description | Analyze keybindings across all dotfiles for conflicts, duplicates, and inconsistencies. Use when modifying keybindings or checking for conflicts. |
Keybind Audit
Analyze keybindings across all configuration files in this dotfiles repository.
When to use
- User wants to add or modify a keybinding
- User asks about keybinding conflicts
- User wants to check consistency across tools
Target files
| Tool | File | Pattern |
|---|---|---|
| zsh | dot_zshrc.tmpl |
bindkey |
| tmux | dot_tmux.conf |
bind, bind-key |
| vim | dot_vimrc |
nnoremap, vnoremap, inoremap, cnoremap |
| neovim | dot_config/nvim/lua/keymap.lua |
vim.keymap.set, nvim_set_keymap |
| neovim plugins | dot_config/nvim/lua/plugin_configs/*.lua |
vim.keymap.set, keymaps in setup() |
| obsidian | dot_obsidian.vimrc |
nmap, vmap, exmap |
| alacritty | dot_config/alacritty/alacritty.toml |
[[keyboard.bindings]] |
Analysis checklist
Cross-tool conflicts: Same key combo, different behavior across tools
- Focus on: Ctrl+key, Alt+key, leader combinations
- Example:
<C-g>in tmux vs zsh
Duplicates: Same keybinding defined multiple times within one tool
- Example:
j -> gjin both dot_vimrc and nvim/lua/keymap.lua
- Example:
Consistency: Check vim-style navigation unity
- Are hjkl mapped consistently?
- Is
<leader>fj/fk/flpattern consistent?
Shadowed defaults: Overwritten important defaults that may cause confusion
Dead bindings: Commented-out bindings that might be worth revisiting
Output format
Group by severity:
Conflicts (must fix)
- Key:
<C-x> - Tools: tmux (kill-pane) vs zsh (execute)
- Recommendation: ...
Duplicates (should fix)
- Key:
j -> gj - Files: dot_vimrc:1, keymap.lua:9
- Recommendation: Keep only in keymap.lua
Inconsistencies (consider)
- ...
Info
- ...