emacs-debugging

Automate Emacs Lisp debugging with edebug, tracing, and profiling workflows.

1|Updated Dec 14, 2025
One-click install
npx skills add https://github.com/jingtaozf/emacs-claude-agent --skill emacs-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: emacs-debugging
Source: https://github.com/jingtaozf/emacs-claude-agent/tree/main/.claude/skills/emacs-debugging
Command: npx skills add https://github.com/jingtaozf/emacs-claude-agent --skill emacs-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debugging Emacs Lisp code can be time-consuming and error-prone. This skill provides structured patterns for edebug, tracing, error handling, and profiling to diagnose and fix elisp issues efficiently.

Core Features & Use Cases

  • edebug interactive stepping and instrumenting functions to isolate problems.
  • Function tracing and logging to reveal call sequences and returns.
  • Error handling, backtraces, and profiler-based performance insights for optimization.

Quick Start

Instrument your elisp function with edebug and step through expressions to identify issues.

Frequently Asked Questions about emacs-debugging

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

FAQPage Schema
How do I debug Emacs Lisp errors using edebug?

To debug Emacs Lisp errors, instrument your elisp function with edebug to step through expressions interactively, isolating problems and diagnosing mysterious issues efficiently.

What is the best way to trace function calls in Emacs Lisp?

Tracing function calls in Emacs Lisp involves using trace utilities to reveal call sequences and returns, providing structured logging patterns to diagnose behavior without manual print statements.

How do I profile performance bottlenecks in Emacs Lisp code?

Profiling performance bottlenecks in Emacs Lisp requires using the built-in profiler to measure execution time, applying performance insights to optimize elisp code and identify slow functions.

How does condition-case error handling work for Emacs Lisp debugging?

Condition-case error handling captures elisp errors during execution, allowing you to generate backtraces and analyze failure conditions systematically to diagnose mysterious errors.

Can I use edebug to step through macro expansions in Emacs Lisp?

Edebug supports stepping through Emacs Lisp code expressions, and combined with macro-expansion techniques, you can isolate issues within expanded code to identify problems efficiently.