メニュー
Systematically debug a doom emacs issue — errors, broken packages, slow startup, keybinding conflicts
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
Add a new Emacs package to this doom config — packages.el declaration, config.org section, and doom sync
Run static analysis and byte-compile checks on the Doom config without opening Emacs
Look up a Doom Emacs module's documentation, flags, and packages before configuring anything manually. Use this when the user asks about adding a feature, package, or integration to Doom.
Run doom sync after config changes and diagnose any errors
Update doom emacs and/or packages — runs doom upgrade, handles errors, summarizes what changed
Expert Emacs Lisp programmer and Doom Emacs architect. Use when writing custom packages, configuring complex behaviors, debugging elisp, designing abstractions, or any task that requires deep Emacs/Doom knowledge.
| name | doom-debug |
| description | Systematically debug a doom emacs issue — errors, broken packages, slow startup, keybinding conflicts |
| argument-hint | <description of the issue> |
| allowed-tools | Read, Grep, Bash |
Systematically diagnose and fix a doom emacs issue.
$ARGUMENTS
Ask the user: does the issue appear with emacs --init-directory ~/.config/emacs -q?
config.org) is the cause → proceed to step 3~/.config/emacs/bin/doom doctor 2>&1 | grep -E "(✗|Warning|Error)" | head -40
Fix any reported issues first.
git -C ~/.config/doom log --oneline -10
git -C ~/.config/doom diff HEAD~1 -- config.org packages.el init.el
Correlate the issue onset with recent commits.
Grep config.org for the package/feature name mentioned in the issue. Read surrounding context.
~/.config/emacs/bin/doom sync --rebuild 2>&1 | grep -i "error\|warning" | head -30
Ask user to run inside Emacs:
M-x view-echo-area-messages — recent messages*Messages* buffer — startup output*Warnings* buffer — non-fatal issuesIf there's a backtrace or error message, grep config.org and installed package sources:
find ~/.config/emacs/.local/straight/repos -name "*.el" | xargs grep -l "SYMBOL" 2>/dev/null | head -10
| Symptom | Likely cause | Fix |
|---|---|---|
Symbol's function definition is void | package not loaded yet | Add :defer nil or (after! pkg ...) |
| Keybinding not working | wrong keymap or evil state | Check map! evil state flag (:n, :i, etc.) |
| Package not found after sync | typo or wrong :recipe | Check packages.el |
| Slow startup | too many :demand t or no :defer | Profile with M-x esup |
Wrong type argument | config loaded before package | Wrap in (after! package ...) |
| Native comp warnings | stale eln cache | rm -rf ~/.config/emacs/eln-cache && doom sync |
After diagnosis: