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.
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 archivoLICENSE-MITparalelo 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>.
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:
- Respuesta primero. Patrón fijo:
[cosa] [acción] [razón]. [siguiente paso]. - Fuera la ceremonia. Nada de "claro", "encantado de ayudarte", "espero que te sirva".
- Nunca cae un significado. Los artículos pueden irse.
no,nuncay los números nunca se van. - La carga útil, letra a letra. Código, comandos, rutas y errores no se tocan.
- 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.
- Sabe cuándo parar. Avisos de seguridad, pasos irreversibles y usuarios confundidos recuperan frases completas.
- 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:
curl -fsSL https://raw.githubusercontent.com/JuliusBrussee/caveman/v4.1.0/install.sh | bashEn Windows con PowerShell 5.1 o superior:
irm https://raw.githubusercontent.com/JuliusBrussee/caveman/v4.1.0/install.ps1 | iexEl 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:
npx skills add JuliusBrussee/caveman -gY si solo quieres el plugin de Claude Code:
claude plugin marketplace add JuliusBrussee/caveman
claude plugin install caveman@cavemanTras 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 stopo escribir "normal mode". - Comandos añadidos. El plugin añade tres slash commands útiles fuera de la voz:
/caveman-commitescribe el mensaje de commit siguiendo Conventional Commits, con el mismo tono seco./caveman-reviewrevisa elgit diffen busca de "humo" (comentarios decorativos, imports no usados, logs olvidados) y lo lista plano./caveman-statsmuestra cuántos tokens te ha ahorrado la sesión.- Aliases.
/ultracavey/megacaveson 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/plany 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:
- 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.
- "Be concise" es la base real. Caveman corta un 3 % extra en la mediana,
/ultracaveun 35 % extra. - 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 aparecenpm error code EALLOWGIT. Solución: usa el one-linerv4.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 22y vuelve a lanzarcaveman 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ñadeCAVEMAN.mdy referencia desdeCLAUDE.mdcon una línea; borra esa línea para desactivarlo sin desinstalar. - Caja negra para el consumo.
caveman statscuenta contiktoken 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
claude plugin marketplace add JuliusBrussee/caveman
claude plugin install caveman@cavemannpx skills add JuliusBrussee/caveman -g2. Elige tu caso
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
- Abre Claude Code en la carpeta vacía del proyecto y pega el prompt como primer mensaje.
- Revisa el
CLAUDE.mdque crea: la regla de caveman queda ahí para las próximas sesiones. - Si algo te cuesta entenderlo, escribe "normal mode" o
/caveman stopy vuelve a/cavemancuando quieras. - Al cerrar la sesión ejecuta
/caveman-statspara ver cuántos tokens te ahorró.
Este repo ya tiene CLAUDE.md y sus convenciones. Quiero medir si caveman nos ahorra tokens sin perder calidad.
1. Lee CLAUDE.md primero: sus reglas mandan sobre el estilo de caveman.
2. Trabaja en modo /caveman (no ultra) durante esta sesión. No reescribas mis prompts ni cambies código que no te pida.
3. En cada cambio: muestra el diff, corre los tests del proyecto y pasa /caveman-review sobre el git diff antes de proponer el commit.
4. Usa /caveman-commit para los mensajes de commit.
5. Vuelve a frases completas en avisos de seguridad, migraciones de datos o comandos destructivos.
6. Al terminar ejecuta /caveman-stats y dame una tabla: tareas hechas, tokens ahorrados y cualquier respuesta que haya quedado menos clara.3. Guía de uso
- Si usas el instalador completo, corre
caveman doctor(Node 22.13+, Git Bash en Windows) ycaveman setuppara elegir qué rocas dejar activas. - Haz una tarea real con caveman y otra parecida sin él: compara
/caveman-statsy la calidad del diff antes de dejarlo para todo el equipo. - Si una roca choca con tu flujo, apágala sola con
caveman off <roca>en vez de desinstalar todo. - Si pagas por petición (GitHub Copilot) y no por tokens, las respuestas cortas no te ahorran dinero: valóralo antes.
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.
- Compártelo con alguien a quien le sirvaWhatsAppLinkedInXFacebook
- Llévate el kit para agenciasVer qué incluyeComprar
- Conoce a nuestro patrocinadorSafe Build Labs
Más sobre Agentes de IA

guía · Guía completa de ECC para Claude Code · #8
- Seguridad y revisión de código
- Claude Code

guía · Guía completa de ECC para Claude Code · #7
- Claude Code
- Skills para tus agentes

guía · Guía completa de ECC para Claude Code · #6
- Claude Code
- Skills para tus agentes