Skip to navigation

Agent skills

Teach Claude Code, Codex, Cursor and other coding agents how to use OCPPLab, with one command.

OCPPLab skills are agent skills: folders of instructions your coding agent loads when a task needs them. With them installed, an agent knows how to authenticate, deploy and drive virtual chargers, write code with the SDKs, run ocpplab-cli, and connect MCP, without you pasting docs into the chat.

Install

npx skills add ev-cloudx/ocpplab-skills

The installer asks which agents and skills to install. To skip the questions:

# Every skill, for every agent, in this project
npx skills add ev-cloudx/ocpplab-skills --all

Without -g, skills go into the current project (commit them so your team gets them too). With -g, they go into your user folders and work in every project.

Supported agents

The installer supports 40+ agents. Where the common ones look for skills:

Agent-a valueProject folderUser folder (-g)
Claude Codeclaude-code.claude/skills/~/.claude/skills/
Codexcodex.agents/skills/~/.agents/skills/
Cursorcursor.agents/skills/~/.cursor/skills/
GitHub Copilotgithub-copilot.agents/skills/~/.copilot/skills/
Gemini CLIgemini-cli.agents/skills/~/.gemini/skills/
OpenCodeopencode.agents/skills/~/.config/opencode/skills/
Windsurfwindsurf.windsurf/skills/~/.codeium/windsurf/skills/
Goosegoose.goose/skills/~/.config/goose/skills/

Every other agent: supported agents.

The skills

SkillYour agent uses it to
ocpplabStart any OCPPLab task: domains, authentication, which surface to use, the 202 polling rule, errors, where the docs are
ocpplab-virtual-chargersDeploy virtual chargers against your CSMS, then plug, charge, unplug, inject faults and diagnose stuck chargers
ocpplab-sdkWrite code with the TypeScript or Python SDK: naming, pagination, errors, retries
ocpplab-mcpConnect an AI client to the OCPPLab MCP servers
ocpplab-cli-sharedInstall and sign in to ocpplab-cli, global flags, output formats
ocpplab-cli-evcharger, -cpo, -emsp, -ocpi, -proxy, -booking, -energy, -webhooks, -healthRun every ocpplab-cli command, per domain

The ocpplab-cli-* skills are generated from the published CLI, so they list every command it has.

Before your agent starts

Your agent still needs a token and one way to call OCPPLab:

  1. Generate a token in Studio under Settings → SDK tokens and export it: export OCPPLAB_TOKEN="<token>". The skills tell the agent to read it from there and never write it to a file. See Authentication.
  2. Install what the task needs: npm i ocpplab, pip install ocpplab, npm i -g @ocpplab/cli, or connect the MCP server https://api.ocpplab.io/mcp.

Then ask in plain words, for example “deploy two virtual chargers against wss://csms.example.com/ocpp and start a session on the first one”.

Update or remove

npx skills list # what is installed
npx skills update # latest versions of installed skills
npx skills remove ocpplab-sdk # remove one skill

Skills, MCP, or both

Agent skillsMCP server
Gives the agentKnow-how: which call to make and how to use itTools that run OCPPLab operations directly
Runs code throughThe SDKs or ocpplab-cli in your projectOCPPLab’s API, from the AI client
Best forWriting and running code in a repositoryChat-style work in Claude, Cursor, ChatGPT

They work well together: install the skills, and the ocpplab-mcp skill shows your agent how to connect MCP when a task needs it.