> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ev-cloud.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ev-cloud.ai/_mcp/server.

# Agent skills

Agent skills are `SKILL.md` files your coding agent reads when a task matches. The EV Cloud skills cover the domains, the base URL, authentication, the SDKs and every `evcloud-cli` command. They live in [ev-cloudx/evcloud-skills](https://github.com/ev-cloudx/evcloud-skills) and work with Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI and [40+ other agents](https://github.com/vercel-labs/skills#supported-agents).

## Install

```bash
npx skills add ev-cloudx/evcloud-skills
```

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

**`Every skill`**

```bash Every skill
npx skills add ev-cloudx/evcloud-skills --all
```

**`Entry point only`**

```bash Entry point only
npx skills add ev-cloudx/evcloud-skills --skill evcloud
```

Update later with `npx skills update`, remove with `npx skills remove`.

## Skills

| Skill                  | Use it for                                                                                                                       |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `evcloud`              | Start here: domains, the base URL, auth (tokens must expire), which surface to use, what to poll, errors                         |
| `evcloud-sdk`          | Write code with the TypeScript or Python SDK: client setup, naming, pagination, errors, retries                                  |
| `evcloud-cli-shared`   | `evcloud-cli` install, base URL, sign-in, global flags, output formats                                                           |
| `evcloud-cli-cpo`      | Charge points, EVSEs, connectors, locations, tariffs, sessions, CDRs, customers, app users, token and voucher groups, audit logs |
| `evcloud-cli-emsp`     | Tenant profile, roaming identities, partner-location networks, driver tokens and token groups, sessions, CDRs, remote commands   |
| `evcloud-cli-energy`   | Power-limit control requests and power measurements                                                                              |
| `evcloud-cli-webhooks` | Webhook endpoints, test deliveries, delivery history, event types                                                                |
| `evcloud-cli-ocpi`     | OCPI partners and invites, the credentials handshake, CPO and eMSP data, push and pull sync                                      |
| `evcloud-cli-health`   | Check that the API is up                                                                                                         |

## What your agent also needs

* Your EV Cloud base URL, and a token that expires exported as `EVCLOUD_TOKEN`, or a browser sign-in with `evcloud-cli auth login`. See [Authentication](/get-started/authentication).
* The SDK or the CLI: `npm i evcloud-sdk`, `pip install evcloud-sdk` or `npm i -g @evcloud/cli`.

## Skills or MCP

Skills teach an agent to write code and run CLI commands with your token. The [MCP server](/agents/mcp-server) gives an agent every operation as a tool, with browser sign-in and no install. Use skills when the agent writes code that calls EV Cloud; use MCP when it should act on your data directly.