How do I install the Openrouter Usage skill?

Run npx skillmds@latest add modbender/openrouter-usage in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Openrouter Usage safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Openrouter Usage?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Openrouter Usage free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under Apache-2.

Who published Openrouter Usage?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Openrouter Usage by modbender — Agent Skill

Name: Openrouter Usage
Rating: 4.5 (4 reviews)
Author: modbender

File contents

OpenRouter Usage Monitor

What this skill does

Retrieves OpenRouter usage and cost data via:

Live totals (Today / Week / Month) from /auth/key
Historical per-model breakdown from /activity (completed UTC days only)

How to run (recommended)

Set environment variables (recommended) or create a credentials.env file:

export OPENROUTER_API_KEY=your_key_here
export OPENROUTER_MGMT_KEY=your_mgmt_key_here  # optional, enables model breakdown

Then execute: python3 scripts/stats.py

Alternatively, create credentials.env in the skill directory:

OPENROUTER_API_KEY=your_key_here
OPENROUTER_MGMT_KEY=your_mgmt_key_here

Fallback method (no Python)

If Python is unavailable, query endpoints directly:

Live totals curl -sS -H "Authorization: Bearer $OPENROUTER_API_KEY" https://openrouter.ai/api/v1/auth/key

Per-model activity (7d) curl -sS -H "Authorization: Bearer $OPENROUTER_MGMT_KEY" https://openrouter.ai/api/v1/activity

Configuration

Required:

OPENROUTER_API_KEY - Required for real-time usage totals and balance

Optional:

OPENROUTER_MGMT_KEY - Enables per-model spend breakdown from activity endpoint

Credentials can be provided via:

Environment variables (recommended for security)
credentials.env file in skill directory (fallback)

Output format

💰 OpenRouter Usage Today: $X.XX* | Week: $X.XX | Month: $X.XX Balance: $X.XX / $X.XX

Recent Models (7d): • model-name: $X.XX (N) ... `*` indicates live totals that may not yet appear in model breakdowns.

Edge cases

/activity only returns completed UTC days.
Today’s spend may appear in totals but not per-model data until next UTC rollover.
Invalid keys → 401/403.
Rate limiting → 429.
Network failures should be retried or surfaced.

---name: openrouter-usagedescription: Fetch real-time OpenRouter usage totals and historical per-model spend. Use when the user asks for usage, spend, cost breakdown, or OpenRouter stats. Not for system health or non-LLM metrics.license: Apache-2.0--- # OpenRouter Usage Monitor ## What this skill does Retrieves OpenRouter usage and cost data via: - **Live totals (Today / Week / Month)** from `/auth/key` - **Historical per-model breakdown** from `/activity` (completed UTC days only) --- ## How to run (recommended) Set environment variables (recommended) or create a `credentials.env` file: ```bash export OPENROUTER_API_KEY=your_key_here export OPENROUTER_MGMT_KEY=your_mgmt_key_here # optional, enables model breakdown ``` Then execute: `python3 scripts/stats.py` Alternatively, create `credentials.env` in the skill directory: ``` OPENROUTER_API_KEY=your_key_here OPENROUTER_MGMT_KEY=your_mgmt_key_here ``` --- ## Fallback method (no Python) If Python is unavailable, query endpoints directly: **Live totals** curl -sS -H "Authorization: Bearer $OPENROUTER_API_KEY" https://openrouter.ai/api/v1/auth/key **Per-model activity (7d)** curl -sS -H "Authorization: Bearer $OPENROUTER_MGMT_KEY" https://openrouter.ai/api/v1/activity --- ## Configuration **Required:** - `OPENROUTER_API_KEY` - Required for real-time usage totals and balance **Optional:** - `OPENROUTER_MGMT_KEY` - Enables per-model spend breakdown from activity endpoint Credentials can be provided via: 1. Environment variables (recommended for security) 2. `credentials.env` file in skill directory (fallback) --- ## Output format 💰 OpenRouter Usage Today: $X.XX* | Week: $X.XX | Month: $X.XX Balance: $X.XX / $X.XX Recent Models (7d): • model-name: $X.XX (N) ... `*` indicates live totals that may not yet appear in model breakdowns. --- ## Edge cases - `/activity` only returns completed UTC days. - Today’s spend may appear in totals but not per-model data until next UTC rollover. - Invalid keys → 401/403. - Rate limiting → 429. - Network failures should be retried or surfaced.

Frequently asked questions

Openrouter Usage