highlight

SKILL.md

Highlight regions in Emacs

Highlight relevant regions in one or more files in Emacs using emacsclient --eval. Files are opened in a temporary read-only minor mode with highlighted overlays. The user presses q to exit the mode and remove all highlights in that buffer.

Determine the relevant files and line ranges from the most recent interaction context.

How to highlight

First, determine the path to agent-skill-highlight.el. It lives alongside this skill file at skills/highlight/agent-skill-highlight.el in the emacs-skills plugin directory.

emacsclient --eval '
(progn
  (load "/path/to/skills/highlight/agent-skill-highlight.el" nil t)
  (agent-skill-highlight
    :files (quote (("/path/to/file1.el"
                    :regions ((:start 90 :lines 18)
                              (:start 114 :lines 49)))
                   ("/path/to/file2.el"
                    :regions ((:start 94 :lines 18)))))))'
  • :start is the 1-indexed line number.
  • :lines is the number of lines to highlight from that start line.
  • Add as many files and regions as needed.

Rules

  • Use absolute paths for files.
  • Locate agent-skill-highlight.el relative to this skill file's directory.
  • If no relevant files or regions exist in the recent interaction, inform the user.
  • Run the emacsclient --eval command via the Bash tool.
Weekly Installs
11
GitHub Stars
49
First Seen
Feb 26, 2026
Installed on
opencode11
github-copilot11
codex11
amp11
kimi-cli11
gemini-cli11