CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

73

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is caveman-stats in JuliusBrussee/caveman

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exemplary minimal body for a hook-delivered skill: it documents exactly the non-obvious delivery mechanism and the model's (non-)role with zero waste. The only improvement would be one sentence of fallback guidance for when the hook is absent or fails.

Suggestions

Add a brief fallback instruction, e.g., "If the hook is not installed or fails, tell the user this skill requires the caveman-mode hooks rather than attempting to compute stats yourself" — this would close the actionability gap.

Optionally state where the user sees the output and roughly what the injected stats look like, so the model can answer follow-up questions about the numbers without guessing.

DimensionReasoningScore

Conciseness

The body is four lean sentences covering only what Claude would not already know — the hook delivery path (`hooks/caveman-stats.js`, `hooks/caveman-mode-tracker.js`) and the `decision: "block"` mechanism. There is no padding, no explanation of known concepts, and every token earns its place, matching anchor 5.

5 / 5

Actionability

The guidance is concrete and executable for the intended path — "The model does not need to do anything when this skill fires — the hook returns `decision: \"block\"` with the formatted stats as the reason" — with real file names and hook semantics. It falls short of anchor 5 only because there is no fallback instruction (e.g., what to do if the hook is not installed or fails), leaving a minor gap.

4 / 5

Workflow Clarity

This is a simple, single-purpose skill where the entire workflow is one unambiguous action: the model does nothing and the hook handles everything. Per the simple-skill exception, the unambiguous single action merits 5, and no destructive or batch operations exist that would trigger the validation cap.

5 / 5

Progressive Disclosure

The body is under 50 lines with no content that warrants external reference files; the inline pointers to `hooks/caveman-stats.js` and `hooks/caveman-mode-tracker.js` are one level deep and clearly signaled, and no references/ or scripts/ bundle exists. Per the under-50-lines guideline this matches anchor 5.

5 / 5

Total

19

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A tight, well-scoped description that states concrete actions, an explicit trigger, and the delivery mechanism without padding. Its only real weakness is limited keyword breadth — a couple of natural synonyms (cost, spend) would strengthen retrieval.

DimensionReasoningScore

Specificity

The description lists several concrete actions and mechanisms — "Show real token usage and estimated savings for the current session", "Reads directly from the Claude Code session log — no AI estimation", and "Output is injected by the mode-tracker hook" — which goes beyond naming 1-2 actions (anchor 3) but stops short of comprehensive multi-action coverage (anchor 5).

4 / 5

Completeness

The "what" is clearly answered ("Show real token usage and estimated savings for the current session") and the "when" is explicit and concrete ("Triggers on /caveman-stats"), matching the anchor-5 example that answers both with concrete trigger phrases. It is not score 4 because the trigger is not merely implied or generic — it names the exact invocation.

5 / 5

Trigger Term Quality

Natural terms like "token usage", "estimated savings", and "session" are present alongside the explicit trigger "Triggers on /caveman-stats", giving good keyword coverage for a user who wants usage stats; a few natural synonyms (e.g., "cost", "spend", "token count") are missing, which fits anchor 4 rather than anchor 5.

4 / 5

Distinctiveness Conflict Risk

The combination of a specific niche (session token usage and savings reported from the session log) with a distinct, unique slash-command trigger (/caveman-stats) gives minimal conflict risk with other skills, matching anchor 5 rather than anchor 4's "minor overlap risk with closely related skills".

5 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

masweb/waxp-vuebo

Path

.agents/skills/caveman-stats/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.