메뉴
Systematically debug a doom emacs issue — errors, broken packages, slow startup, keybinding conflicts
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| 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:
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.