openai-usage

Report current OpenAI usage/rate-limit health from Codex ChatGPT limits.

16 stars

Best use case

openai-usage is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Report current OpenAI usage/rate-limit health from Codex ChatGPT limits.

Teams using openai-usage should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/openai-usage/SKILL.md --create-dirs "https://raw.githubusercontent.com/diegosouzapw/awesome-omni-skill/main/skills/ai-agents/openai-usage/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/openai-usage/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How openai-usage Compares

Feature / Agentopenai-usageStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Report current OpenAI usage/rate-limit health from Codex ChatGPT limits.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# 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`

Related Skills

ai-usage-coach

16
from diegosouzapw/awesome-omni-skill

Help users get more value from AI assistants by suggesting better prompting techniques, surfacing underused features, and identifying workflow improvements. Use when users ask things like "how can I use Claude better?", "what features am I missing?", "give me tips for prompting", "what can you do?", "I feel like I'm not getting the most out of this", or when they explicitly ask for help improving their AI usage. Also use when users seem frustrated with results or are clearly using suboptimal patterns.

ffmpeg-usage

16
from diegosouzapw/awesome-omni-skill

ffmpeg recipes and best practices: convert, concatenate, merge, resize, compress, GIF creation, audio extraction, subtitles, optimize for social platforms.

Automate YouTube Top-Ten Video Creation with OpenAI and Safe Image Search

16
from diegosouzapw/awesome-omni-skill

Integrates OpenAI API for content generation, Bing Image Search API for safe image retrieval, and Pexels API for video footage. Handles authentication via Bearer token, enforces safe search, formats ChatGPT responses into a top-ten list, and includes error handling for API failures.

mongodb_usage

16
from diegosouzapw/awesome-omni-skill

This skill should be used when user asks to "query MongoDB", "show database collections", "get collection schema", "list MongoDB databases", "search records in MongoDB", or "check database indexes".

using-openai-platform

16
from diegosouzapw/awesome-omni-skill

OpenAI SDK development with GPT-5 family, Chat Completions, Responses API, embeddings, and tool calling. Use for AI-powered applications, chatbots, agents, and semantic search.

openai-docs

16
from diegosouzapw/awesome-omni-skill

Use when the user asks how to build with OpenAI products or APIs and needs up-to-date official documentation with citations (for example: Codex, Responses API, Chat Completions, Apps SDK, Agents SDK, Realtime, model capabilities or limits); prioritize OpenAI docs MCP tools and restrict any fallback browsing to official OpenAI domains.

openai-docs-skill

16
from diegosouzapw/awesome-omni-skill

Query the OpenAI developer documentation via the OpenAI Docs MCP server using CLI (curl/jq). Use whenever a task involves the OpenAI API (Responses, Chat Completions, Realtime, etc.), OpenAI SDKs, ChatGPT Apps SDK, Codex, MCP integrations, endpoint schemas, parameters, limits, or migrations and you need up-to-date official guidance.

openai-deep-research

16
from diegosouzapw/awesome-omni-skill

OpenAI Deep Research APIを使用して深層リサーチを実行するスキル。ユーザーが特定のテーマについて深層調査、市場分析、技術リサーチ等を要求する場合に使用する。

OpenAI Automation

16
from diegosouzapw/awesome-omni-skill

Automate OpenAI API operations -- generate responses with multimodal and structured output support, create embeddings, generate images, and list models via the Composio MCP integration.

openai-api

16
from diegosouzapw/awesome-omni-skill

OpenAI API integration for building AI-powered applications. Use when working with OpenAI's Chat Completions API, Python SDK (openai), TypeScript SDK (openai), tool use/function calling, vision/image inputs, streaming responses, DALL-E image generation, Whisper audio transcription, text-to-speech, embeddings, Assistants API, fine-tuning, or any OpenAI API integration task. Triggers on mentions of OpenAI, GPT-4, GPT-4o, GPT-5, o1, o3, o4, DALL-E, Whisper, Sora, or OpenAI SDK usage.

chatgpt / 启用开发者模式的 / openai

16
from diegosouzapw/awesome-omni-skill

General SOP for common requests related to chatgpt, 启用开发者模式的, openai.

Build Your OpenAI Agents Skill

16
from diegosouzapw/awesome-omni-skill

Create your OpenAI Agents SDK skill in one prompt, then learn to improve it throughout the chapter