claude-usage
starsforks
How to install claude-usage?
magiccube/agentara/claude-usage
$npx -y skills add MagicCube/agentara --skill claude-usageCheck current Claude usage limits (session and weekly) with ASCII progress bars. Trigger when the user asks about usage, quota, limits, rate limits, how much Claude they've used, remaining capacity, or phrases like "check usage", "usage status", "how much quota left", "am I close
SKILL.md
| 1 | # Usage — Claude Usage Monitor |
| 2 | |
| 3 | Show the user their current Claude plan usage with ASCII progress bars. |
| 4 | |
| 5 | ## Workflow |
| 6 | |
| 7 | ### 1. Fetch usage data |
| 8 | |
| 9 | ```bash |
| 10 | curl -s http://localhost:1984/api/usage/claude |
| 11 | ``` |
| 12 | |
| 13 | Parse the JSON response. The shape is: |
| 14 | |
| 15 | ```json |
| 16 | { |
| 17 | "usage": { |
| 18 | "five_hour": { "utilization": 9, "resets_at": "2026-03-15T12:00:00Z" }, |
| 19 | "seven_day": { "utilization": 40, "resets_at": "2026-03-20T14:00:00Z" }, |
| 20 | "extra_usage": { "is_enabled": false, ... } |
| 21 | } |
| 22 | } |
| 23 | ``` |
| 24 | |
| 25 | ### 2. Build ASCII progress bar |
| 26 | |
| 27 | For a given utilization percentage, render a 20-char wide bar: |
| 28 | |
| 29 | - Filled char: `█` |
| 30 | - Empty char: `░` |
| 31 | - Formula: filled = round(utilization / 5), empty = 20 - filled |
| 32 | |
| 33 | Example for 40%: `████████░░░░░░░░░░░░ 40%` |
| 34 | |
| 35 | ### 3. Format reset time |
| 36 | |
| 37 | - For `five_hour.resets_at`: show relative time like "Resets in 3 hr 6 min" |
| 38 | - For `seven_day.resets_at`: show absolute time like "Resets Fri 2:00 PM" |
| 39 | |
| 40 | ### 4. Output |
| 41 | |
| 42 | Present the result in this exact format: |
| 43 | |
| 44 | ``` |
| 45 | Claude Usage |
| 46 | |
| 47 | Session (5h rolling) |
| 48 | Resets in X hr Y min |
| 49 | ████░░░░░░░░░░░░░░░░ 20% |
| 50 | |
| 51 | Weekly (7d rolling) |
| 52 | Resets Fri 2:00 PM |
| 53 | ████████░░░░░░░░░░░░ 40% |
| 54 | |
| 55 | Extra usage: OFF |
| 56 | ``` |
| 57 | |
| 58 | If extra usage is enabled, show `Extra usage: ON` instead. |
| 59 | |
| 60 | ### 5. Rules |
| 61 | |
| 62 | - Keep output compact — no extra commentary unless the user asks. |
| 63 | - If utilization >= 80%, add a warning: `⚠ Running low!` |
| 64 | - If utilization >= 95%, add: `🚨 Almost depleted!` |
| 65 | - If the API call fails, tell the user the service is unreachable and suggest checking if the backend is running. |
People who liked this also viewed
6 picksType
- find-skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skSkillsJul 2026
- grill-meA relentless interview to sharpen a plan or design.SkillsJul 2026
- vercel-react-best-practicesVercel's official collection of agent skillsSkillsJul 2026
- improve-codebase-architectureScan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.SkillsJul 2026
- setup-matt-pocock-skillsConfigure this repo for the engineering skills — set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.SkillsJul 2026
- triageMove issues and external PRs through a state machine of triage roles — categorise, verify, grill if needed, and write agent-ready briefs.SkillsJul 2026
