elisp-review

Identify Emacs Lisp quality issues and provide remediation guidance.

1|1|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/Jylhis/skills --skill elisp-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: elisp-review
Source: https://github.com/Jylhis/skills/tree/main/skills/elisp-review
Command: npx skills add https://github.com/Jylhis/skills --skill elisp-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Emacs Lisp developers need a structured way to identify quality and compatibility issues in .el files, preventing runtime errors and unmaintained code.

Core Features & Use Cases

  • Static pattern checks to catch lexical-binding, provide/require, and modern API usage.
  • Phase 2 byte-compilation checks to surface undefined functions, wrong arguments, and defcustom issues during batch processing.
  • Phase 3 semantic review to ensure consistent API usage, robust error handling, and documentation quality for public functions.
  • Use cases include auditing legacy Emacs Lisp libraries, validating packages before release, and performing quick QA on new Elisp scripts.

Quick Start

Run the elisp-review tool on target-file.el to start a guided review and remediation plan.

Frequently Asked Questions about elisp-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check Emacs Lisp code quality before releasing a package?

To check Emacs Lisp code quality before release, run a structured static analysis review on your .el files to identify lexical-binding issues, enforce cl-lib usage, and validate provide/require statements. This surfaces undefined functions and defcustom metadata issues for actionable remediation.

What is the best way to audit legacy Emacs Lisp libraries for modern API usage?

Auditing legacy Emacs Lisp libraries for modern API usage involves a semantic review process that checks for consistent API patterns, proper cl-lib adoption, and robust error handling. This structured review ensures public functions meet documentation quality standards and compatibility requirements.

How does byte-compilation check work for Emacs Lisp static analysis?

Byte-compilation checks for Emacs Lisp static analysis work by running batch processing on target files to surface undefined functions, wrong argument counts, and defcustom issues. This phase identifies runtime risks that static pattern matching alone might miss during code review.

Can I validate lexical-binding and defcustom metadata in Elisp scripts?

You can validate lexical-binding and defcustom metadata in Elisp scripts through static pattern checks designed for Emacs Lisp codebases. These checks enforce proper provide/require usage and ensure defcustom definitions include required metadata for package compatibility.

Why does my Emacs Lisp review report undefined functions during batch checks?

Your Emacs Lisp review reports undefined functions during batch checks because the byte-compilation phase identifies missing function definitions and incorrect argument counts across target .el files. This surfaces potential runtime errors requiring remediation before package release or deployment.

Does elisp-review work without external dependencies or components?

Yes, elisp-review operates without external dependencies or components, running static analysis and semantic reviews directly on target Emacs Lisp files. This allows you to perform code audits and generate remediation guidance without installing additional packages or configuring complex environments.