# Instrucciones para el agente: Caveman: acorta respuestas y comprime entradas para ahorrar tokens

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/JuliusBrussee/caveman (licencia Apache-2.0)
- Guía completa: https://lab.wisd.ai/hub/caveman-token-saver

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Paso 1: elige el alcance

Lee [Install](https://github.com/JuliusBrussee/caveman/blob/9b68f7ed12b05e7efaff18e65c5a3fc2849fd0a4/README.md#install) y la sección Privacy del README. Empieza con la skill si tu objetivo es acortar respuestas. El CLI completo modifica más componentes y requiere Node.js 22.13 o posterior.

### Paso 2: instala solo la skill

Comprueba que tienes Node.js ≥22.20.0 y npm/npx disponibles para ejecutar la [CLI skills actual](https://github.com/vercel-labs/skills/blob/main/package.json). Este requisito del instalador de skills es mayor que Node 22.13 del CLI Caveman. Comando del README:

```bash
npx skills add JuliusBrussee/caveman -g
```

El ámbito es global para el usuario. Revisa el arnés elegido por el instalador. Si no se activa sola, el README indica `/caveman` y, en Codex, `$caveman`. Para volver al estilo habitual, escribe `stop caveman`.

### Paso 3: incorpora el CLI solo si necesitas comprimir entradas

Comprueba que Node.js es 22.13 o posterior antes de esta ruta. Como alternativa más amplia, el README ofrece:

```bash
npx @caveman-ai/cli@latest
```

Revisa los cambios que muestra el asistente antes de aplicarlos. Después consulta los componentes activos:

```bash
caveman status
caveman doctor
```

Si no quieres telemetría, el README documenta:

```bash
caveman telemetry off
```

Prueba la compresión con una salida de pruebas, desde un proyecto que tenga ese comando:

```bash
caveman shrink -- pnpm test
```

Es el ejemplo oficial; presupone pnpm y un script test. Para otro proyecto usa un comando de pruebas que ya exista, sin asumir que este ejemplo le corresponde.

## Comprobación

Compara una tarea pequeña con y sin la skill. Verifica que el código, las rutas y los mensajes de error siguen completos. Con el CLI, comprueba status y revisa qué llega al agente y qué conserva el archivo original. No extrapoles las cifras del README a tu sesión.

## Si algo falla

Consulta [INSTALL.md](https://github.com/JuliusBrussee/caveman/blob/9b68f7ed12b05e7efaff18e65c5a3fc2849fd0a4/INSTALL.md) para tu arnés y la salida de doctor. Si solo instalaste la skill y quieres retirarla, el README indica:

```bash
npx skills remove JuliusBrussee/caveman -g
```

La desinstalación de la skill no equivale a retirar toda la distribución del CLI; usa su guía de instalación para ese caso.