> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brelio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent skill

> Brelio's official skill teaches Claude Code, Cursor, Codex and other agents to use the MCP server and the REST API safely.

The Brelio skill is a `SKILL.md` file that an AI agent loads when a task involves Brelio. Connecting the [MCP server](https://docs.brelio.com/en/quickstart/mcp.md) or an [API key](https://docs.brelio.com/en/quickstart/api.md) gives the agent access; the skill gives it Brelio's rules, so it uses that access well.

**Raw file:** [docs.brelio.com/skill.md](https://docs.brelio.com/skill.md)

## What it teaches

* When to use an MCP tool and when to call REST (the MCP server serves read tools only).
* To confirm every change with you before making it, and never to invent patient data, times or ids.
* To pass `centerId` explicitly: an agenda call without it reads only your default center.
* [`Idempotency-Key`](https://docs.brelio.com/en/concepts/idempotency) on every write and [`expectedVersion`](https://docs.brelio.com/en/concepts/concurrency) on every change.
* [Data areas and patient-data consent](https://docs.brelio.com/en/concepts/data-areas.md): what `DATA_AREA_OFF` and `PATIENT_DATA_CONSENT_REQUIRED` mean and what to tell you.
* The [error codes](https://docs.brelio.com/en/concepts/errors.md) and their fixes, and the [rate limits](https://docs.brelio.com/en/concepts/rate-limits.md).
* Every tool and operation, with its arguments, permission and data area.

The reference part of the skill is generated from the same catalogue as the API, so it always matches the [MCP tools](https://docs.brelio.com/en/mcp/tools.md) and [operations](https://docs.brelio.com/en/reference/operations.md) pages.

## Install

With the [skills CLI](https://skills.sh) (Node.js 22.20 or later):

```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
npx skills add https://docs.brelio.com/skill.md
```

It detects your agents and asks where to install. To choose:

> [tab] Claude Code
>
> ```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
> npx skills add https://docs.brelio.com/skill.md -a claude-code -g
> ```
>
> Or by hand:
>
> ```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
> mkdir -p ~/.claude/skills/brelio
> curl -fsSL https://docs.brelio.com/skill.md -o ~/.claude/skills/brelio/SKILL.md
> ```
>
> Claude Code loads it whenever a task mentions Brelio.

> [tab] Cursor
>
> ```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
> npx skills add https://docs.brelio.com/skill.md -a cursor
> ```
>
> The skill goes to `.agents/skills/brelio/` in the current project; add `-g` to install it for every project.

> [tab] Codex
>
> ```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
> npx skills add https://docs.brelio.com/skill.md -a codex
> ```
>
> The skill goes to `.agents/skills/brelio/` in the current project; add `-g` to install it for every project.

> [tab] Other agents
>
> Download the file into the folder where your agent reads skills, as `brelio/SKILL.md`:
>
> ```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
> mkdir -p .agents/skills/brelio
> curl -fsSL https://docs.brelio.com/skill.md -o .agents/skills/brelio/SKILL.md
> ```

> [!NOTE]
>
> The skill does not connect your agent to Brelio. Add the [MCP server](https://docs.brelio.com/en/quickstart/mcp.md) or create an [API key](https://docs.brelio.com/en/quickstart/api.md) as well.

## Keep it up to date

The skill changes when the API changes. Run `npx skills update` to update an installed copy, or download [skill.md](https://docs.brelio.com/skill.md) again.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.