Menu
Update doom emacs and/or packages — runs doom upgrade, handles errors, summarizes what changed
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
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
Systematically debug a doom emacs issue — errors, broken packages, slow startup, keybinding conflicts
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
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-update |
| description | Update doom emacs and/or packages — runs doom upgrade, handles errors, summarizes what changed |
| argument-hint | [--packages-only | --doom-only] |
| allowed-tools | Bash, Read, Grep |
Update doom emacs core and/or installed packages.
doom upgrade)--packages-only → skip doom core, only update pinned/unpinned packages (doom sync -u)--doom-only → pull doom core repo only, then sync~/.config/emacs/bin/doom info 2>&1 | grep -E "Doom|Emacs version"
git -C ~/.config/emacs log --oneline -1
Full upgrade (default):
~/.config/emacs/bin/doom upgrade 2>&1
Packages only:
~/.config/emacs/bin/doom sync -u 2>&1
| Error | Fix |
|---|---|
| Byte-compile error on a package | doom sync --rebuild to force recompile |
| Straight.el lock conflict | doom sync --force |
| Stale native-comp cache | rm -rf ~/.config/emacs/eln-cache && doom sync |
| Package removed from MELPA | Pin it in packages.el with :pin "last-good-sha" or :recipe (:host github ...) |
| Doom core update broke something | git -C ~/.config/emacs log --oneline -20 to see what changed; check doom's changelog |
After a doom core update, check for release notes:
git -C ~/.config/emacs log --oneline ORIG_HEAD..HEAD 2>/dev/null | head -20
Flag any commits mentioning "breaking", "removed", or "deprecated" to the user.
Remind the user to:
doom/reload) after a core updateM-x doom/reload inside Emacs after a packages-only update*Warnings* buffer on next startup for any new issues