| name | elisp-compile |
| description | Validate byte compilation for a specified Emacs Lisp file in this repository. Use this skill when an agent needs a focused compile check for one `.el` file; on success it removes the generated `.elc` artifact. |
Elisp Compile
Use this skill to run a single-file batch byte-compile check and leave the worktree clean afterward.
Workflow
- Pass exactly one
.el file path to ./bin/elisp-compile.sh.
- The command runs
emacs -Q --batch --eval "(setq load-prefer-newer t)" -L . -f batch-byte-compile FILE.
- If compilation succeeds, it deletes the generated
.elc file before exiting.
- If compilation fails, it leaves the
.elc artifact state unchanged and returns the compiler error.
Notes
- Use the explicit repo-root path above; do not reinterpret it relative to
SKILL.md.
- The command resolves repo-relative paths against the repository root.
- This is for targeted validation, not full-suite testing.
- Use the cleanup skill directly when
.elc artifacts already exist from other commands.