/gnuplot

name: gnuplot
description: 'This skill should be used when the user invokes "/gnuplot" to plot data from the current context using gnuplot and output the resulting image path.'
tools: Bash
disable-model-invocation: true

Plot data with gnuplot

Plot data from the most recent interaction context using gnuplot. Generate a PNG image with a transparent background and output it as a markdown image so it renders inline.

How to plot

1. Extract or derive plottable data from the current context. 2. If the Emacs foreground color is not already known from a previous plot in this session, query it:

   emacsclient --eval '
   (face-foreground (quote default))'

This returns a hex color like `"#eeffff"`. Reuse it for all subsequent plots. 3. Write a gnuplot script to a temporary file using that color. 4. Run gnuplot on the script. 5. Output the result as a markdown image on its own line:

   ![description](/tmp/agent-plot-XXXX.png)

gnuplot /tmp/agent-plot-XXXX.gp

Gnuplot script template

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 noopaque nobox  # transparent: Emacs bg shows through, FG text stays legible
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 ...

Rules

• Query the Emacs foreground color once per session and reuse it for all subsequent plots. Only query again if the color is not already known.
• Always use `pngcairo transparent` terminal for transparent background.
• Always use a timestamp in the filename (e.g., `/tmp/agent-plot-$(date +%s).png`). Never use descriptive names like `agent-plot-lorenz.png`.
• Use inline data (`$DATA << EOD ... EOD`) when practical. For large datasets, write a separate data file.
• After gnuplot runs successfully, output a markdown image (``) on its own line.
• Choose an appropriate plot type for the data (lines, bars, histogram, scatter, etc.).
• Include a title, axis labels, and a legend when they add clarity.
• Keep the legend transparent (`noopaque`, no box) so the Emacs background shows through and the FG-colored text stays legible. Never make the key `opaque`: on a transparent terminal it fills the key box with an opaque (often white) background, which hides the light FG text. If the legend would overlap dense or filled data, move it to an empty corner or use `set key outside` rather than making it opaque.
• Keep plot fills semi-transparent (e.g. `fs transparent solid 0.15`) so any legend or labels drawn over them remain readable against the Emacs background.
• Use `enhanced` text mode for subscripts/superscripts when needed.
• If no plottable data exists in the recent context, inform the user.