Emacs Skills

https://github.com/xenodium/emacs-skills
Admin
Emacs Skills provides Claude Code integration tools for Emacs, enabling agents to open files, manage...
Tokens:9,336
Snippets:119
Trust Score:8.8
Update:5 months ago
Show doc for...
Tokens:
Raw
### Install emacs-skills Plugin

Source: https://github.com/xenodium/emacs-skills/blob/main/README.md

Install the emacs-skills plugin from the Claude plugin marketplace. Ensure you have the Claude CLI installed and configured.

```sh
claude plugin marketplace add xenodium/emacs-skills
claude plugin install emacs-skills@xenodium-emacs-skills
```

--------------------------------

### Requirements: Start Emacs Server

Source: https://context7.com/xenodium/emacs-skills/llms.txt

Ensures the Emacs server is running, which is necessary for `emacsclient` to connect. This can be started manually or configured to run on Emacs startup.

```sh
# Emacs server must be running
M-x server-start
# or add to init.el:
(server-start)
```

--------------------------------

### Create and Render Mermaid Diagram

Source: https://context7.com/xenodium/emacs-skills/llms.txt

This snippet demonstrates how to create a Mermaid diagram definition file and then render it into a PNG image using the `mmdc` command-line tool. Ensure `mmdc` is installed and accessible in your PATH.

```bash
cat > /tmp/agent-diagram-1700000000.mmd << 'EOF'
sequenceDiagram
    participant User
    participant Agent
    participant Emacs
    User->>Agent: /mermaid
    Agent->>Emacs: query foreground color
    Emacs-->>Agent: "#eeffff"
    Agent->>Agent: generate .mmd + config
    Agent->>Agent: run mmdc
    Agent-->>User: ![diagram](/tmp/...)
EOF
```

```bash
PUPPETEER_EXECUTABLE_PATH=/opt/homebrew/bin/chromium mmdc \
  -i /tmp/agent-diagram-1700000000.mmd \
  -o /tmp/agent-diagram-1700000000.png \
  -t dark -b transparent --scale 2 \
  --configFile /tmp/agent-diagram-1700000000-config.json
```

--------------------------------

### Install Emacs Skills Plugin

Source: https://context7.com/xenodium/emacs-skills/llms.txt

Commands to install, update, and uninstall the Emacs Skills plugin using the Claude Code CLI.

```sh
claude plugin marketplace add xenodium/emacs-skills
claude plugin install emacs-skills@xenodium-emacs-skills
```

```sh
claude plugin marketplace update xenodium-emacs-skills
```

```sh
claude plugin uninstall emacs-skills
```

--------------------------------

### Highlight Regions in Emacs using emacsclient

Source: https://github.com/xenodium/emacs-skills/blob/main/skills/highlight/SKILL.md

Use this command to highlight regions in Emacs. Ensure the path to `agent-skill-highlight.el` is correct and specify files with their start lines and number of lines to highlight. Press 'q' in Emacs to exit the highlight mode and remove overlays.

```bash
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)))))))
'
```

--------------------------------

### Requirements: External Tools Check

Source: https://context7.com/xenodium/emacs-skills/llms.txt

Checks for the presence of various external command-line tools required by specific Emacs skills. Ensure these are installed and in your PATH if you intend to use the corresponding skills.

```sh
# External tools (required only for the respective skills):
which d2          # /d2 skill
which plantuml    # /plantuml skill
which gnuplot     # /gnuplot skill
which mmdc        # /mermaid skill
```

--------------------------------

### Look up Emacs Documentation with emacsclient

Source: https://github.com/xenodium/emacs-skills/blob/main/skills/describe/SKILL.md

Use this command to search for Emacs documentation. Ensure `agent-skill-describe.el` is loaded and accessible.

```bash
emacsclient --eval \
'(progn
  (load "/path/to/skills/describe/agent-skill-describe.el" nil t)
  (agent-skill-describe :query "dired-mark"))'
```

--------------------------------

### Run D2 Compiler with Theming

Source: https://github.com/xenodium/emacs-skills/blob/main/skills/d2/SKILL.md

Execute the D2 compiler to generate a PNG image from a D2 file. Use `--theme 200` for dark mode or `--theme 0` for light mode, and always include `--pad 40`.

```sh
# Use --theme 200 for dark, --theme 0 for light
d2 --theme 200 --pad 40 /tmp/agent-diagram-XXXX.d2 /tmp/agent-diagram-XXXX.png
```

--------------------------------

### Look Up Emacs Documentation

Source: https://context7.com/xenodium/emacs-skills/llms.txt

Use the `/describe` skill to query Emacs documentation for symbols, variables, faces, or key bindings. Returns a formatted summary of all matches.

```emacs-lisp
(progn
  (load "/path/to/skills/describe/agent-skill-describe.el" nil t)
  (agent-skill-describe :query "dired-mark"))
```

```emacs-lisp
(progn
  (load "/path/to/skills/describe/agent-skill-describe.el" nil t)
  (agent-skill-describe :query "C-x C-f"))
```

--------------------------------

### Open Files in Emacs with emacsclient

Source: https://github.com/xenodium/emacs-skills/blob/main/skills/open/SKILL.md

Use this command to open files in Emacs. Ensure `agent-skill-open.el` is loaded and provide file paths, optionally with specific line numbers. Use absolute paths for files.

```sh
emacsclient --eval \
'(progn
  (load "/path/to/skills/open/agent-skill-open.el" nil t)
  (agent-skill-open
    :files (quote ((:file "/path/to/file1.txt"
            :line 42)
           "/path/to/file2.txt"
           "/path/to/file3.txt"))))'
```

--------------------------------

### Run PlantUML Command

Source: https://github.com/xenodium/emacs-skills/blob/main/skills/plantuml/SKILL.md

Execute PlantUML to generate a PNG image from a PlantUML source file. Ensure the output path includes a timestamp for uniqueness.

```sh
plantuml -tpng /tmp/agent-diagram-XXXX.puml
```

--------------------------------

### Requirements: Check emacsclient PATH

Source: https://context7.com/xenodium/emacs-skills/llms.txt

Verifies that the `emacsclient` executable is available in the system's PATH. This is a prerequisite for using `emacsclient` commands.

```sh
# emacsclient must be on PATH
which emacsclient
```

--------------------------------

### Run ERT Tests with Emacsclient

Source: https://github.com/xenodium/emacs-skills/blob/main/skills/emacsclient/SKILL.md

Runs ERT tests in batch mode and exits. Load the test file first, then execute tests matching a pattern. Multi-line Elisp formatting is used.

```sh
emacsclient --eval \
  '(progn \
    (load "/path/to/test-file.el" nil t) \
    (ert-run-tests-batch-and-exit "pattern"))'
```

--------------------------------

### Open File with Emacsclient

Source: https://github.com/xenodium/emacs-skills/blob/main/skills/emacsclient/SKILL.md

Opens a file in Emacs without waiting for it to close. Use this for general file editing.

```bash
emacsclient --no-wait "/path/to/file"
```

--------------------------------

### Open Files in Emacs Dired

Source: https://context7.com/xenodium/emacs-skills/llms.txt

Use the `/dired` skill to open files in an Emacs dired buffer. If files share a common directory, dired opens at that directory with files marked. Otherwise, a virtual `*agent-files*` buffer is created.

```emacs-lisp
(progn
  (load "/path/to/skills/dired/agent-skill-dired.el" nil t)
  (agent-skill-dired
    :dir "/src/app"
    :files (quote ("file1.ts"
                   "file2.ts"))))
```

```emacs-lisp
(progn
  (load "/path/to/skills/dired/agent-skill-dired.el" nil t)
  (agent-skill-dired
    :dir "/src"
    :files (quote ("app/file1.ts"
                   "lib/utils.ts"
                   "tests/file1.spec.ts"))))
```

--------------------------------

### Generate Mermaid Diagram Configuration

Source: https://context7.com/xenodium/emacs-skills/llms.txt

Writes a JSON configuration file for Mermaid. This file sets the theme and theme variables, applying the Emacs foreground color to text and borders for consistent styling.

```json
{
  "theme": "dark",
  "themeVariables": {
    "primaryTextColor": "#eeffff",
    "secondaryTextColor": "#eeffff",
    "primaryBorderColor": "#eeffff",
    "lineColor": "#eeffff",
    "textColor": "#eeffff",
    "actorTextColor": "#eeffff",
    "actorBorder": "#eeffff",
    "signalColor": "#eeffff",
    "signalTextColor": "#eeffff",
    "noteTextColor": "#eeffff",
    "noteBorderColor": "#eeffff"
  }
}
```

--------------------------------

### Generate PlantUML Diagram

Source: https://context7.com/xenodium/emacs-skills/llms.txt

Creates a PlantUML diagram by writing a PlantUML script to a temporary file and then rendering it to a PNG. It applies Emacs foreground color for readability using `skinparam` directives.

```sh
cat > /tmp/agent-diagram-$(date +%s).puml << 'EOF'
@startuml
skinparam backgroundColor transparent
skinparam shadowing true
skinparam roundcorner 10
skinparam defaultFontName "Helvetica"
skinparam defaultFontColor #eeffff
skinparam sequenceArrowColor #eeffff
skinparam sequenceLifeLineBorderColor #eeffff
skinparam participantFontColor #eeffff
skinparam participantBorderColor #eeffff
skinparam noteFontColor #eeffff
skinparam noteBorderColor #eeffff

title Request Flow

participant Client
participant Server
participant Database

Client -> Server: HTTP POST /api/data
Server -> Database: INSERT query
Database --> Server: OK
Server --> Client: 201 Created
@enduml
EOF

plantuml -tpng /tmp/agent-diagram-1700000000.puml
# Output inline:
# ![Request Flow](/tmp/agent-diagram-1700000000.png)
```

--------------------------------

### Mermaid Configuration JSON

Source: https://github.com/xenodium/emacs-skills/blob/main/skills/mermaid/SKILL.md

This JSON configuration file applies Emacs theme variables. Replace '#eeffff' with the queried foreground color and set 'theme' to 'dark' or 'default' based on the Emacs background mode.

```json
{
  "theme": "dark",
  "themeVariables": {
    "primaryTextColor": "#eeffff",
    "secondaryTextColor": "#eeffff",
    "tertiaryTextColor": "#eeffff",
    "primaryBorderColor": "#eeffff",
    "lineColor": "#eeffff",
    "textColor": "#eeffff",
    "actorTextColor": "#eeffff",
    "actorBorder": "#eeffff",
    "signalColor": "#eeffff",
    "signalTextColor": "#eeffff",
    "labelTextColor": "#eeffff",
    "loopTextColor": "#eeffff",
    "noteTextColor": "#eeffff",
    "noteBorderColor": "#eeffff",
    "sectionTextColor": "#eeffff",
    "titleColor": "#eeffff"
  }
}
```

--------------------------------

### Open Files in Emacs Buffers

Source: https://context7.com/xenodium/emacs-skills/llms.txt

Use the `/open` skill to open specified files in Emacs buffers. Supports jumping to a specific line number if provided.

```emacs-lisp
(progn
  (load "/path/to/skills/open/agent-skill-open.el" nil t)
  (agent-skill-open
    :files (quote ((:file "/path/to/file1.txt"
                    :line 42)
                   "/path/to/file2.txt"
                   "/path/to/file3.txt"))))
```

--------------------------------

### Evaluate Emacs Lisp to Select Region

Source: https://github.com/xenodium/emacs-skills/blob/main/skills/select/SKILL.md

Use this command to load the selection helper and specify file paths and line ranges for region activation. Ensure absolute paths are used for files. The last file visited will have the active region.

```bash
emacsclient --eval \
'(progn
  (load "/path/to/skills/select/agent-skill-select.el" nil t)
  (agent-skill-select
    :selections (quote (("/path/to/file1.el"
                     :start 10
                     :end 25)
                    ("/path/to/file2.el"
                     :start 5
                     :end 12)))))
'
```

--------------------------------

### Open File at Specific Line with Emacsclient

Source: https://github.com/xenodium/emacs-skills/blob/main/skills/emacsclient/SKILL.md

Opens a file in Emacs and positions the cursor at a specific line number. Use `--no-wait` to return immediately.

```bash
emacsclient --no-wait +42 "/path/to/file"
```

--------------------------------

### Emacsclient: Open File at Specific Line

Source: https://context7.com/xenodium/emacs-skills/llms.txt

Opens a file in Emacs using `emacsclient` and positions the cursor at a specific line number. Ensure an Emacs server is running.

```sh
# Open at a specific line
emacsclient --no-wait +42 "/path/to/file.el"
```

--------------------------------

### Open files in Emacs dired buffer

Source: https://github.com/xenodium/emacs-skills/blob/main/skills/dired/SKILL.md

Use this snippet to open files from the most recent interaction in an Emacs dired buffer. Ensure `agent-skill-dired.el` is loaded and specify the directory and files accordingly. Paths in `:files` should be relative to `:dir`.

```bash
emacsclient --eval \
'(progn
  (load "/path/to/skills/dired/agent-skill-dired.el" nil t)
  (agent-skill-dired
    :dir "/path/to/directory"
    :files (quote ("file1.txt"
                   "file2.txt"
                   "file3.txt"))))'
```

--------------------------------

### Emacsclient: Run ERT Tests

Source: https://context7.com/xenodium/emacs-skills/llms.txt

Runs ERT tests matching a pattern in batch mode using `emacsclient --eval`. Ensure an Emacs server is running.

```sh
# Run ERT tests matching a pattern
emacsclient --eval '
(progn
  (load "/path/to/test-file.el" nil t)
  (ert-run-tests-batch-and-exit "my-feature-.* அமலா"))'
```

--------------------------------

### Incorrect File Link Format

Source: https://github.com/xenodium/emacs-skills/blob/main/skills/file-links/SKILL.md

Avoid this format, as it incorrectly mixes line number syntax between the link text and the URL.

```markdown
[filename.el#L42-L50](filename.el#L42)
```

--------------------------------

### Generate D2 Diagram

Source: https://context7.com/xenodium/emacs-skills/llms.txt

Creates a D2 diagram by writing D2 script to a temporary file and rendering it to a PNG. It uses Emacs foreground color and background mode to select a theme and style nodes/edges.

```sh
cat > /tmp/agent-diagram-$(date +%s).d2 << 'EOF'
direction: right

api: API Gateway {
  style.font-color: "#eeffff"
  style.fill: "#2d3748"
  style.stroke: "#eeffff"
}

service: Backend Service {
  style.font-color: "#eeffff"
  style.fill: "#2d3748"
  style.stroke: "#eeffff"
}

db: Database {
  style.font-color: "#eeffff"
  style.fill: "#2d3748"
  style.stroke: "#eeffff"
}

api -> service: route {style.stroke: "#eeffff"; style.font-color: "#eeffff"}
service -> db: query {style.stroke: "#eeffff"; style.font-color: "#eeffff"}
EOF

d2 --theme 200 --pad 40 /tmp/agent-diagram-1700000000.d2 /tmp/agent-diagram-1700000000.png
# Output inline:
# ![Architecture](/tmp/agent-diagram-1700000000.png)
```

--------------------------------

### Emacsclient: Byte Compile File

Source: https://context7.com/xenodium/emacs-skills/llms.txt

Byte compiles a file using `emacsclient --eval`. This requires an Emacs server to be running.

```sh
# Byte compile
emacsclient --eval '
(byte-compile-file "/path/to/file.el")'
```

--------------------------------

### Check Parentheses with Emacsclient

Source: https://github.com/xenodium/emacs-skills/blob/main/skills/emacsclient/SKILL.md

Checks the parentheses balance of a file by inserting its content into a temporary buffer and running `check-parens`. Proper Elisp formatting is required.

```sh
emacsclient --eval \
  '(with-temp-buffer \
    (insert-file-contents "/path/to/file.el") \
    (check-parens))'
```

--------------------------------

### Select Region in Emacs

Source: https://context7.com/xenodium/emacs-skills/llms.txt

Use the `/select` skill to open files and activate a region (mark and point) around specified code sections. The last file in the list will have the active region.

```emacs-lisp
(progn
  (load "/path/to/skills/select/agent-skill-select.el" nil t)
  (agent-skill-select
    :selections (quote (("/path/to/file1.el"
                         :start 10
                         :end 25)
                        ("/path/to/file2.el"
                         :start 5
                         :end 12)))))
```

--------------------------------

### D2 Diagram Template with Theming

Source: https://github.com/xenodium/emacs-skills/blob/main/skills/d2/SKILL.md

A D2 language template demonstrating node and edge styling. Apply the Emacs foreground color to font and stroke, and use appropriate fill colors. Adjust the theme based on Emacs background mode.

```d2
direction: right

node1: Label {
  style.font-color: "#eeffff"
  style.fill: "#2d3748"
  style.stroke: "#eeffff"
}

node2: Label {
  style.font-color: "#eeffff"
  style.fill: "#2d3748"
  style.stroke: "#eeffff"
}

node1 -> node2: label {style.stroke: "#eeffff"; style.font-color: "#eeffff"}
```

--------------------------------

### Byte Compile File with Emacsclient

Source: https://github.com/xenodium/emacs-skills/blob/main/skills/emacsclient/SKILL.md

Byte compiles a specified Elisp file using emacsclient. Ensure the Elisp code is properly formatted for multi-line evaluation.

```sh
emacsclient --eval \
  '(byte-compile-file "/path/to/file.el")'
```

--------------------------------

### Query Emacs Colors and Background Mode

Source: https://github.com/xenodium/emacs-skills/blob/main/skills/mermaid/SKILL.md

These commands query the Emacs foreground color and background mode. The foreground color is returned as a hex string, and the background mode as 'dark' or 'light'. Reuse these values throughout the session.

```sh
emacsclient --eval "(face-foreground (quote default))"
emacsclient --eval "(frame-parameter nil (quote background-mode))"
```

--------------------------------

### PlantUML Template with Styling

Source: https://github.com/xenodium/emacs-skills/blob/main/skills/plantuml/SKILL.md

A PlantUML template demonstrating how to set a transparent background, enable shadowing, round corners, and define default font styles and colors. This template ensures diagrams are readable on Emacs backgrounds.

```plantuml
@startuml
skinparam backgroundColor transparent
skinparam shadowing true
skinparam roundcorner 10
skinparam defaultFontName "Helvetica"
skinparam defaultFontColor #eeffff

' Set foreground color on all element types
skinparam titleFontColor #eeffff
skinparam sequenceLifeLineBorderColor #eeffff
skinparam sequenceArrowColor #eeffff
skinparam sequenceGroupHeaderFontColor #eeffff
skinparam sequenceGroupBorderColor #eeffff
skinparam sequenceDividerFontColor #eeffff
skinparam sequenceDividerBorderColor #eeffff
skinparam actorBorderColor #eeffff
skinparam actorFontColor #eeffff
skinparam participantFontColor #eeffff
skinparam participantBorderColor #eeffff
skinparam collectionsFontColor #eeffff
skinparam collectionsBorderColor #eeffff
skinparam noteFontColor #eeffff
skinparam noteBorderColor #eeffff
skinparam arrowFontColor #eeffff
skinparam classFontColor #eeffff
skinparam classBorderColor #eeffff
skinparam classAttributeFontColor #eeffff
skinparam packageFontColor #eeffff
skinparam packageBorderColor #eeffff
skinparam componentFontColor #eeffff
skinparam componentBorderColor #eeffff
skinparam interfaceFontColor #eeffff
skinparam interfaceBorderColor #eeffff

' ... diagram content ...
@enduml
```

--------------------------------

### Emacsclient: Check Parentheses Balance

Source: https://context7.com/xenodium/emacs-skills/llms.txt

Checks the parentheses balance of a file using `emacsclient --eval`. This requires an Emacs server to be running.

```sh
# Check parentheses balance
emacsclient --eval '
(with-temp-buffer
  (insert-file-contents "/path/to/file.el")
  (check-parens))'
```

--------------------------------

### Generate Mermaid Diagram with mmdc

Source: https://github.com/xenodium/emacs-skills/blob/main/skills/mermaid/SKILL.md

This command generates a Mermaid diagram. Use '-t dark' for dark mode or '-t default' for light mode. Ensure PUPPETEER_EXECUTABLE_PATH is set and provide input, output, theme, transparency, scale, and config file options.

```sh
# Use -t dark for dark, -t default for light
PUPPETEER_EXECUTABLE_PATH=/opt/homebrew/bin/chromium mmdc \
  -i /tmp/agent-diagram-XXXX.mmd \
  -o /tmp/agent-diagram-XXXX.png \
  -t dark -b transparent --scale 2 \
  --configFile /tmp/agent-diagram-XXXX-config.json
```

--------------------------------

### File Links: Single Line Reference

Source: https://context7.com/xenodium/emacs-skills/llms.txt

Formats a single line file reference as a clickable Markdown link with a line number fragment. This is used for navigating code.

```markdown
<!-- Single line reference -->
[agent-skill-dired.el:13](skills/dired/agent-skill-dired.el#L13)
```

--------------------------------

### Emacsclient: Open File Non-blocking

Source: https://context7.com/xenodium/emacs-skills/llms.txt

Opens a file in Emacs using `emacsclient` without blocking the current process. Ensure an Emacs server is running.

```sh
# Open a file (non-blocking)
emacsclient --no-wait "/path/to/file.el"
```

--------------------------------

### Markdown Link with Line Range

Source: https://github.com/xenodium/emacs-skills/blob/main/skills/file-links/SKILL.md

Use this format for referencing a block of lines. Both the link text and the URL must include the line range, using a colon in the text and `-L` in the URL.

```markdown
[filename.el:42-50](relative/path/to/filename.el#L42-L50)
```

--------------------------------

### File Links: File Without Line Number

Source: https://context7.com/xenodium/emacs-skills/llms.txt

Formats a file reference without specific line numbers as a clickable Markdown link. This is used when the entire file is relevant.

```markdown
<!-- File without line number -->
[agent-skill-dired.el](skills/dired/agent-skill-dired.el)
```

--------------------------------

### Mermaid Sequence Diagram Template

Source: https://github.com/xenodium/emacs-skills/blob/main/skills/mermaid/SKILL.md

A basic template for a Mermaid sequence diagram. This can be adapted to visualize interactions between participants.

```mermaid
sequenceDiagram
    participant a as Alice
    participant b as Bob
    a->>b: Hello
    b-->>a: Hi back
```

--------------------------------

### Highlight Regions in Emacs

Source: https://context7.com/xenodium/emacs-skills/llms.txt

Use the `/highlight` skill to open files in a temporary read-only mode with highlighted overlays for specified line ranges. Press `q` to exit and remove highlights.

```emacs-lisp
(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)))))))
```

--------------------------------

### Emacsclient: Evaluate Elisp Expression

Source: https://context7.com/xenodium/emacs-skills/llms.txt

Evaluates a single Elisp expression using `emacsclient --eval`. Ensure an Emacs server is running.

```sh
# Evaluate elisp
emacsclient --eval '(some-function)'
```

--------------------------------

### Evaluate Elisp with Emacsclient

Source: https://github.com/xenodium/emacs-skills/blob/main/skills/emacsclient/SKILL.md

Evaluates a given Elisp expression. Use this for running Emacs Lisp functions directly.

```bash
emacsclient --eval "'(some-function)"
```

--------------------------------

### Query Emacs Background Mode

Source: https://context7.com/xenodium/emacs-skills/llms.txt

Queries the Emacs background mode. This is used in conjunction with the foreground color to select the appropriate D2 theme (dark or light) for consistent diagram styling.

```sh
emacsclient --eval "(frame-parameter nil (quote background-mode))"
# => "dark"
```

--------------------------------

### File Links: Line Range Reference

Source: https://context7.com/xenodium/emacs-skills/llms.txt

Formats a file reference spanning multiple lines as a clickable Markdown link with a line range fragment. This is useful for indicating code blocks.

```markdown
<!-- Line range reference -->
[agent-skill-dired.el:13-24](skills/dired/agent-skill-dired.el#L13-L24)
```

--------------------------------

### Execute Gnuplot Script

Source: https://github.com/xenodium/emacs-skills/blob/main/skills/gnuplot/SKILL.md

This command executes a gnuplot script. Ensure the script path and output image path are correctly specified.

```sh
gnuplot /tmp/agent-plot-XXXX.gp
```

--------------------------------

### Update emacs-skills Plugin

Source: https://github.com/xenodium/emacs-skills/blob/main/README.md

Update the emacs-skills plugin to the latest version from the Claude plugin marketplace.

```sh
claude plugin marketplace update xenodium-emacs-skills
```

--------------------------------

### Generate Gnuplot Script and Plot Data

Source: https://context7.com/xenodium/emacs-skills/llms.txt

Writes a gnuplot script to a temporary file and then executes gnuplot to generate a transparent PNG. The script configures terminal settings, output file, colors, and plots data from a here-document.

```sh
cat > /tmp/agent-plot-$(date +%s).gp << 'EOF'
set terminal pngcairo transparent enhanced size 800,500
set output "/tmp/agent-plot-1700000000.png"

FG = "#eeffff"
set border lc rgb FG
set key textcolor rgb FG
set xlabel "Month" textcolor rgb FG
set ylabel "Sales" textcolor rgb FG
set title "Monthly Sales" textcolor rgb FG
set xtics textcolor rgb FG
set ytics textcolor rgb FG

$DATA << EOD
1 120
2 145
3 98
4 167
5 210
EOD

plot $DATA using 1:2 with linespoints lc rgb FG title "Sales"
EOF

gnuplot /tmp/agent-plot-1700000000.gp
# Output inline:
# ![Monthly Sales](/tmp/agent-plot-1700000000.png)
```

--------------------------------

### Markdown Link without Line Number

Source: https://github.com/xenodium/emacs-skills/blob/main/skills/file-links/SKILL.md

Use this format when referencing a file without a specific line number. This is suitable for general file references.

```markdown
[filename.el](relative/path/to/filename.el)
```

--------------------------------

### Markdown Link with Line Number

Source: https://github.com/xenodium/emacs-skills/blob/main/skills/file-links/SKILL.md

Use this format when referencing a specific line in a file. The link text uses a colon for the line number, while the URL uses `#L`.

```markdown
[filename.el:42](relative/path/to/filename.el#L42)
```

--------------------------------

### Uninstall emacs-skills Plugin

Source: https://github.com/xenodium/emacs-skills/blob/main/README.md

Uninstall the emacs-skills plugin from your Claude environment.

```sh
claude plugin uninstall emacs-skills
```

--------------------------------

### Query Emacs Foreground Color

Source: https://github.com/xenodium/emacs-skills/blob/main/skills/gnuplot/SKILL.md

This command queries the default foreground color from Emacs. It should be run once per session and the color reused for subsequent plots.

```sh
emacsclient --eval \
(face-foreground (quote default))'
```

--------------------------------

### Gnuplot Script Template

Source: https://github.com/xenodium/emacs-skills/blob/main/skills/gnuplot/SKILL.md

A template for a gnuplot script. It configures the terminal to output a transparent PNG, sets colors based on Emacs foreground, and includes placeholders for plot commands.

```gnuplot
set terminal pngcairo transparent enhanced size 800,500
set output "/tmp/agent-plot-XXXX.png"

FG = "#eeffff"  # from emacsclient query
set border lc rgb FG
set key textcolor rgb FG
set xlabel textcolor rgb FG
set ylabel textcolor rgb FG
set title textcolor rgb FG
set xtics textcolor rgb FG
set ytics textcolor rgb FG

# ... plot commands using the data ...

```
Tokens:
Raw