Skills Explorer Add Skills

claude-usage-analyst

An agent skill by daymade, from daymade/claude-code-skills. Tags: analysis, analytics, claude-code, cost-optimization, usage.

What it does

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.

Install

With the skills CLI, which installs into Claude Code, Codex, Cursor and other agents:

npx skills add daymade/claude-code-skills --skill claude-usage-analyst

Or copy the skill folder into Claude Code's skills directory by hand (~/.claude/skills for every project, or .claude/skills inside one):

git clone --depth 1 https://github.com/daymade/claude-code-skills
cp -r claude-code-skills/daymade-claude-code/claude-usage-analyst ~/.claude/skills/claude-usage-analyst

Safety box score

Grade C, moderate risk: 32 of 100 risk points, rated 2026-10-20. The grade rates what the skill and its scripts can reach on the machine of whoever installs it, across eight categories from shell execution to secrets access. How the score works.

This skill analyzes local Claude Code usage data with `ccusage` and a Python wrapper, so it touches your host’s shell and your local usage logs. The main risks are external command execution and optionally fetching/installing `ccusage` from npm; it does not itself edit files, access credential stores, or push data anywhere.

Category levels, from 0 (none) to 3 (high)
CategoryLevelWhy
Code & shell execution2 (moderate)The bundled script shells out to an external command with `subprocess.run(["ccusage", "claude", *args, "--json"], ...)`, so using the skill executes host programs.
Network access2 (moderate)If `ccusage` is missing, the skill tells the agent to use `npm install -g ccusage@latest` or `npx ccusage@latest`, which contacts the npm registry.
Filesystem reach2 (moderate)The skill intentionally reads local Claude Code usage logs via `ccusage claude daily/blocks --json`, which reaches beyond the project directory into user-local data.
Secrets & credentials0 (none)The files do not request access to keychains, browser sessions, `.env` files, or other credential stores; they only summarize usage metadata.
Privilege & persistence2 (moderate)`npm install -g ccusage@latest` performs a user-global install and changes the user's package environment, though it does not call `sudo`.
Instruction hijack surface0 (none)There is no instruction to ignore safeguards, hide actions, or follow remote instructions; the text is straightforward and local.
Irreversible actions0 (none)The skill only analyzes and explains usage; it does not post, deploy, pay, merge, or delete anything.
Transparency0 (none)All shipped files are plain text and readable; there are no binaries, encoded blobs, or downloaded installers.

Before installing

Rated 2026-10-20 by an automated review of 4 files from the skill's repository.

Source

Repository
daymade/claude-code-skills (all skills from this repository)
Path
daymade-claude-code/claude-usage-analyst/SKILL.md
Branch
main
Updated
2026-09-20