From claude-soma
Queries Claude Code's current usage state (credit/ quota/ limits) and shows a 7-day trend from a local SQLite database. Useful when asked about usage or approaching limits.
How this skill is triggered — by the user, by Claude, or both
Slash command
/claude-soma:usage-reportThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
1. Run `claude -p '/usage' --output-format json` once. Parse the JSON.
Run claude -p '/usage' --output-format json once. Parse the JSON.
If /opt/claude-soma/usage.sqlite exists, also fetch the last 7 days of
daily snapshots for trend context:
sqlite3 /opt/claude-soma/usage.sqlite \
"SELECT date, interactive_credits_used, agent_sdk_credits_used
FROM daily_snapshots ORDER BY date DESC LIMIT 7;"
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
If approaching 75% on either bucket, flag with a warning emoji-free note.
npx claudepluginhub techfreakworm/claude-somaCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.