| name | highlight |
| description | This skill should be used when the user invokes "/highlight" to highlight relevant regions in one or more files in Emacs via emacsclient. |
| tools | Bash |
| disable-model-invocation | true |
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.
