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.

68

Quality

81%

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

SKILL.md
Quality
Evals
Security

Quality

Content

93%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 an exemplary instruction-only skill: terse, concrete, and honest about limits, with explicit per-host behavior and strong anti-fabrication guardrails. The only notable gap is the missing fallback for when the hook's report is absent in Claude Code.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no explanations of what tokens, hooks, or caches are — and every sentence carries instruction (host-specific behavior, flags, anti-fabrication rules). The repeated "savings unknown" statements are deliberate guardrail emphasis across different hosts and flags, not padding, so anchor 5 fits better than anchor 4.

5 / 5

Actionability

As an instruction-only skill it gives fully concrete guidance: exact paths (src/hooks/caveman-stats.js), exact commands (/stats model, /stats session), exact flags (--all, --since 7d, --share), and unambiguous do/don't rules per host. This meets the top anchor's standard of specific, executable direction covering the common cases.

5 / 5

Workflow Clarity

Host branching is clear and each branch's single action is explicit (Claude Code: print hook report verbatim; Gemini: direct to /stats; others: native report or state unavailability), with no destructive or batch operations requiring validation. It is not 5 because there is no fallback instruction for the case where the hook supplies no additionalContext, leaving a minor gap in the primary path.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no bundle files, and the five short paragraphs are well organized by topic (hook mechanics, host fallbacks, report contents and limits, flags, file-size caveat). Per the simple-skill guideline this earns the top anchor; the mentioned paths (src/hooks/*.js, docs/HONEST-NUMBERS.md) are repo files the skill operates on, not nested skill references.

5 / 5

Total

19

/

20

Passed

Description

70%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 highly distinctive, but its trigger guidance is limited to the literal slash command. Adding an explicit "Use when..." clause with natural phrases (e.g., token usage, cache usage, session cost) would lift completeness and trigger-term coverage.

Suggestions

Add an explicit 'Use when...' clause naming concrete invocation conditions, e.g. "Use when the user asks about token usage, cache-read tokens, or mode attribution for the current session, or invokes /caveman-stats."

Include common user phrasings and synonyms in the description ("token count", "how many tokens", "usage stats") so the skill triggers on natural language, not just the slash command.

Consider mentioning the aggregation flags (--all, --since) or the share capability so the description's coverage matches what the skill actually does.

DimensionReasoningScore

Specificity

"Show recorded output and cache-read token usage and mode attribution" and "locate the host's native usage report" list several concrete, specific actions in third person. It falls short of anchor 5 because body-documented capabilities (--all, --since, --share, statusline mode display) are absent from the description.

4 / 5

Completeness

The "what" is clear (shows recorded output, cache-read tokens, mode attribution; locates native usage reports), but the only "when" guidance is "Trigger: /caveman-stats", a command name with no conditions or natural trigger phrases — a missing "Use when..." clause caps this at 3. Not score 2 because the "what" is specific, not vague.

3 / 5

Trigger Term Quality

Natural terms users would say are present: "token usage", "cache-read", "session", "usage report". A few common variations are missing ("token count", "cost", "spend", "context usage"), matching anchor 4 rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

"Recorded output and cache-read token usage and mode attribution for the current Claude Code session" carves out a clear niche (Caveman-mode session stats) with a distinct slash-command trigger, so conflict with other skills is minimal. It is more distinct than anchor 4's "minor overlap risk" example.

5 / 5

Total

16

/

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.