CtrlK
BlogDocsLog inGet started
Tessl Logo

caveman-stats

Show recorded output and cache-read token usage and mode attribution for the current Claude Code session, or locate the host's native usage report. Trigger: /caveman-stats.

63

Quality

74%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/caveman-stats/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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.

The body is a tight, honest, host-aware instruction set that tells Claude exactly what to print and what never to infer, scoring well on all dimensions for a simple instruction-only skill. Its only weaknesses are a small amount of repeated savings caveats and the absence of section headers or detail on how flag arguments are supplied.

DimensionReasoningScore

Conciseness

The body is lean instruction-only prose with no explanations of concepts Claude already knows, but the savings-are-unknown point is repeated three times ("Savings remain unknown in every host", "Savings are unknown: the transcript has no measured comparison", "do not establish provider token or billing savings"), which could be trimmed. Fits anchor 4 rather than 5 due to this small redundancy.

4 / 5

Actionability

Concrete, executable guidance throughout: print the hook report "verbatim inside a fenced code block" via hookSpecificOutput.additionalContext, direct Gemini users to "/stats model" or "/stats session", and fall back to a native report or state unavailability. Minor gaps: the --all/--since 7d/--share flags are described but how the user passes them is not stated, keeping it below anchor 5.

4 / 5

Workflow Clarity

A simple single-purpose skill under 50 lines whose single action is unambiguous per host: print the hook-supplied report verbatim without recomputing, route Gemini to built-in /stats commands, and otherwise report unavailability. Per the simple-skill exception (no destructive or batch operations), this matches anchor 5.

5 / 5

Progressive Disclosure

At under 50 lines with no bundle files needed, the content is organized by host and topic with a clearly signaled one-level reference ("See docs/HONEST-NUMBERS.md"). No section headers and a bare unexplained reference to src/hooks file paths leave minor organization gaps, so anchor 4 rather than 5.

4 / 5

Total

17

/

20

Passed

Description

67%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.

The description is specific, third-person, and honest about scope, with explicit command-trigger guidance. Its main weakness is narrow trigger-term coverage: users asking about cost, spend, or statistics in natural language would not obviously match it.

Suggestions

Add natural-language trigger phrases alongside the command trigger, e.g. "Use when the user asks about token usage, cache-read tokens, cost, or session statistics in Claude Code, or when they type /caveman-stats."

Include common synonyms users would say ("tokens used", "spend", "usage statistics") to improve trigger matching beyond the current narrow set.

Mention the aggregation capabilities (--all, --since) or response counts in the description so the 'what' fully covers what the skill reports.

DimensionReasoningScore

Specificity

"Show recorded output and cache-read token usage and mode attribution" and "locate the host's native usage report" list several concrete, third-person actions, with minor gaps (e.g., response counts and aggregation flags from the body are not mentioned). Not a 5 because coverage is not comprehensive; clearly above anchor 3's 1-2 actions.

4 / 5

Completeness

The "what" is clear (show session usage and mode attribution, or locate the host's native report) and "Trigger: /caveman-stats" is explicit trigger guidance, so the missing-'Use when' cap does not apply. Not a 5 because the trigger is command-only with no natural-language trigger phrases describing when a user needs it.

4 / 5

Trigger Term Quality

Natural terms like "token usage", "cache-read token usage", "usage report", and "session" are present, but common variations users would say are missing: "cost", "spend", "tokens used", "statistics". Fits anchor 3 (relevant keywords, missing variations/synonyms) rather than anchor 4's good coverage.

3 / 5

Distinctiveness Conflict Risk

Scoped to "the current Claude Code session" with host-specific routing (Claude Code, Gemini CLI, other hosts) and a distinct /caveman-stats trigger, making it mostly distinct. Minor overlap risk with other token-usage/stats skills keeps it below anchor 5.

4 / 5

Total

15

/

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
JuliusBrussee/caveman
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.