CtrlK
BlogDocsLog inGet started
Tessl Logo

claude-usage-analyst

Analyze Claude Code and Claude Desktop Code token usage, cost, quota burn, model mix, cache read/write, and 5-hour block consumption using ccusage evidence. Use when the user asks why Claude quota was exhausted, whether a model such as fable/opus/sonnet is unusually expensive, how many tokens were spent today or historically, or needs a human-friendly explanation of local Claude Code CLI/Desktop usage.

75

Quality

93%

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

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

A tight, well-structured skill body: efficient prose, executable commands, a clear reference split, and genuinely non-obvious evidence rules. The only weaknesses are the placeholder script path, which blocks copy-paste execution, and the absence of failure-handling guidance for the analyzer run.

Suggestions

Resolve the placeholder path: replace "/path/to/claude-usage-analyst/scripts/analyze_claude_usage.py" with the actual skill-relative invocation (e.g., "python3 scripts/analyze_claude_usage.py" run from the skill directory) so commands are copy-paste ready and consistent with step 3.

Add a brief failure-handling step for the analyzer run (e.g., 'If the script reports ccusage not found or a JSON parse error, install/update ccusage and re-run') to close the workflow's validation gap.

Clarify the 5-hour block and rank/median fields in one sentence each or defer them to references/explanation-guide.md so the Output Shape section can stay lean.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: no concept tutorials, just tool commands, scope caveats, and output-shape rules — every line carries non-obvious guidance such as saying "quota-like pressure" when plan accounting is unknown. It matches the 'every token earns its place' anchor rather than the score-4 anchor with trimmable over-explanation.

5 / 5

Actionability

Commands are concrete and mostly executable ("ccusage --version", "npm install -g ccusage@latest", "--model-a fable --model-b opus-4-8"), but step 2 uses a literal "/path/to/claude-usage-analyst/scripts/analyze_claude_usage.py" placeholder while step 3 uses the relative "scripts/analyze_claude_usage.py", so it is not copy-paste ready without resolving the path. That is a minor gap (anchor 4), not missing key details (anchor 3).

4 / 5

Workflow Clarity

The four-step sequence is clear and step 1 includes a tool-availability check with an npx fallback, but there is no error-recovery guidance (e.g., what to do if the analyzer exits with a ccusage parse failure). That places it at 'clear sequence with most checkpoints present; minor validation gaps' rather than the score-5 feedback-loop anchor; no destructive/batch cap applies since the skill only reads usage logs.

4 / 5

Progressive Disclosure

The SKILL.md is a concise overview and both bundle paths are real, purpose-signaled, and exactly one level deep: "Read `references/explanation-guide.md` when writing the final answer" and the bundled analyzer script. Detail (plain-language translations, interpretation patterns, caveats) is appropriately split out rather than inlined, matching the anchor-5 structure.

5 / 5

Total

18

/

20

Passed

Description

100%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 model description: concrete third-person capabilities, an explicit 'Use when' clause with realistic user questions, model-name synonyms, and an unambiguous niche. No fluff or over-claims are present.

DimensionReasoningScore

Specificity

The description lists multiple concrete analysis targets — "token usage, cost, quota burn, model mix, cache read/write, and 5-hour block consumption using ccusage evidence" — in third-person voice with no vague filler. It matches the comprehensive anchor; unlike the score-4 anchor there are no noticeable coverage gaps.

5 / 5

Completeness

It explicitly answers both 'what' (analyze usage, cost, model mix, cache, and 5-hour block consumption with ccusage) and 'when' (an explicit "Use when..." clause enumerating concrete trigger questions). This matches the anchor-5 example structure exactly, not the weaker score-4 'when could be more explicit'.

5 / 5

Trigger Term Quality

It quotes full natural user phrasings ("why Claude quota was exhausted", "whether a model such as fable/opus/sonnet is unusually expensive", "how many tokens were spent today or historically") plus synonyms across CLI/Desktop and model names. Coverage is comprehensive rather than 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

It carves a clear niche — ccusage-evidenced local Claude Code/Desktop usage analysis — with distinct triggers (quota exhaustion, per-model cost, token spend) that are unlikely to fire unrelated skills. It is not 'mostly distinct with minor overlap' (score 4); the domain and tooling are unmistakable.

5 / 5

Total

20

/

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
daymade/claude-code-skills
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.