Skip to content
Agentmart
Submit a tool

usage-report

Surface Claude Code's current usage state in a chat-friendly format.

Skill by techfreakworm

IndexedMIT★ 5
Write a review

Install

Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install skill/techfreakworm-usage-report

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Surface Claude Code's current usage state in a chat-friendly format. Use for "how much credit?", "quota?", "am I close to my limit?", "usage report".

Use cases: documents, agent-building

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this skill can do and what it asks for, from its SKILL.md. Checked Oct 25, 2026.

Tools
No tools found
Secrets
None asked for
Install scripts
None found

Network hosts it talks to 1

  • codeload.github.com · found in install command

Files it touches

  • ~/.claude/skills/usage-report

What's inside

Skill name
usage-report
Description
Surface Claude Code's current usage state in a chat-friendly format. Use for "how much credit?", "quota?", "am I close to my limit?", "usage report".
License
MIT
Instructions
25 lines in SKILL.md · view on GitHub

Agent Skills spec issues

  • allowed-tools: must be a space-separated string

Files (1)

  • SKILL.md

SKILL.md (first lines)

# usage-report

1. Run `claude -p '/usage' --output-format json` once. Parse the JSON.

2. If `/opt/claude-soma/usage.sqlite` exists, also fetch the last 7 days of
   daily snapshots for trend context:

   ```bash
   sqlite3 /opt/claude-soma/usage.sqlite \
     "SELECT date, interactive_credits_used, agent_sdk_credits_used
      FROM daily_snapshots ORDER BY date DESC LIMIT 7;"
   ```

3. Format:

   ```
   Today:
     Interactive bucket: X% used (~N turns left at current rate)
     Agent SDK bucket: Y% used
   7-day trend: avg N turns/day interactive, M turns/day Agent SDK
   ```

4. If approaching 75% on either bucket, flag with a warning emoji-free note.

From techfreakworm/claude-soma, MIT.

More from techfreakworm/claude-soma

Signals

Stars
5
Forks
1
Open issues
0
Last commit (this folder)
May 22, 2026 (5 months ago)

From GitHub (fetched Oct 24, 2026).

Details

License
MIT
First seen
Oct 24, 2026
Last checked
Oct 24, 2026

More from techfreakworm

Cite this page

usage-report skill. Agent Mart. https://agentmart.dev/skills/techfreakworm-usage-report (last updated 2026-10-24)