Claude Usage Guard — Development skill for Claude Code
Pause Claude before its next tool call when your 5-hour or weekly plan usage runs hot with lots of window left, and resume when you reply.
How to install Claude Usage Guard
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open Clumsynite/claude-usage-guard and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Claude Usage Guard does
Pause Claude before its next tool call when your 5-hour or weekly plan usage runs hot with lots of window left, and resume when you reply. Hooks only, zero tokens until it fires; needs a short status line snippet to see usage.
Alternatives in Development
- Bro Skill — 🤙 /bro — re-explains the last answer in plain language, for when the reply made you go 'bro what' 296 ★
- Link Outreach — Link Outreach: review the listicle authors who replied to your backlink outreach, and reply to them in-thread 195 ★
- Claude Warmup — Manipulate Claude Code's 5-hour usage window into resetting when you actually need it 127 ★
README
usage-guard
[](https://github.com/Clumsynite/claude-usage-guard/actions/workflows/ci.yml) [](https://github.com/Clumsynite/claude-usage-guard/actions/workflows/release.yml) [](https://github.com/Clumsynite/claude-usage-guard/releases/latest) [](LICENSE)
A Claude Code plugin that pauses Claude before its next tool call when your plan usage is running hot: by default, when the 5-hour window is **80% used with at least an hour still to go**, or the weekly window is **90% used with at least a day to go**. You see why it stopped, and Claude continues when you reply.
Why
Claude can't see your plan usage. Only the status line gets it, so a long autonomous run can burn through a 5-hour window in the first hour and leave you locked out for the next four. usage-guard reads the numbers your status line already receives and stops Claude once per window, while you still have room to decide: carry on, switch to something cheaper, or stop for now.
It fires when you're burning **fast**, meaning high usage with plenty of window left. Near the end of a window it stays quiet, because hitting the cap then costs you little.
Token cost
Zero on the normal path. usage-guard is hooks only: no skills, no MCP server, nothing added to Claude's context. When usage is below the thresholds, the hook exits silently. When it fires, the pause message (about 60 tokens) is shown once and stays in the conversation.
Install
From GitHub:
/plugin marketplace add Clumsynite/claude-usage-guard
/plugin install usage-guard@clumsyknight-usage-guardFrom a local clone:
claude plugin marketplace add /path/to/claude-usagRelated Skills
Clear On
Turn on Clear Answer mode. Every following reply is written in short, plain English and gated by the linter un
Kairos
Show what is left of the five-hour usage window, and manage the gate
Cancel Weekly Reports
Cancel or Pause a Scheduled Weekly Report
Pantheon Andon Cord
Invoke the Andon Cord Protocol — pause all work, identify root cause, do not resume until blocker is resolved
Accounts
Cross-account Claude Max status — per-account 5-hour / weekly / weekly-Fable limits + resets, auth state, live
Tokease
macOS menu bar app showing your remaining Claude 5-hour and weekly usage limits. No token read, 100% local.
Related Agents
Interview Conductor
Conducts adaptive voice elicitation interviews. Presents questions conversationally across 12 thematic modules
Distill Critic
Adversarial checker for the distill skill. Given a reply's substance, its distilled version, and the proposed
Comms Meetings
Email triage, meeting preparation, daily and weekly briefings, communication drafting, and follow-up tracking.
