nordeim/openclaw-curated-skills/claude-usage-checker

Claude Code and agent skill by nordeim/openclaw-curated-skills

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Check Claude Code / Claude Max usage limits. Run when user asks about usage, limits, quota, or how much Claude capacity is left.

Install

npx vskill@latest install nordeim/openclaw-curated-skills/claude-usage-checker

SKILL.md

The same SKILL.md was published earlier as nordeim/openclaw-curated-skills/claude-usage-checker.

Claude Usage Checker

Launches the Claude CLI interactively (PTY) and reads the /usage output to report your Claude Code / Claude Max quota.

Prerequisites

  • Claude CLI must be installed (npm i -g @anthropic-ai/claude-code) and logged in
  • If running claude shows "Missing API key", the user must log in manually first: open a terminal, run claude, and complete the browser login flow
  • Requires an interactive PTY — the agent will launch a local process and read its output (quota info only)

Steps

  1. Launch claude with PTY
  2. Wait for the welcome screen (poll until it appears)
  3. Send /usage + Enter
  4. Read the output (poll until usage data appears)
  5. Close with Escape then /exit
  6. Report the results

Commands

bash
# Launch claude with PTY
exec pty=true command="claude"
# Wait and check log
process action=poll sessionId=XXX timeout=5000
# Send /usage
process action=send-keys sessionId=XXX literal="/usage"
process action=send-keys sessionId=XXX keys=["Enter"]
# Read output
process action=poll sessionId=XXX timeout=5000
# Exit
process action=send-keys sessionId=XXX keys=["Escape"]
process action=send-keys sessionId=XXX literal="/exit"
process action=send-keys sessionId=XXX keys=["Enter"]

Notes

  • If you see "Missing API key" → tell the user to log in; browser-based login won't work headlessly
  • Allow a few seconds between polls — Claude CLI starts slowly
  • "Current week" = weekly reset, not daily

Output Format

Report in a table:

UsageResets
Current sessionX% usedtoday at HH:MM (timezone)
Weekly (all models)X% usedHH:MM (timezone)
Weekly (Sonnet only)X% usedHH:MM (timezone)
Extra usageX% used / $X of $Y spentdate (timezone)

Always show reset times. The CLI displays them as "Resets Xpm" — convert to HH:MM format.

Security

  • Security scanPassed, 95 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
2
7-day trend score
10

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/nordeim/openclaw-curated-skills/claude-usage-checker/badge)](https://verified-skill.com/skills/nordeim/openclaw-curated-skills/claude-usage-checker)

Something wrong with this skill or its page? Tell us.