~/codigoagente
Agentes de IA

Caveman: la skill que hace hablar a tu agente como cavernícola y gasta 33 % menos tokens (prueba real)

Al final del artículo tienes el comando, el prompt listo para copiar y un .md para descargar.

Caveman es una skill (y plugin) para Claude Code, Codex, Gemini CLI y una treintena más de agentes que obliga a tu modelo a responder como cavernícola: frases cortas, sin saludos, sin "claro, encantado de ayudarte" y sin cambiar ni un carácter del código. En el repositorio JuliusBrussee/caveman está medida la diferencia: 35 % menos tokens de salida con /ultracave, 33,2 % menos tokens de entrada por sesión gracias al compresor de logs y un coste 0,46× el de Opus en modo xhigh cuando dejas que el Auto elija por ti. Citada por Adobe Research, A/B testeada por JetBrains y publicada bajo doble licencia Apache-2.0 + MIT.

Mismo arreglo, 63 tokens frente a 20. La skill corta el relleno, no el código · codigoagente

Qué es Caveman y quién lo hace

  • Repositorio: github.com/JuliusBrussee/caveman, publicado por Julius Brussee. Versión analizada: v4.1.0.
  • Licencia: Apache-2.0 por defecto (LICENSE) con un archivo LICENSE-MIT paralelo que permite usar la skill también como MIT. Puedes usarlo en proyectos cerrados sin pagar nada.
  • Formato: Caveman se instala de tres maneras, según cuánto quieras: solo la skill (cambia la voz del agente), el plugin de Claude Code (añade los comandos /caveman-review, /caveman-commit, /caveman-stats) o el instalador completo que mete además el compresor de tool-output, las MCP tools y los hooks que mantienen la caché caliente.
  • Qué no es: Caveman no cambia tu prompt ni toca el código generado. El propio README cita el estudio CAVEWOMAN de Adobe: comprimir el prompt del usuario empeora el resultado, así que la skill solo toca lo que el modelo escribe y lo que lee del entorno.
  • Qué agentes lo soportan: Claude Code (plugin nativo), Codex CLI (hook SessionStart), Gemini CLI (extensión), Cursor, OpenCode, Oh My Pi, OpenClaw, Hermes, Antigravity y una treintena más listados en INSTALL.md.

Las seis "rocas" que trae Caveman 4.1

Desde la versión 4.0 el proyecto se divide en seis piezas que se activan solas al instalar. Puedes encender o apagar cada una con caveman on <rock> y caveman off <rock>.

Resumen de las seis rocas con las métricas que publica el propio README · codigoagente

1. Say less: la voz cavernícola

Es la skill original: cambia cómo responde el agente. Las reglas están escritas en skills/caveman/SKILL.md y son siete, no siete párrafos de filosofía:

  1. Respuesta primero. Patrón fijo: [cosa] [acción] [razón]. [siguiente paso].
  2. Fuera la ceremonia. Nada de "claro", "encantado de ayudarte", "espero que te sirva".
  3. Nunca cae un significado. Los artículos pueden irse. no, nunca y los números nunca se van.
  4. La carga útil, letra a letra. Código, comandos, rutas y errores no se tocan.
  5. Una idea por frase. Estilo ASD-STE100, el inglés controlado de los manuales de aviación: 20 palabras máximo, voz activa, un término por cosa.
  6. Sabe cuándo parar. Avisos de seguridad, pasos irreversibles y usuarios confundidos recuperan frases completas.
  7. Tu prompt no se toca. Reescribirlo empeora el resultado, dice Adobe.

Hay dos primos: /ultracave corta aún más (35 % menos salida que "Answer concisely." sobre 10 preguntas) y /megacave responde en chino clásico (13 tokens por respuesta). Se activan con /caveman ultra o /caveman wenyan.

2. Read less: comprime lo que entra al modelo

Es la pieza menos obvia y la que más ahorra. Cuando el agente llama a bash, grep, read_file o una tool MCP, la salida pasa por un filtro local antes de entrar en el contexto: logs resumidos, JSON sin claves redundantes, CSV con columnas descartadas y salida de tests podada a lo que falla. En la propia batería del repo (6 tareas sintéticas con mucha salida, 18 pares) el agente recibe un 33,2 % menos de tokens de entrada por sesión sin fallar ninguna respuesta.

3. Auto: elige modelo y esfuerzo por ti

Decide qué modelo usar y con qué reasoning_effort, pregunta por pregunta. Para 85 tareas de código mide 0,46× el coste de Opus siempre en xhigh, con una diferencia de calidad de ±7 puntos que todavía no está cerrada. Es la única pieza que necesita cuenta en caveman.so, y es gratis.

4. Blocks: code mode con scripts reutilizables

Cuando tu agente escribe un script bash o Python para resolver una tarea, Caveman lo guarda. La próxima vez que tenga que correr lo mismo (por ejemplo, el mismo test o la misma consulta a Postgres) reutiliza el script en lugar de volver a generarlo. El ejemplo del README: ejecutar un test pasa de 397 tokens a 76 (| tail -20 comparado con el bloque guardado).

5. Waste fixes

Analítica local de a dónde van tus tokens, con un panel caveman stats. Además mantiene la caché de prompt caliente cuando haces pausas largas: si vuelves al cabo de minutos, la sesión no recompacta el contexto desde cero.

6. Browse

Un Playwright en modo cavernícola: las páginas web vuelven comprimidas. En un ejemplo del repo una tabla de 200 filas pasa de 15 704 tokens a 121 cuando haces la consulta con un filtro.

Instalar Caveman en Claude Code (y en el resto)

El autor recomienda el instalador unificado. En macOS, Linux o WSL con curl:

terminalsh
curl -fsSL https://raw.githubusercontent.com/JuliusBrussee/caveman/v4.1.0/install.sh | bash

En Windows con PowerShell 5.1 o superior:

terminalsh
irm https://raw.githubusercontent.com/JuliusBrussee/caveman/v4.1.0/install.ps1 | iex

El script detecta cada agente que ya tienes instalado y usa su ruta nativa: claude plugin install para Claude Code, gemini extensions install para Gemini CLI, un hook SessionStart para Codex. Si no te fías del curl … | bash, descárgalo primero y léelo: todos los binarios de runtime se verifican con una lista de SHA-256 firmada por una clave empotrada en la CLI, y los hook se validan contra el mismo v4.1.0 del instalador.

Si te basta con la skill (sin compresor, sin hooks), hay un camino mínimo:

terminalsh
npx skills add JuliusBrussee/caveman -g

Y si solo quieres el plugin de Claude Code:

terminalsh
claude plugin marketplace add JuliusBrussee/caveman
claude plugin install caveman@caveman

Tras instalar, lanza caveman setup para elegir qué rocas dejar activas. caveman status enseña el estado y caveman doctor revisa dependencias (Node 22.13+, Git Bash en Windows, permisos de escritura en ~/.caveman).

La skill por dentro: qué cambia en tus sesiones

  • Activación. Al abrir Claude Code con el plugin se carga skills/caveman/SKILL.md, que es lo que lee el modelo. Mientras la skill está activa, Claude escribe en modo cavernícola. Para apagarla: /caveman stop o escribir "normal mode".
  • Comandos añadidos. El plugin añade tres slash commands útiles fuera de la voz:
  • /caveman-commit escribe el mensaje de commit siguiendo Conventional Commits, con el mismo tono seco.
  • /caveman-review revisa el git diff en busca de "humo" (comentarios decorativos, imports no usados, logs olvidados) y lo lista plano.
  • /caveman-stats muestra cuántos tokens te ha ahorrado la sesión.
  • Aliases. /ultracave y /megacave son skills separadas con las mismas reglas duras; responder en chino clásico (wenyan) baja un 7 % extra en pruebas internas del autor.
  • Subagentes cavecrew. Si tu agente soporta subagentes nativos (Claude Code sí), el instalador registra investigador, constructor y revisor, todos hablando corto. Útil para /plan y refactors largos.

Lo que mide el proyecto (y lo que no)

El README.md publica los números con sus condiciones, y recomendamos leer la sección "HONEST-NUMBERS" antes de atribuirle milagros:

  • Terminal-Bench 4, GPT-6.1 Sol vs Codex: 21 % más barato por tarea resuelta ($1,21 vs $1,52, 90 de 192 tareas resueltas por ambos).
  • Terminal-Bench 4, Opus 5.5 vs Claude Code: empate dentro del ruido (97/180 vs 83/177, $5,19 vs $6,04 por tarea resuelta).
  • Adobe Research, paper CAVEWOMAN: salida cavernícola en 8 modelos y 5 datasets, coste cortado entre 1,4× y 2,4×, hasta 3× en los casos extremos.
  • Elastic, Elasticsearch Labs: 63,6 % menos tokens de respuesta en 8 escenarios MCP, "cero pérdida de información".
  • JetBrains, 86 tareas reales: sin pérdida de calidad medible (p = 0,82), 8,5 % menos tokens de salida.

Tres matices importantes:

  1. Las reglas suman alrededor de 1 160 tokens de entrada cada vez que se cargan. Si pagas por petición (GitHub Copilot) y no por tokens, las respuestas más cortas no te ahorran nada.
  2. "Be concise" es la base real. Caveman corta un 3 % extra en la mediana, /ultracave un 35 % extra.
  3. Los nuevos modelos (Claude 5.5, GPT-6.1) ya responden más breve por defecto; parte del ahorro se solapa con lo que hace el propio proveedor.

Problemas que nos ha dado

  • npm 12 corta los npx -y github:.... Si tu npm es 12 o superior aparece npm error code EALLOWGIT. Solución: usa el one-liner v4.1.0, que detecta la versión y añade --allow-git=root, o pasa el flag a mano.
  • Node < 22.13. El compresor y el Auto no arrancan. En Linux: nvm install 22 y vuelve a lanzar caveman setup.
  • Bun solo. El instalador soporta Bun, pero los hooks nativos requieren Node ≥ 18; si solo tienes Bun el instalador instala las skills y avisa de lo que no puede activar.
  • El plugin pisa tu CLAUDE.md. No: el instalador añade CAVEMAN.md y referencia desde CLAUDE.md con una línea; borra esa línea para desactivarlo sin desinstalar.
  • Caja negra para el consumo. caveman stats cuenta con tiktoken o200k, no con el contador real del proveedor. Te da el orden de magnitud, no la factura exacta.

Preguntas frecuentes

¿Sirve para proyectos de clientes? Sí. Apache-2.0 y MIT permiten uso comercial y modificación sin obligación de publicar derivados. Lo único que no puedes hacer es usar el nombre o el logo de Caveman para endosar un producto tuyo.

¿Pierdo claridad en avisos de seguridad? No. La regla 7 obliga al modelo a volver a frases completas cuando detecta un paso irreversible, un aviso de seguridad o que el usuario está perdido.

¿Funciona con una cuenta Claude Pro? Sí. Caveman reutiliza el login de Claude Pro / Max que ya tiene tu CLI. La única parte que pide cuenta aparte es Auto, y esa cuenta es gratuita en caveman.so.

¿Y si no me gusta el inglés roto? El chiste es la cuña; en la práctica responde en frases cortas, no en gruñidos. Si prefieres solo el recorte sin estética cavernícola, claude plugin install caveman@caveman y luego /ultracave: mismo recorte, voz menos teatral.

Veredicto

Caveman es la primera skill que combina las tres cosas que se piden desde que salieron los agentes: salida corta, entrada controlada y uso del modelo barato por defecto. Las tres se activan con un curl … | bash y cada rocas se puede apagar si molesta. No cambia tu prompt, no toca tu código y publica sus números con los casos donde pierde: para un blog o un SaaS que paga Claude a cambio de tokens, la pregunta es más bien por qué no tenerlo activo.

El siguiente paso lógico en este tema es combinarlo con una skill de revisión seria, como Open Code Review en Claude Code o Superpowers, o con Caveman + Impeccable para que la salida corta no se pelee con el diseño.

// recurso · úsalo directamente

Caveman listo para usar en Claude Code

Instala el plugin, copia el prompt de tu caso y pégalo como primer mensaje de la sesión. Funciona con tu plan de Claude Pro o Max; no necesitas API key.

Licencia del repositorio: Apache-2.0 + MIT

1. Instala

Plugin de Claude Code
claude plugin marketplace add JuliusBrussee/caveman
claude plugin install caveman@caveman
Solo la skill (cualquier agente)
npx skills add JuliusBrussee/caveman -g

2. Elige tu caso

Pega este prompt en tu agente
Vamos a empezar este proyecto con la skill caveman activa para gastar menos tokens.

1. Comprueba que la skill caveman está cargada. Si no lo está, dime el comando para instalarla y para aquí.
2. Activa el modo /caveman (no ultra) para toda la sesión: respuestas cortas, pero código, comandos, rutas y errores exactos, sin recortar.
3. Vuelve a frases completas en avisos de seguridad, comandos destructivos o si te digo que no entiendo algo.
4. Crea un CLAUDE.md mínimo con: stack, comandos de instalación, desarrollo y tests, y esta regla: "Responde en modo caveman salvo en avisos de seguridad y pasos irreversibles".
5. Antes de escribir código, dame el plan en 5 líneas como máximo y espera mi OK.
6. Para cada commit usa /caveman-commit (Conventional Commits).

3. Guía de uso

  1. Abre Claude Code en la carpeta vacía del proyecto y pega el prompt como primer mensaje.
  2. Revisa el CLAUDE.md que crea: la regla de caveman queda ahí para las próximas sesiones.
  3. Si algo te cuesta entenderlo, escribe "normal mode" o /caveman stop y vuelve a /caveman cuando quieras.
  4. Al cerrar la sesión ejecuta /caveman-stats para ver cuántos tokens te ahorró.
Prompt y guía corta en un archivoRepositorioJuliusBrussee/caveman

Nos ayuda a crecer

codigoagente es gratis y sin muros de pago. Si este artículo te sirvió, cualquiera de estas cosas mantiene el blog en marcha.

// newsletter

Un correo a la semana con los repos que valen la pena

Los artículos nuevos de la semana, probados con código real. Sin spam; te das de baja con un clic.

Agentes de IA

guía · Guía completa de ECC para Claude Code · #8

AgentShield, el escáner de ECC, revisa CLAUDE.md, settings.json, MCP, hooks y agentes. Lo probamos con una configuración vulnerable y con el propio ECC.
  • Seguridad y revisión de código
  • Claude Code
leer artículo
Agentes de IA

guía · Guía completa de ECC para Claude Code · #7

Medimos cuánto contexto ocupa ECC con /ecc:context-budget --audit (unos 12.500 tokens en el perfil minimal) y cómo recortarlo: modelo, compactación y MCP.
  • Claude Code
  • Skills para tus agentes
leer artículo
Agentes de IA

guía · Guía completa de ECC para Claude Code · #6

Qué hacen los 28 hooks de ECC, cómo GateGuard frena la primera edición, cómo guardar y retomar sesiones y cómo funcionan los instincts del aprendizaje continuo.
  • Claude Code
  • Skills para tus agentes
leer artículo