caveman-stats
Track Caveman Token Savings
Claude Code users need reliable token receipts without asking the model to estimate usage. This skill documents a hook-based command that reports session tokens and estimated savings from the local log.
Install with my Agent
Copy this request to your Agent. It includes the canonical Skill page and manifest.
Review the Skillstore skill "caveman-stats" from https://skillstore.io/skills/juliusbrussee-caveman-stats.md and its manifest at https://skillstore.io/api/skills/juliusbrussee-caveman-stats/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.Your Agent should still show its plan and request any confirmation required by the security policy.
Agent-readable resources
Use these links when an AI agent, crawler, or script needs clean context instead of reading the full page.
Test it
Using "caveman-stats". User runs /caveman-stats during a Claude Code session.
Expected outcome:
A receipt-style summary shows session turns, input tokens, Caveman output tokens, baseline output estimate, and saved tokens.
Using "caveman-stats". User asks for a short explanation after viewing the stats.
Expected outcome:
The response explains whether the session used fewer output tokens than the estimated baseline.
Using "caveman-stats". Maintainer checks the statusline behavior after several sessions.
Expected outcome:
The workflow describes a lifetime-savings suffix that can appear in a statusline badge.
Security Audit
SafeBoth static findings are documentation-only false positives. README.md line 30 is a relative Markdown link, and SKILL.md line 10 uses inline code formatting rather than executable backticks.
Risk Factors
๐ Filesystem access (1)
โ๏ธ External commands (1)
Share & cite this report
Share the versioned assessment report, neutral badge, embed card, and citations. Skillstore reports evidence without deciding whether this Skill is safe.
Copy report link
https://skillstore.io/skills/juliusbrussee-caveman-stats/audits/4?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_reportMarkdown badge
[](https://skillstore.io/skills/juliusbrussee-caveman-stats?utm_source=security_passport_badge)HTML badge
<a href="https://skillstore.io/skills/juliusbrussee-caveman-stats?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/juliusbrussee-caveman-stats/security.svg" alt="Skillstore security assessment" loading="lazy"></a>Embed card
<iframe src="https://skillstore.io/embed/skills/juliusbrussee-caveman-stats.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>Academic citations (APA ยท BibTeX ยท CFF)
APA citation
juliusbrussee. (2026). caveman-stats security audit report (audit version 4) [Author version unspecified]. Skillstore. https://skillstore.io/skills/juliusbrussee-caveman-stats/audits/4BibTeX citation
@techreport{juliusbrussee-juliusbrussee-caveman-stats-2026,
author = {juliusbrussee},
title = {caveman-stats security audit report (audit version 4)},
institution = {Skillstore},
year = {2026},
number = {4},
url = {https://skillstore.io/skills/juliusbrussee-caveman-stats/audits/4},
note = {Author version unspecified}
}CITATION.cff
cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "caveman-stats security audit report (audit version 4)"
version: "unspecified"
type: report
authors:
- name: "juliusbrussee"
date-released: "2026-07-05"
url: "https://skillstore.io/skills/juliusbrussee-caveman-stats/audits/4"
identifiers:
- type: other
value: "skillstore:juliusbrussee-caveman-stats:audit:4"
description: "Skillstore immutable audit report identifier"
Skillstore Score
Why this score Evidence Confidence: HighWhat You Can Build
Review Session Cost
Check real token usage after a Claude Code work session and see the estimated Caveman savings.
Track Team Efficiency
Use receipt-style stats to discuss whether Caveman workflows reduce output tokens across similar tasks.
Validate Hook Output
Confirm that the /caveman-stats hook returns the expected token fields and statusline suffix behavior.
Try These Prompts
/caveman-stats
Run /caveman-stats, then summarize input, output, baseline, and saved percentage.
Use /caveman-stats to capture the current session, then explain how the savings affect this task's token budget.
Use /caveman-stats and review whether the current session has unusual output volume or low savings. Recommend one workflow adjustment.
Best Practices
- Run the command after meaningful work, when the session has enough turns to measure.
- Treat savings as directional estimates, not billing records.
- Keep Caveman hooks installed and versioned with the workflow that consumes the skill.
Avoid
- Using the numbers as exact invoice data.
- Running the command in an environment without the required hook.
- Comparing sessions with very different task scope as if they are equivalent.
Frequently Asked Questions
Does this skill calculate tokens with AI?
How do I invoke it?
Are the savings exact?
Does it work without the hook files?
Can Codex use this marketplace entry?
What does the statusline badge show?
Developer Details
Author
juliusbrusseeLicense
MIT
Skillstore revision
r1
Version notice
The author did not declare a version.
Ref
a25199bc7d6b82598536822d1738eb5d5f54025b
Maintenance freshness
7/18/2026
Usage
8 downloads ยท 41 views