Claude Usage Analyst
Turns local ccusage data into a clear, evidence-backed explanation of your Claude Code token spend and quota burn.
What it does
Reads your local ccusage logs to summarize token volume, estimated cost, model mix, cache-create/cache-read tokens, and 5-hour block consumption for Claude Code (including Claude Desktop's Claude Code sessions). A bundled Python analyzer lets you pick a date range and timezone, and the skill keeps observed numbers strictly separate from interpretation.
Answers follow a fixed shape: short plain-language conclusion, evidence table, model comparison table, 5-hour block table when quota exhaustion is in question, a why-it-happened explanation, then confidence and caveats. Jargon such as "cache read" must be translated in one sentence, so non-technical readers can follow along.
Who it's for
- Heavy Claude Code users who keep hitting limits and want a data-backed reason
- Developers comparing cost efficiency across Opus, Sonnet and other models
- Team leads who need a monthly AI spend report
Examples
- "Why did I burn my quota by noon?" — the 5-hour block table plus cache-read share pinpoints the culprit session.
- "Compare cost per model since the 1st of this month" — pass
--sincefor a multi-day rollup and get a model comparison table. - "Is fable or opus more expensive?" — run
--model-a fable --model-b opus-4-8to contrast token volume against estimated cost.
· · · Install guide · · ·
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the daymade-claude-code/claude-usage-analyst folder from the GitHub repo daymade/claude-code-skills into my ~/.claude/skills/claude-usage-analyst/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/daymade/claude-code-skills.git && mkdir -p ~/.claude/skills && cp -r claude-code-skills/daymade-claude-code/claude-usage-analyst ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Confirm Node.js and Python 3 are installed:
node -vandpython3 --version. - Install the data source:
npm install -g ccusage@latest(or usenpx ccusage@latestad hoc). - Clone the repo:
git clone https://github.com/daymade/claude-code-skills.git - Copy the skill folder:
mkdir -p ~/.claude/skills && cp -r claude-code-skills/daymade-claude-code/claude-usage-analyst ~/.claude/skills/ - Restart Claude Code and verify
claude-usage-analystappears in your skill list. - Try a prompt like "Analyze my Claude token usage today" — add your timezone (e.g.
--timezone America/New_York) if the default doesn't match.