SkillsAdd

thaitype/skills · Archived

claude-usage

Show token usage and estimated API cost for a Claude Code session. Use when the user asks about session cost, how much a session spent, token breakdown, API usage, or wants to analyze spend over a date range.

First seen Aug 20, 2026

Installation

$ npx skills add thaitype/skills --skill claude-usage
View on skills.sh ↗ GitHub repository ↗

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

sync-git Same source · more installs
thaitype/skills

Sync the current git repo with remote — pull, auto-commit, push, and resolve conflicts. Use whe…

4 installs
claude-session-id Same source · more installs
thaitype/skills

Find the latest Claude Code session ID(s). Use when the user asks for the current or most recen…

3 installs
todo Same source
thaitype/skills

Manage personal tasks and daily plans. Use when the user wants to add, view, update, check off,…

2 installs
claude-tui Same source
thaitype/skills

Send slash commands (like /context, /compact, /cost) to a Claude Code TUI session via tmux and …

2 installs

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

claude-api Similar name
anthropics/skills

|- Reference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool u…

63.4K installs
claude-opus-4-5-migration Similar name
anthropics/claude-code

Migrate prompts and code from Claude Sonnet 4.0, Sonnet 4.5, or Opus 4.1 to Opus 4.5. Use when …

10.7K installs
claude-md-improver Similar name
anthropics/claude-plugins-official

Audit and improve CLAUDE.md files in repositories. Use when user asks to check, audit, update, …

10.6K installs
claude-automation-recommender Similar name
anthropics/claude-plugins-official

Analyze a codebase and recommend Claude Code automations (hooks, subagents, skills, plugins, MC…

7.4K installs
claude-settings-audit Similar name
getsentry/skills

Analyze a repository to generate recommended Claude Code settings.json permissions. Use when se…

3.9K installs
claude-security Similar name
anthropics/claude-plugins-official

The Claude Security menu — pick a job: scan the codebase (the whole repository or a scoped part…

1.1K installs

Also in this package

Other skills from thaitype/skills · top by installs.

npx skills add thaitype/skills
sync-git 4 claude-session-id 3 todo 2 claude-tui 2 claude-session-log 2 claude-context 2 docker-playwright 1 skill-creator 1 sandbox-start 1 sandbox-init 1

Browse all from thaitype/skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 13
Default branch main
Open issues 0
Status Archived

Skill metadata

Parsed from SKILL.md frontmatter.

Declared agents claude-code

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 1,789 B
  • docs SUMMARY.md 228 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 2 installs

SKILL.md

Claude Usage

Aggregates token usage and calculates estimated API cost from a session's .jsonl file.

Commands

# Show total usage for a session (falls back to $AGENT_SESSION_ID if no arg)
python3 .claude/skills/claude-usage/scripts/usage_summary.py <session-id>

# Filter by date range (ISO format, date-only or datetime)
python3 .claude/skills/claude-usage/scripts/usage_summary.py <session-id> --start 2026-03-01
python3 .claude/skills/claude-usage/scripts/usage_summary.py <session-id> --start 2026-03-01T09:00:00 --end 2026-03-16T23:59:59

# Use custom projects directory
python3 .claude/skills/claude-usage/scripts/usage_summary.py <session-id> --dir /path/to/projects

Output

  Session: <id>
  Period:  2026-03-01 09:00  →  2026-03-16 18:42
  Turns:   42

  Tokens
    Input:        1.2m
    Cache write:  45.3k
    Cache read:   890.1k
    Output:       123.4k

  Estimated cost: $1.2345

  By model:                           (shown only if session used multiple models)
    claude-sonnet-4-6               38 turns  $1.10
    claude-opus-4-6                  4 turns  $0.13

How cost is calculated

Each assistant turn's tokens are multiplied by the model's per-token price and summed:

Token type Billed as
input_tokens input price
cache_creation cache write
cache_read cache read
output_tokens output price

Prices are estimates based on public Anthropic pricing. Actual billing may differ.