emacs-introspection

Inspect Emacs Lisp symbols for documentation, argument lists, and source locations.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Empowers Emacs users to quickly discover function docs, source code, keybindings, and mode information by evaluating elisp expressions.

Core Features & Use Cases

  • Function introspection: view documentation, argument lists, and source locations for Elisp symbols.
  • Keybinding & mode discovery: identify commands bound to keys and inspect major/minor modes and their maps.
  • Use Case: when configuring Emacs, you can inspect a symbol to understand its behavior and usage.

Quick Start

Use evalElisp to inspect a function's documentation, source location, and keybindings in Emacs.

Frequently Asked Questions about emacs-introspection

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

FAQPage Schema
How do I find the documentation and argument list for an Emacs function?

To find Emacs function documentation, introspection identifies Elisp symbols to reveal their docstrings, argument lists, and source locations. It evaluates Elisp expressions using the mcp__emacs__evalElisp tool to return structured metadata for the specified symbol.

Can I discover keybindings and major modes in my Emacs configuration?

Yes, you can discover keybindings and major modes in Emacs. The introspection process identifies commands bound to specific keys and inspects major and minor modes along with their keymaps to map behavior and usage patterns across your configuration.

Do I need to install Emacs packages to inspect Elisp symbols?

You do not need to install extra Emacs packages to inspect Elisp symbols. The process requires Emacs with Elisp support and the mcp__emacs__evalElisp tool to evaluate expressions and output structured metadata like interactive status and bound keys.

How do I check if an Emacs function is interactive?

To check if an Emacs function is interactive, evaluate the symbol using the mcp__emacs__evalElisp tool. The introspection output returns structured metadata including a boolean interactive status, function documentation, and source location.

What is the best way to inspect Emacs hooks and modes?

The best way to inspect Emacs hooks and modes is evaluating Elisp expressions to map their behavior. This introspection applies across functions, commands, packages, modes, and hooks to reveal source locations and usage patterns within your environment.

Why does Emacs introspection require the evalElisp tool?

Emacs introspection requires the evalElisp tool because it provides the execution environment to query live Emacs Lisp symbols. Without evaluating Elisp expressions, the system cannot extract the structured metadata like argument lists, bound keys, and docstrings.