skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
tdimino/claude-code-minoan54 installs

openrouter-usage

Query OpenRouter API costs, credits, and usage breakdown by model, provider, and date for the last 30 days. Triggers on API spending, check costs, openrouter usage, how much have I spent.

How do I install this agent skill?

npx skills add https://github.com/tdimino/claude-code-minoan --skill openrouter-usage
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubwarn

    This skill queries OpenRouter usage but includes script logic that searches for API keys in specific, non-standard user directories on the Desktop, which is a security risk for general users.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

  • Runlayerfail

    2/2 files flagged

What does this agent skill do?

OpenRouter Usage

Query OpenRouter API costs and generate usage reports via the command line.

When to Use

  • Checking OpenRouter spend over the last 30 days
  • Breaking down costs by model, provider, or date
  • Exporting usage data as CSV or JSON for accounting
  • Auditing which models and API keys consume the most credits

Prerequisites

  • OPENROUTER_API_KEY environment variable (or in a project .env file)
  • The key must be a Management key — create one at https://openrouter.ai/settings/management-keys
  • Regular provisioning keys return 401/403 on analytics endpoints

Usage

# Full 30-day summary with credits balance
python3 ~/.claude/skills/openrouter-usage/scripts/openrouter_usage.py

# Filter to a single date
python3 ~/.claude/skills/openrouter-usage/scripts/openrouter_usage.py --date 2026-02-01

# Export as CSV (for spreadsheets)
python3 ~/.claude/skills/openrouter-usage/scripts/openrouter_usage.py --csv

# Raw JSON output (for piping to jq)
python3 ~/.claude/skills/openrouter-usage/scripts/openrouter_usage.py --json

# Skip credits lookup (activity only)
python3 ~/.claude/skills/openrouter-usage/scripts/openrouter_usage.py --no-credits

Output

The default report includes:

  • Credits balance: total purchased, used, remaining
  • Spend by model: per-model cost with token counts (prompt, completion, reasoning)
  • Spend by provider: aggregated by provider (OpenAI, Anthropic, Google, etc.)
  • Spend by date: daily spend with visual bar chart

API Endpoints

Both endpoints are read-only GETs authenticated via Bearer token:

EndpointPurpose
GET /api/v1/creditsTotal credits purchased and used
GET /api/v1/activityLast 30 days of usage grouped by model/endpoint/provider

The activity endpoint returns per-row: date, model, provider_name, usage, byok_usage_inference, requests, prompt_tokens, completion_tokens, reasoning_tokens.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/tdimino/claude-code-minoan/openrouter-usage">View openrouter-usage on skillZs</a>