What problem does it solve?
This Skill helps developers who manage a complex Emacs configuration in their dotfiles by automatically validating structure, syntax, and conventions to prevent startup errors and drift.
Core Features & Use Cases
- Module validation: checks all init-*.el modules for correct (provide) endings, balanced parentheses, and consistent use-package declarations.
- Cross-platform safeguards: analyzes OS-specific guards in init-platform.el and related files to ensure reliable behavior on macOS, Linux/WSL, and Windows.
- Keybinding integrity: detects conflicting keybindings across modules to minimize startup confusion and override risks.
- Quick-start workflow: run the included scripts to validate modules, detect issues, and provide actionable fixes for Emacs configuration.
Quick Start
Run: .claude/skills/emacs-config/scripts/validate.sh
Optionally target a specific module: .claude/skills/emacs-config/scripts/validate.sh init-ai