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.
How do I install this agent skill?
npx skills add https://github.com/juliusbrussee/caveman --skill caveman-statsIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a utility for displaying session statistics, such as token usage and cost savings, by reading local session logs. It contains no executable code or malicious patterns in its documentation.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
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).
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/juliusbrussee/caveman/caveman-stats">View caveman-stats on skillZs</a>