# Integrar con tu agente de código

## En un paso

1. **Instala la skill**: Un comando, o el zip si esta doc pide iniciar sesión.
2. **Pide**: Una frase: qué capturas y dónde está tu backend.
3. **Comprueba**: Ejecuta doctor y compara las llamadas con el playground.

**Claude Code**

```bash
npx skills add https://devlab.neurologyca.com -a claude-code
# después, en tu proyecto:
claude "Añade a esta página la captura de Neurologyca en el dispositivo con Measurement."
```

**Codex · Cursor · Copilot**

```bash
npx skills add https://devlab.neurologyca.com -a codex -a cursor -a github-copilot
```

**Sin el instalador**

```bash
# Descarga https://devlab.neurologyca.com/docs/agents/skills/neurologyca-capture.zip y después:
mkdir -p .agents/skills/neurologyca-capture .claude/skills/neurologyca-capture
unzip neurologyca-capture.zip -d .agents/skills/neurologyca-capture
unzip neurologyca-capture.zip -d .claude/skills/neurologyca-capture
# Por la API HTTP desde otro lenguaje, descarga https://devlab.neurologyca.com/docs/agents/skills/neurologyca-engine-api.zip y haz lo mismo:
mkdir -p .agents/skills/neurologyca-engine-api .claude/skills/neurologyca-engine-api
unzip neurologyca-engine-api.zip -d .agents/skills/neurologyca-engine-api
unzip neurologyca-engine-api.zip -d .claude/skills/neurologyca-engine-api
```

**Si esta doc pide iniciar sesión**: El instalador no puede iniciar sesión. Mientras este DevLab pida sesión para leer su doc, descarga el zip desde esta página con la sesión iniciada y descomprímelo como en «Sin el instalador». `/docs/llms-full.txt` tiene todas las páginas en un fichero.

## Qué recibe tu agente

- **Skill · SDK de captura**: Cómo integrar `@neurologyca/capture`: primero el kit, el proxy en tu backend, la inscripción, la captura, los resultados y las trampas, con `validate-config` y `doctor` para comprobar el trabajo. Claude Code · Codex · Cursor · GitHub Copilot.
- **Skill · API HTTP**: Las llamadas desde tu backend, en cualquier lenguaje: token, personas, inscripciones, lotes, resultados e interpretación. Agentes con skills.
- **`/docs/llms.txt`**: Una línea por página, agrupadas por sección, más las páginas de una vía en un fichero (`llms/sdk.txt`, `llms/deferred.txt`, `llms/api.txt`) y cada página en `.md`. Cualquier agente que lea una URL. [Todos los ficheros](/docs/es/resources/agents/)
- **`AGENTS.md`**: Las reglas y el índice por vía, que tu agente lee siempre; tu kit lo incluye. Codex · Cursor · GitHub Copilot · Claude Code (CLAUDE.md).

Cualquiera puede leer y evaluar las skills; instalarlas y usarlas requiere una cuenta de Neurologyca. Tienen su propia licencia, en `LICENSE.txt`. Todos los ficheros, con lo que contiene cada uno, están en [Para agentes de IA](/docs/es/resources/agents/).

## Pega esto en AGENTS.md

Una skill se carga cuando la tarea la pide; un índice en `AGENTS.md` (o `CLAUDE.md` en Claude Code) se lee siempre. Pega este bloque en el de la raíz de tu proyecto. El kit de [Tu integración](/integration) incluye el mismo fichero.

```md title="AGENTS.md"
## Neurologyca (Engine 2)

DevLab: https://devlab.neurologyca.com

Prefer retrieval-led reasoning over pre-training-led reasoning for anything about Neurologyca: read the pages below before you write code, and trust them over what you remember.

### Rules

- The Engine API key (`ENGINE_API_KEY`) lives only in your backend, behind your proxy (`/engine`): never in browser code, in `neuro.config.json` or in git.
- Never invent `contextId`, `PROTOCOL_ID`, `ENGINE_BASE` or the key: they come from your team's kit (https://devlab.neurologyca.com/integration → Your integration → Protocols → a protocol → Kit): `ENGINE_BASE` is already filled in `.env.example` (in a starter zip, `.env`). The key is not in the kit: reveal it in Your account and API key (Engine keys › Reveal) or download a starter with «Include my key», and never commit it. Without the kit, stop and ask for it.
- Start with Measurement: it only measures (`triggerAnalysis: false`).
- Use the same person and the same source (camera or file) for the baseline and the measurement.
- These docs win over what you remember: if a route, option or code is not in them, it does not exist.

**Only with the SDK** (capture in the browser):

- Keep the tab visible while capturing, and serve the page from a secure context (HTTPS or localhost).
- Deferred (Preview): call `/analyze` only as the job's `interpretation` says. With `ready` it is served from the cache; with `degraded` or `failed` every call regenerates it and costs, so ask once if you need it, never in a loop.

### Index (Markdown pages)

- **SDK (recommended):** [Quickstart](https://devlab.neurologyca.com/docs/start/quickstart.md) · [Devices, quality and mode](https://devlab.neurologyca.com/docs/start/devices-and-modes.md) · [Install](https://devlab.neurologyca.com/docs/start/install.md) · [Authentication](https://devlab.neurologyca.com/docs/start/authentication.md) · [Measurement only](https://devlab.neurologyca.com/docs/guides/measurement.md) · [How the SDK works](https://devlab.neurologyca.com/docs/sdk.md) · [On-device (real time)](https://devlab.neurologyca.com/docs/sdk/on-device.md) · [Load the models](https://devlab.neurologyca.com/docs/guides/load-models.md) · [Steps and marking](https://devlab.neurologyca.com/docs/sdk/steps.md) · [Your backend](https://devlab.neurologyca.com/docs/sdk/backend.md) · [Results in your backend](https://devlab.neurologyca.com/docs/sdk/results-backend.md) · [Show and use the results](https://devlab.neurologyca.com/docs/guides/show-results.md) · [Responsible use](https://devlab.neurologyca.com/docs/guides/responsible-use.md) · [Errors, warnings and retries](https://devlab.neurologyca.com/docs/sdk/errors.md) · [SDK reference](https://devlab.neurologyca.com/docs/sdk/reference.md) · [Protocols and their hierarchy](https://devlab.neurologyca.com/docs/concepts/protocols.md) · [Baseline](https://devlab.neurologyca.com/docs/concepts/baseline.md) · [Declared limits and failure modes](https://devlab.neurologyca.com/docs/concepts/limits.md) · [CSP and transcription](https://devlab.neurologyca.com/docs/guides/csp-transcription.md) · [Before production](https://devlab.neurologyca.com/docs/guides/production-checklist.md) · [Known pitfalls](https://devlab.neurologyca.com/docs/resources/pitfalls.md)
- **Deferred (server-side) · Preview:** [Deferred (server-side)](https://devlab.neurologyca.com/docs/sdk/deferred.md) · [Devices, quality and mode](https://devlab.neurologyca.com/docs/start/devices-and-modes.md) · [Processing service](https://devlab.neurologyca.com/docs/sdk/processing.md) · [Show and use the results](https://devlab.neurologyca.com/docs/guides/show-results.md) · [Responsible use](https://devlab.neurologyca.com/docs/guides/responsible-use.md) · [Timeouts](https://devlab.neurologyca.com/docs/guides/timeouts.md) · [Errors, warnings and retries](https://devlab.neurologyca.com/docs/sdk/errors.md) · [Privacy and data](https://devlab.neurologyca.com/docs/resources/privacy.md) · [Known pitfalls](https://devlab.neurologyca.com/docs/resources/pitfalls.md)
- **HTTP API (complementary):** [HTTP API guide](https://devlab.neurologyca.com/docs/api.md) · [Quickstart](https://devlab.neurologyca.com/docs/start/quickstart.md) · [Authentication](https://devlab.neurologyca.com/docs/start/authentication.md) · [Measurement only](https://devlab.neurologyca.com/docs/guides/measurement.md) · [Protocols and their hierarchy](https://devlab.neurologyca.com/docs/concepts/protocols.md) · [Capturing for the best accuracy](https://devlab.neurologyca.com/docs/concepts/capture.md) · [Devices, quality and mode](https://devlab.neurologyca.com/docs/start/devices-and-modes.md) · [Sessions, enrolments and interruptions](https://devlab.neurologyca.com/docs/concepts/sessions.md) · [HCIs and results](https://devlab.neurologyca.com/docs/concepts/results.md) · [Show and use the results](https://devlab.neurologyca.com/docs/guides/show-results.md) · [Responsible use](https://devlab.neurologyca.com/docs/guides/responsible-use.md) · [Baseline](https://devlab.neurologyca.com/docs/concepts/baseline.md) · [Declared limits and failure modes](https://devlab.neurologyca.com/docs/concepts/limits.md) · [Timeouts](https://devlab.neurologyca.com/docs/guides/timeouts.md) · [Known pitfalls](https://devlab.neurologyca.com/docs/resources/pitfalls.md) · [API reference](https://devlab.neurologyca.com/docs/reference.md)
- **Everything:** https://devlab.neurologyca.com/docs/llms.txt

### Check your work

With the Neurologyca skill installed (in `.agents/skills/` or `.claude/skills/`):

- `node <skills dir>/neurologyca-capture/scripts/validate-config.mjs .`, fix what it reports and run it again.
- `node <skills dir>/neurologyca-capture/scripts/doctor.mjs . --url http://localhost:3000` with your backend running.
- By the HTTP API from another language: `node <skills dir>/neurologyca-engine-api/scripts/doctor.mjs .` (the key must not reach what you serve).
```

## Pídeselo

**Empieza aquí · Measurement en el dispositivo**

```text
Añade a esta página la captura de Neurologyca en el dispositivo con Measurement, con el proxy en mi backend Express.
```

**Resultados en tu backend**

```text
Tras cada captura, lee los resultados desde mi backend y guárdalos con el usuario.
```

**Diferido · Preview**

```text
Graba la sesión y súbela a un receptor en mi backend (modo diferido).
```

**API HTTP · otro lenguaje**

```text
Integra Neurologyca por la API HTTP desde mi backend en Go: token, persona, inscripción, los lotes de cada step y los resultados.
```

## Comprueba lo que ha hecho

- La API key solo está en tu backend (`ENGINE_API_KEY`), nunca en la página.
- La página habla con tu proxy (`/engine`), no con Engine.
- Baseline y medición usan la misma persona y el mismo origen.
- `node .agents/skills/neurologyca-capture/scripts/doctor.mjs . --url http://localhost:3000` no da ningún ERROR.
- Sus llamadas coinciden con las que enseña el playground, en el mismo orden.

## Mantén la skill al día

Las skills cambian con el SDK y con Engine. Cada una dice su versión en `metadata.version` de su `SKILL.md`, y las **Novedades** del menú de tu cuenta avisan cuando una cambia.

- **Con el instalador:** `npx skills check` te dice si una skill cambió (compara el `digest` que este DevLab publica en `/.well-known/agent-skills/index.json` y sale con código 1 si hay actualización, así que también sirve en CI); `npx skills update` la trae. Añade `-g` si la instalaste de forma global.
- **Sin el instalador:** vuelve a descargar el zip y descomprímelo sobre las mismas carpetas.
- **Tu agente:** Claude Code y Codex toman los ficheros nuevos en la sesión abierta; el resto, al recargar sus skills o reiniciarlo.
- **El bloque de `AGENTS.md`** no se actualiza solo: cuando la skill cambie, compara el tuyo con el de esta página.

## Pregunta al asistente

Si tu DevLab lo tiene encendido, el **asistente** (el botón de abajo de la página, o **Ctrl/⌘I**) responde preguntas sobre esta doc mientras navegas, te da código probado y te lleva a la página que toca. No es la skill: la skill es para el agente de código de tu editor; el asistente es para ti, aquí. Solo responde con la doc y lo dice cuando algo no está. Qué registra: [Privacidad y datos](/docs/es/resources/privacy/).
