Use ESPlotter with Your AI Coding Agent

ESPlotter Desktop includes a skill that teaches AI coding agents how to use the ESPlotter Python SDK. Once it is installed, you can hand result files to your agent and ask for charts, images or a report in plain language. The agent writes and runs the Python scripts for you.

The ESPlotter Python SDK is available only on Windows, and the agent needs Python 3.10 or newer on the same computer.

Install the skill

1. Open ESPlotter and choose Settings > AI Agents.
2. Click Install on the row of each agent you use.
3. Restart your agent, or start a new session, so it picks up the new skill.

Nothing is installed until you click Install or turn on Install automatically for new AI assistants. Each row is one of these folders in your user profile. If a folder cannot be written, ESPlotter shows an error and that row stays without the skill.

Folder	Agents that read it
%USERPROFILE%\.agents\skills\esplotter	Codex, GitHub Copilot CLI, Cursor, OpenCode, Gemini CLI, Windsurf
%USERPROFILE%\.claude\skills\esplotter	Claude Code
%USERPROFILE%\.copilot\skills\esplotter	GitHub Copilot in VS Code

Settings > AI Agents lists every folder with its full path and the agents that read it, so you can see exactly what ESPlotter wrote and where. A row offers Uninstall once the skill is there; an icon marks the folders whose agents ESPlotter does not detect on your computer, but you can install those too. If an agent already has another esplotter skill, ESPlotter leaves it unchanged and marks that folder as Skipped. Click How does it work? next to the page description for a short explanation of what a skill is and how to use it.

To have ESPlotter add the skill for you, turn on Install automatically for new AI assistants. ESPlotter then installs it right away for the agents it detects, and at each start for agents you install later. It never reinstalls a folder you uninstalled from Settings.

Agents that do not support skills can still use ESPlotter: point them to %APPDATA%\ESPlotter\python-sdk\AGENTS.md.

Ask your agent

Describe the result you want and where the files are. For example:

• "Open C:\studies\fault.csv with ESPlotter, plot the bus voltages on one chart and export it as PNG."
• "Use ESPlotter to compare the active power in these three PSS/E .out files and write a Word report with one page per generator."
• "Show the eigenvalues from Eigenvalues_4XScenario.bin in my open ESPlotter window."

The agent chooses the mode for you:

You want	Mode	What the agent needs
Files, images or a report	Headless	Nothing else; ESPlotter does not have to be open.
To watch the work in ESPlotter, or keep editing it	Live	Nothing else when one ESPlotter window is open. With several, the agent asks which one: copy its ID from Help > Version > Copy session ID.

The skill tells the agent to export each chart as PNG and look at it before reporting back, so it can fix empty plots or unreadable ranges on its own.

What the agent can and cannot do

The agent can do everything the Python SDK can: open CSV, TXT and TSAT/SSAT .bin files, and PSS/E .out and PSLF .chf files when their paths are set in Settings > General; create pages and time-series, XY, eigenvalue and phasor plots; edit and calculate channels; export SVG, PNG and JPG images; and write PDF and Word reports.

It can also read numbers: the samples of a channel in a time window, and the same statistics the interval cursor window shows (minimum and maximum with their times, average, RMS, Y range, Delta Y and slope), so it answers questions such as the peak current after a fault with values rather than estimates from an image.

Keep it up to date or remove it

ESPlotter updates the installed skill whenever ESPlotter itself updates, so your agent always follows the SDK version you have. If a copy cannot be updated, its row shows Out of date and an Update button.

To remove the skill for an agent, click Uninstall on its row in Settings > AI Agents. ESPlotter deletes only the folders it installed. If you delete a folder yourself instead, ESPlotter adds it again at the next start while Install automatically for new AI assistants is on. If an agent keeps one of the skill's files open, ESPlotter reports that it could not remove everything and finishes the removal the next time you install, uninstall or start ESPlotter.