> ## 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.

# Skill para agentes

> La skill oficial de Brelio enseña a Claude Code, Cursor, Codex y otros agentes a usar el servidor MCP y la API REST con seguridad.

La skill de Brelio es un archivo `SKILL.md` que un agente de IA carga cuando una tarea tiene que ver con Brelio. Conectar el [servidor MCP](https://docs.brelio.com/es/quickstart/mcp.md) o una [clave de API](https://docs.brelio.com/es/quickstart/api.md) le da acceso; la skill le da las reglas de Brelio para que use bien ese acceso.

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

## Qué enseña

* Cuándo usar una herramienta MCP y cuándo llamar a REST (el servidor MCP solo ofrece herramientas de lectura).
* A confirmar contigo cada cambio antes de hacerlo y a no inventar nunca datos de pacientes, horas ni ids.
* A pasar `centerId` siempre: una consulta de agenda sin él solo lee tu centro por defecto.
* [`Idempotency-Key`](https://docs.brelio.com/es/concepts/idempotency) en cada escritura y [`expectedVersion`](https://docs.brelio.com/es/concepts/concurrency) en cada cambio.
* Las [áreas de datos y el acceso a datos de pacientes](https://docs.brelio.com/es/concepts/data-areas.md): qué significan `DATA_AREA_OFF` y `PATIENT_DATA_CONSENT_REQUIRED` y qué decirte.
* Los [códigos de error](https://docs.brelio.com/es/concepts/errors.md) con su solución y los [límites de uso](https://docs.brelio.com/es/concepts/rate-limits.md).
* Cada herramienta y operación, con sus argumentos, su permiso y su área de datos.

La parte de referencia se genera desde el mismo catálogo que la API, así que siempre coincide con las páginas de [herramientas MCP](https://docs.brelio.com/es/mcp/tools.md) y [operaciones](https://docs.brelio.com/es/reference/operations.md). La skill está en inglés, como los nombres de la API; el agente te responde en tu idioma.

## Instalar

Con la [CLI de skills](https://skills.sh) (Node.js 22.20 o posterior):

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

Detecta tus agentes y te pregunta dónde instalarla. Para elegir:

> [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
> ```
>
> O a mano:
>
> ```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 la carga cuando una tarea menciona 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
> ```
>
> La skill se instala en `.agents/skills/brelio/` del proyecto actual; añade `-g` para todos tus proyectos.

> [tab] Codex
>
> ```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
> npx skills add https://docs.brelio.com/skill.md -a codex
> ```
>
> La skill se instala en `.agents/skills/brelio/` del proyecto actual; añade `-g` para todos tus proyectos.

> [tab] Otros agentes
>
> Descarga el archivo en la carpeta donde tu agente lee las skills, como `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]
>
> La skill no conecta tu agente con Brelio. Añade también el [servidor MCP](https://docs.brelio.com/es/quickstart/mcp.md) o crea una [clave de API](https://docs.brelio.com/es/quickstart/api.md).

## Mantenerla al día

La skill cambia cuando cambia la API. Ejecuta `npx skills update` para actualizar la copia instalada, o vuelve a descargar [skill.md](https://docs.brelio.com/skill.md).


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