Installs into .claude/skills of the current project.
Are you the author of Openai Usage?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/diegosouzapw-openai-usage)
---
name: openai-usage
description: Report current OpenAI usage/rate-limit health from Codex ChatGPT limits.
---
# OpenAI Usage Skill
Use this skill when the user asks things like:
- "what is my OpenAI usage at?"
- "show my OpenAI limits"
- "how much OpenAI budget do I have left?"
## Command
- Human-readable output:
- `node skills/openai-usage/check-openai-usage.js`
- JSON output:
- `node skills/openai-usage/check-openai-usage.js --json`
## Data Source
- Codex app-server `account/rateLimits/read` (ChatGPT mode)
- No manual fallback. If Codex rate limits are unavailable, return an actionable error.
## Behavior
- Reports 5-hour and weekly remaining percentages.
- Computes one health stage (`healthy`, `medium`, `low`, `critical`) using separate 5-hour and weekly thresholds.
- Stage rules:
- `critical` if 5-hour <= 10% OR weekly <= 10%
- `low` if 5-hour <= 25% OR weekly <= 20%
- `medium` if 5-hour <= 50% OR weekly <= 30%
- otherwise `healthy`
