# Caveman Stats

> Show real token usage and estimated savings for the current session. Reads directly from the Claude Code session log — no AI estimation. Triggers on /caveman-stats. Output is injected by the mode-tracker hook; the model itself does not compute the numbers.

Source: https://skillsagentes.com/skills/juliusbrussee/caveman/caveman-stats
Repository: https://github.com/JuliusBrussee/caveman
Author: juliusbrussee
License: MIT
Updated: hace 25 días
Context cost: 65 tok installed, 288 tok once triggered, 814 tok with every bundled file
Bundle: 2 files, 3 KB
Permissions requested: none declared

## Install

```bash
npx -y skills add JuliusBrussee/caveman --skill caveman-stats --agent claude-code
```

## What it does

- Muestra el uso real de tokens y el ahorro estimado de la sesión actual, leído directamente del log de sesión de Claude Code, sin estimación del modelo.
- La salida la entrega el hook hooks/caveman-stats.js (leído por hooks/caveman-mode-tracker.js al invocar /caveman-stats); el modelo mismo no calcula los números.
- Incluye "Est. rule overhead" (costo estimado de las reglas caveman inyectadas por turno, 1.250 tokens/turno por defecto, configurable con CAVEMAN_RULE_OVERHEAD_TOKENS) y "Est. net" (ahorro menos ese overhead).
- Si el neto es negativo lo dice explícitamente y sugiere apagar caveman para esa carga de trabajo, en vez de esconderlo detrás del ahorro bruto.

## Use it when

- El usuario invoca /caveman-stats.

## What triggers it

- "/caveman-stats"
- "cuántos tokens ahorré con caveman esta sesión"

## Before you install

- Depende del hook hooks/caveman-stats.js y del log de sesión de Claude Code; no es el modelo quien calcula las cifras.

## Files

- README.md — 2 KB
- SKILL.md — 1 KB

## SKILL.md

Reproduced verbatim from JuliusBrussee/caveman under MIT. This section is the upstream document and is in English.

This skill is delivered by `hooks/caveman-stats.js` (read by `hooks/caveman-mode-tracker.js` on `/caveman-stats`). The model does not need to do anything when this skill fires — the hook returns `decision: "block"` with the formatted stats as the reason. The user sees the numbers immediately.

Output also includes `Est. rule overhead` and `Est. net` lines wherever a savings estimate exists with a known turn count. Rule overhead is the estimated per-turn INPUT-token cost of the injected caveman rules (default 1,250 tokens/turn, override with `CAVEMAN_RULE_OVERHEAD_TOKENS`) times the turn count. Net is savings minus that overhead — when negative, the output says so plainly and suggests turning caveman off for that workload, rather than hiding the net-negative regime behind a gross-savings number (see `docs/HONEST-NUMBERS.md`).

---

Skills Agentes — https://skillsagentes.com/skills/juliusbrussee/caveman/caveman-stats