Agent skill

Agent Quota Check

“Show how much of the Claude Code and Codex 5-hour and weekly quota is used and when each window resets.”

— description from SKILL.md by aqua5230

AGPL-3.0Auto-check passedProductivity & Automation

Install Agent Quota Check

skills CLI

$ npx skills add aqua5230/usage --skill quota -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install aqua5230/usage quota --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/aqua5230/usage.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugin/skills/quota .claude/skills/quota && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "quota" agent skill from https://github.com/aqua5230/usage/tree/main/plugin/skills/quota into .claude/skills/quota/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "quota", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/aqua5230/usage/tree/main/plugin/skills/quota

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add aqua5230/usage --skill quota -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install aqua5230/usage quota --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/aqua5230/usage.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugin/skills/quota .agents/skills/quota && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "quota" agent skill from https://github.com/aqua5230/usage/tree/main/plugin/skills/quota into .agents/skills/quota/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "quota", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add aqua5230/usage --skill quota -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install aqua5230/usage quota --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/aqua5230/usage.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugin/skills/quota .cursor/skills/quota && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "quota" agent skill from https://github.com/aqua5230/usage/tree/main/plugin/skills/quota into .cursor/skills/quota/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "quota", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/aqua5230/usage.git --path plugin/skills/quota

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add aqua5230/usage --skill quota -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install aqua5230/usage quota --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/aqua5230/usage.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugin/skills/quota .gemini/skills/quota && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "quota" agent skill from https://github.com/aqua5230/usage/tree/main/plugin/skills/quota into .gemini/skills/quota/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "quota", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install aqua5230/usage quota

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add aqua5230/usage --skill quota -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/aqua5230/usage.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugin/skills/quota .github/skills/quota && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "quota" agent skill from https://github.com/aqua5230/usage/tree/main/plugin/skills/quota into .github/skills/quota/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "quota", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add aqua5230/usage --skill quota -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install aqua5230/usage quota --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/aqua5230/usage.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugin/skills/quota .opencode/skills/quota && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "quota" agent skill from https://github.com/aqua5230/usage/tree/main/plugin/skills/quota into .opencode/skills/quota/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "quota", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: quota
GitHub stars: 338
Token cost: ~297 tokens
SKILL.md length: 142 words
Files: 1
Skills in repo: 1
Repo updated: Oct 10, 2026
First seen: Oct 7, 2026
Licence: AGPL-3.0

At a glance

Calls uv and brew

About this skill

Agent Quota Check is a skill in aqua5230/usage (338 stars). Its SKILL.md is about 297 tokens. Licence: AGPL-3.0.

Requirements

Pre-approved tools (allowed-tools): Bash(${CLAUDE_PLUGIN_ROOT}/scripts/quota.sh)

What it can do on your machine

Read from SKILL.md and the folder at commit e8340ad. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
- Bash(${CLAUDE_PLUGIN_ROOT}/scripts/quota.sh)
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- uv
- brew
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Agent Quota Check loads about 297 tokens when it runs. Until then it costs about 27 tokens; SKILL.md has 142 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~27
When it runs · the whole SKILL.md, loaded when a task matches: ~297

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from aqua5230/usage at commit e8340ad, republished under its AGPL-3.0 licence (© aqua5230). 142 words, ~297 tokens.

Download SKILL.mdSave it as .claude/skills/quota/SKILL.md (or your agent's skills folder).

name: quota
description: Show how much of the Claude Code and Codex 5-hour and weekly quota is used and when each window resets.
allowed-tools: Bash(${CLAUDE_PLUGIN_ROOT}/scripts/quota.sh)
disable-model-invocation: true

Quota snapshot from usage-cli status --json:

!${CLAUDE_PLUGIN_ROOT}/scripts/quota.sh

Report this snapshot to the user in their language, one short line per agent:

Name the agent (claude-code → Claude Code, codex → Codex) and its model.
Give five_hour.used_percent and seven_day.used_percent. A null percent means unknown; say so instead of guessing.
Turn each window's resets_in_seconds into "resets in Xh Ym" (or "Xd Yh" past a day). If it is null or absent, say the reset time is unknown.
If age_seconds is over 3600, say the numbers may be stale. For Claude Code, the built-in /usage command is the live source.
If an agent has "available": false, say it has no local data.

If the snapshot says usage-cli is not found, tell the user to run uv tool install usage-cli, or install the menu bar app with brew install --cask aqua5230/usage/usage (https://github.com/aqua5230/usage).

Do not run any other command.

Files

Just SKILL.md in plugin/skills/quota of aqua5230/usage.

Open the folder on GitHubat commit e8340ad

Compare with similar skills

Agent Quota Check next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Agent Quota Check compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Agent Quota Check this skillaqua5230/usage	338	—	~297	Automated safety check: Pass	AGPL-3.0	yesterday
Agent Browser CLIvercel-labs/agent-browser	44k	24 repos	~864	Automated safety check: Pass	Apache-2.0	today
Dev Browser AutomationMemTensor/MemOS	12k	3 repos	~1.7k	Automated safety check: Pass	Apache-2.0	2 days ago
Dependency Watchtelegramdesktop/tdesktop	33k	1 repos	~2.2k	Automated safety check: Pass	GPL-3.0	yesterday
Electron App Automationvercel-labs/agent-browser	44k	5 repos	~1.7k	Automated safety check: Pass	Apache-2.0	today
Next Dev Loopvercel/next.js	143k	9 repos	~2.3k	Automated safety check: Pass	MIT	today

Similar skills

Agent Browser CLI
vercel-labs/agent-browser
Official
Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking…
44k GitHub starsUsed in 24 repos~864 tokens
Productivity & AutomationAuto-check passed
Dev Browser Automation
MemTensor/MemOS
Automates a real browser through short TypeScript scripts that keep page state between runs, for navigating, filling forms, taking screenshots and extracting data.
12k GitHub starsUsed in 3 repos~1.7k tokens
Productivity & AutomationAuto-check passed
Dependency Watch
telegramdesktop/tdesktop
Audit Telegram Desktop dependencies on freshly fetched origin/dev for releases and security fixes, including upstream lag and backport candidates in patched forks.
33k GitHub starsUsed in 1 repo~2.2k tokens
Productivity & AutomationAuto-check passed
Electron App Automation
vercel-labs/agent-browser
Official
Automates Electron desktop apps such as VS Code, Slack or Discord by connecting agent-browser to their Chrome DevTools Protocol port.
44k GitHub starsUsed in 5 repos~1.7k tokens
Productivity & AutomationAuto-check passed
Next Dev Loop
vercel/next.js
Official
Verify Next.js runtime behavior after editing app code. An agent skill from vercel/next.js.
143k GitHub starsUsed in 9 repos~2.3k tokens
Productivity & AutomationAuto-check passed
Skyvern Browser Automation
Skyvern-AI/skyvern
Picks the right Skyvern CLI command for a web task, from quick yes/no checks to reusable multi-page workflows, instead of falling back to plain page fetching.
23k GitHub starsUsed in 1 repo~2.9k tokens
Productivity & AutomationAuto-check passed

Questions about Agent Quota Check

How do I install Agent Quota Check in Claude Code?

Run `npx skills add aqua5230/usage --skill quota -a claude-code`. Or copy the skill folder (plugin/skills/quota in aqua5230/usage) into .claude/skills/quota in your project. Claude Code loads it when a task matches its description.

How do I install Agent Quota Check in Codex?

Run `npx skills add aqua5230/usage --skill quota -a codex`. Or copy the skill folder (plugin/skills/quota in aqua5230/usage) into .agents/skills/quota in your project. Codex loads it when a task matches its description.

Can I use Agent Quota Check in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aqua5230/usage --skill quota -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/quota, .gemini/skills/quota, .github/skills/quota and .opencode/skills/quota in your project.

What does Agent Quota Check need to run?

Going by SKILL.md and its folder, Agent Quota Check needs the command-line tools its instructions call (uv and brew). Its frontmatter pre-approves these tools: Bash(${CLAUDE_PLUGIN_ROOT}/scripts/quota.sh).

Does Agent Quota Check access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Agent Quota Check safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Agent Quota Check use?

Agent Quota Check is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Agent Quota Check use?

About 297 tokens (SKILL.md is roughly 1.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Agent Quota Check?

Skills that share tags, products or a category with Agent Quota Check: Agent Browser CLI (vercel-labs/agent-browser, 44k stars), Dev Browser Automation (MemTensor/MemOS, 12k stars), Dependency Watch (telegramdesktop/tdesktop, 33k stars) and Electron App Automation (vercel-labs/agent-browser, 44k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agent Quota Check?

aqua5230 (a GitHub user) maintains it in aqua5230/usage, which has 338 GitHub stars. The repository was last updated on October 10, 2026.

Source: aqua5230/usage on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Agent Quota Check

Facts

At a glance

About this skill

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Files

Compare with similar skills

Similar skills

Agent Browser CLI

Dev Browser Automation

Dependency Watch

Electron App Automation

Next Dev Loop

Skyvern Browser Automation

Related

Questions about Agent Quota Check