Individual skill
subscription-quota-check
Read remaining Claude Code and Codex subscription quota without spending it. Use when the user asks or after a vendor rejects work for quota; a caller such as rotate-agent may also arm a scheduled read on purpose. Never poll on your own; after a `wait` verdict, pass the reset wait to `sno heartbeat` and re-read once when it ends.
skills/S-communication-and-handoff/subscription-quota-check/skill/SKILL.md
Source commit 1ca8a66158bc9ca26c288c6d5e7ebcf2ffb8491a
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- No
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Not checked yet
- Last checked
- Nov 10, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 864
- Repository last updated
- Nov 4, 2026
- License
- Apache-2.0
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- agent-skills Repository topic
- claude-code Repository topic
- claude-code-skills Repository topic
- code-review Repository topic
- codex Repository topic
- codex-skills Repository topic
- rate-limit Repository topic
- agentic-coding Repository topic
- codex-cli Repository topic
- openai-codex Repository topic
- engineering Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 8,377 bytesSKILL.mdcore · 8,377 bytesreferences/heartbeat-contract.jsonasset · 363 bytesreferences/subscription-quota-check-contract.jsonasset · 342 bytesscripts/selftest/run-selftest.shruns · 204 bytesscripts/selftest/text-check.pyruns · 6,400 bytes
Read excerpt
# subscription-quota-check
## The one rule
**Read it on demand: when the human asks, or when something was actually blocked.**
This skill is not a monitor and never schedules a read of its own, apart from the single re-confirmation read after a `wait` verdict (see "When it says wait"). The Claude usage endpoint
is itself rate limited, so a probe on a timer eventually earns a 429 and starts serving
cached numbers — a checker that reports confidently while reading nothing. A caller such as
rotate-agent may arm a scheduled read deliberately; that is the caller's decision, and the
rate-limit risk is then the caller's to manage. Outside such an armed schedule, every run
must trace to one of the two moments above.
The anti-pattern it replaces has a name: **finding out you are out of quota by making a real