| name | keybindings_customizer |
| description | Use when the user wants to customize Claude Code keybindings, rebind shortcuts, add chords, or edit `~/.claude/keybindings.json` safely. |
Keybindings Customizer
Use this skill for shortcut rebinding, unbinding, or chord creation.
Workflow
- Read the current keybindings file first.
- Merge changes instead of replacing the entire file.
- Keep schema and docs fields intact.
- Validate against reserved and non-rebindable shortcuts.
- Explain any conflicts or terminal-level limitations.
Guardrails
- Never overwrite the full file blindly.
- Preserve unrelated existing bindings.
- Flag OS or terminal-reserved shortcuts before saving.
Example Requests
- Rebind the external editor shortcut.
- Add a chord to toggle todos without overwriting my keybindings file.
Inputs
- Requested key changes
- Existing keybindings file
- OS or terminal constraints
Outputs
- Merged keybinding config
- Conflict explanations
Success Criteria
- The file was merged, not clobbered.
- Reserved shortcuts were handled correctly.
- Schema and docs fields remain intact.
Non-Goals
- Whole-file replacement for a small binding change
Source Provenance
Derived from src/skills/bundled/keybindings.ts.
