New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Claude Usage Analyst

by daymade in daymade/claude-code-skills

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.

MITAuto-check passed

Install Claude Usage Analyst

skills CLI
$ npx skills add daymade/claude-code-skills --skill claude-usage-analyst -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install daymade/claude-code-skills claude-usage-analyst --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/daymade/claude-code-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/daymade-claude-code/claude-usage-analyst .claude/skills/claude-usage-analyst && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
claude-usage-analyst
GitHub stars
1.4k
Token cost
~707 tokens
SKILL.md length
299 words
Files
4 (incl. scripts, references)
Skills in repo
103
Repo updated
First seen
Licence
MIT

At a glance

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.

  • Works in 4 steps: Verify ccusage is available → Run the bundled analyzer for the… → If the user asks about a specific model… → …
  • The user asks why Claude quota was exhausted
  • SKILL.md covers Overview, Workflow, Evidence Rules and Output Shape
  • Runs Python scripts from its folder; calls python3, npm and npx

What it does

Claude Usage Analyst is an agent skill from daymade/claude-code-skills. 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.

Its SKILL.md is about 710 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `agents/openai.yaml`, `references/explanation-guide.md` and `scripts/analyze_claude_usage.py`).

The repository describes itself as: Professional Claude Code skills marketplace featuring production-ready skills for enhanced development workflows. The licence is MIT.

When your agent uses it

  • 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
  • Needs a human-friendly explanation of local Claude Code CLI/Desktop usage

Example prompts

  • “/claude-usage-analyst”

Requirements

  • Python 3
  • Node.js

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Verify ccusage is available
  2. Run the bundled analyzer for the requested window
  3. If the user asks about a specific model comparison, pass aliases
  4. Read references/explanation-guide.md when writing the final answer.

What it can do on your machine

Read from SKILL.md and the folder at commit 91bed2b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • npm
    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm and npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Claude Usage Analyst loads about 707 tokens when it runs, and up to ~1.1k if it reads all its reference files. Until then it costs about 107 tokens; SKILL.md has 299 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~107
When it runs · the whole SKILL.md, loaded when a task matches
~707
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from daymade/claude-code-skills at commit 91bed2b, republished under its MIT licence (© daymade). 299 words, ~707 tokens.

Download SKILL.mdSave it as .claude/skills/claude-usage-analyst/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
claude-usage-analyst
description
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.
disable-model-invocation
true

Claude Usage Analyst

Overview

Use this skill to produce evidence-based usage explanations from local ccusage data. Separate observed numbers from interpretation, and explain quota burn in human terms.

Workflow

  1. Verify ccusage is available:

    bash
    ccusage --version

    If missing, install or update with npm install -g ccusage@latest or run with npx ccusage@latest.

  2. Run the bundled analyzer for the requested window:

    bash
    python3 /path/to/claude-usage-analyst/scripts/analyze_claude_usage.py \
  --since YYYY-MM-DD --until YYYY-MM-DD --timezone Asia/Shanghai

    Default --since/--until is today in the selected timezone. For historical comparison, set --since to an earlier date such as the first day of the month; otherwise rank/median fields only describe the single target day.

  3. If the user asks about a specific model comparison, pass aliases:

    bash
    python3 scripts/analyze_claude_usage.py --model-a fable --model-b opus-4-8

  4. Read references/explanation-guide.md when writing the final answer.

Evidence Rules

  • Base numeric claims on ccusage output or the bundled analyzer output.
  • State the scope: ccusage claude measures local Claude Code usage logs, including Claude Desktop's Claude Code sessions when those local logs exist. It is not a complete ordinary Claude.ai chat bill.
  • Report dates with timezone.
  • Explain cache clearly: cache read tokens are still usage/quota pressure even though the user did not type those words.
  • Do not infer Anthropic plan quota rules from local token counts unless the user provides plan details. Say "quota-like pressure" or "ccusage estimated cost/token burn" when exact plan accounting is unknown.
  • When comparing models, compare both token volume and estimated cost. A model can have similar token volume but higher cost.

Output Shape

Use this structure unless the user asks otherwise:

  1. Short conclusion in plain language.
  2. Evidence table: total tokens, cost, input, output, cache create, cache read.
  3. Model comparison table.
  4. 5-hour block table when quota exhaustion is discussed.
  5. Explanation of why the burn happened.
  6. Confidence and caveats.

Keep the answer readable for non-technical users. Avoid unexplained terms like "cache read" without a one-sentence translation.

© daymade, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts, references) in daymade-claude-code/claude-usage-analyst of daymade/claude-code-skills.

  • SKILL.md
  • agents/openai.yaml
  • references/explanation-guide.md
  • scripts/analyze_claude_usage.py

Open the folder on GitHubat commit 91bed2b

Compare with similar skills

Claude Usage Analyst next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Claude Usage Analyst compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Claude Usage Analyst this skilldaymade/claude-code-skills1.4k—~707Automated safety check: PassMIT
Cost Trackingaffaan-m/ECC275k1 repos~1.3kAutomated safety check: PassMIT
Cost Conversationruvnet/ruflo74k—~407Automated safety check: NotesMIT
Cost Reportruvnet/ruflo74k1 repos~830Automated safety check: NotesMIT
Cost Optimizeruvnet/ruflo74k1 repos~997Automated safety check: NotesMIT
Cost Trackruvnet/ruflo74k—~773Automated safety check: NotesMIT

Similar skills

  • Cost Tracking

    affaan-m/ECC

    Track and report Claude Code token usage, spending, and budgets from the local ECC cost-tracker metrics log.

    275k GitHub starsUsed in 1 repo~1.3k tokens
    AI & LLM EngineeringAuto-check passed

  • Cost Conversation

    ruvnet/ruflo

    Per-conversation cost view — list every session in cost-tracking with started-at, message count, top model, and total cost

    74k GitHub stars~407 tokensUpdated today
    AI & LLM EngineeringAuto-check: notes

  • Cost Report

    ruvnet/ruflo

    Generate a cost report showing token usage and USD costs by agent and model

    74k GitHub starsUsed in 1 repo~830 tokens
    AI & LLM EngineeringAuto-check: notes

  • Cost Optimize

    ruvnet/ruflo

    Analyze token usage patterns and recommend cost optimizations with estimated savings

    74k GitHub starsUsed in 1 repo~997 tokens
    AI & LLM EngineeringAuto-check: notes

  • Cost Track

    ruvnet/ruflo

    Auto-capture per-session token usage from the Claude Code session jsonl and persist to the cost-tracking namespace

    74k GitHub stars~773 tokensUpdated today
    AI & LLM EngineeringAuto-check: notes

  • Cost Export

    ruvnet/ruflo

    Export cost-tracking telemetry in Prometheus textfile or webhook JSON formats — for external observability (Grafana, Datadog, custom dashboards)

    74k GitHub starsUsed in 1 repo~687 tokens
    DevOps & CloudAuto-check: notes

More from daymade/claude-code-skills

All 103 skills in this repo

  • Video Comparer

    daymade/claude-code-skills

    This skill should be used when comparing two videos to analyze compression results or quality differences.

    1.4k GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check: notes

  • CLI Demo Generator

    daymade/claude-code-skills

    Generates professional animated CLI demos as GIFs using VHS terminal recordings.

    1.4k GitHub stars~1.7k tokensUpdated today
    Auto-check passed

  • Doc To Markdown

    daymade/claude-code-skills

    Converts DOCX/PDF/PPTX and saved HTML/HTM to high-quality Markdown with automatic post-processing.

    1.4k GitHub stars~2.5k tokensUpdated today
    Auto-check passed

  • Interaction Design Board

    daymade/claude-code-skills

    Generates several distinct, clickable HTML interaction prototypes for one product surface into a Design Board and collects selection/remix feedback before implementation.

    1.4k GitHub stars~2.7k tokensUpdated today
    Auto-check passed

  • Auto Repo Setup

    daymade/claude-code-skills

    Diagnoses and repairs repository setup and guarded Git workflows for Claude Code or Codex — environment repair, startup sync, hook auditing, collaborator handoff.

    1.4k GitHub stars~2.6k tokensUpdated today
    Auto-check: notes

  • Bigdata Skill

    daymade/claude-code-skills

    Pulls Bigdata.com (RavenPack) financial and news data via the official bigdata-client SDK and /v1/ REST endpoints — structured financials, prices, analyst estimates, entity-sentiment series…

    1.4k GitHub stars~3.7k tokensUpdated today
    Auto-check passed

Questions about Claude Usage Analyst

What does Claude Usage Analyst do?

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. Claude Usage Analyst is an agent skill from daymade/claude-code-skills. 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.

When should I use Claude Usage Analyst?

Claude Usage Analyst fits situations like: 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; needs a human-friendly explanation of local Claude Code CLI/Desktop usage.

How do I install Claude Usage Analyst in Claude Code?

Run `npx skills add daymade/claude-code-skills --skill claude-usage-analyst -a claude-code`. Or copy the skill folder (daymade-claude-code/claude-usage-analyst in daymade/claude-code-skills) into .claude/skills/claude-usage-analyst in your project. Claude Code loads it when a task matches its description.

How do I install Claude Usage Analyst in Codex?

Run `npx skills add daymade/claude-code-skills --skill claude-usage-analyst -a codex`. Or copy the skill folder (daymade-claude-code/claude-usage-analyst in daymade/claude-code-skills) into .agents/skills/claude-usage-analyst in your project. Codex loads it when a task matches its description.

Can I use Claude Usage Analyst in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add daymade/claude-code-skills --skill claude-usage-analyst -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/claude-usage-analyst, .gemini/skills/claude-usage-analyst, .github/skills/claude-usage-analyst and .opencode/skills/claude-usage-analyst in your project.

What does Claude Usage Analyst need to run?

Going by SKILL.md and its folder, Claude Usage Analyst needs Python for the scripts in its folder and the command-line tools its instructions call (python3, npm and npx). Our summary lists: Python 3; Node.js.

Does Claude Usage Analyst access the network?

SKILL.md contains no URLs. Its commands use npm and npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Claude Usage Analyst safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Claude Usage Analyst use?

Claude Usage Analyst is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Claude Usage Analyst use?

About 707 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 410 tokens, read only when the agent opens those files.

What are the alternatives to Claude Usage Analyst?

Skills that share tags, products or a category with Claude Usage Analyst: Cost Tracking (affaan-m/ECC, 275k stars), Cost Conversation (ruvnet/ruflo, 74k stars), Cost Report (ruvnet/ruflo, 74k stars) and Cost Optimize (ruvnet/ruflo, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Claude Usage Analyst?

daymade (a GitHub user) maintains it in daymade/claude-code-skills, which has 1,444 GitHub stars. The repository holds 103 skills in this directory. The repository was last updated on October 8, 2026.

Source: daymade/claude-code-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.