Skip to main content
skill CX Codex

openrouter-analytics-schema — Claude Code skill: how to install

Fetches live OpenRouter analytics schema details, including metrics, dimensions, and filter rules. Useful when constructing usage or cost queries.

no license 355 installs ★ 327 updated 2026-10-24

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add OpenRouterTeam/skills --skill openrouter-analytics-schema -a claude-code
Open on GitHub

What openrouter-analytics-schema does

This skill pulls the latest structure of OpenRouter analytics data directly from https://openrouter.ai/api/v1/analytics/meta or runs discover-schema.ts. It reveals queryable items across cost categories, token totals, latency distributions, and cache performance without guessing field names.

Time windows vary by metric type. Standard volume and spend metrics accept ranges up to 367 days on daily buckets, whereas latency figures, token throughput, and hourly breakdowns cap out at 31 days. Requests exceeding the allowed window fail with HTTP 400 rather than partial output.

A regular API key will not work here: access requires a dedicated OpenRouter management key supplied via --api-key <key> or the OPENROUTER_API_KEY environment variable.

What it helps with

  • find available cost, token, and latency metrics
  • check allowed breakdown dimensions for reporting queries
  • verify time span limits before fetching analytics
  • map user questions to the right metric and dimension pairs

Example prompts for the agent

  • Show available OpenRouter analytics metrics and dimensions
  • Run discover-schema.ts to inspect the analytics schema
  • Which grouping dimensions support the request_count metric?

How to install openrouter-analytics-schema

1Skills CLI (Vercel)

npx skills add OpenRouterTeam/skills --skill openrouter-analytics-schema -a claude-code

2Manually: put the files in place

~/.claude/skills/openrouter-analytics-schema/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/openrouter-analytics-schema/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about openrouter-analytics-schema

How to install openrouter-analytics-schema in Claude Code?

Run npx skills add OpenRouterTeam/skills --skill openrouter-analytics-schema -a claude-code.

What credentials does this skill need?

It needs an OpenRouter management key, which is distinct from regular API keys. Provide it using --api-key <key> or by setting the OPENROUTER_API_KEY environment variable.

What are the date range constraints for analytics queries?

Volume and total cost metrics allow up to 367 days for daily aggregation. Performance metrics, hourly rollups, and cache efficiency checks have a strict 31-day limit.

Similar skills

All skills for AI and ML →

From the same set16

The whole set →
openrouter-generations openrouter-generations is a Claude Code skill for inspecting OpenRouter requests by generation ID. It shows token costs, latency, provider routing, and saved prompts. CX Codex +1 383installs openrouter-agent-migration openrouter-agent-migration walks you through switching agent imports from @openrouter/sdk to the @openrouter/agent package. CX Codex +1 383installs openrouter-oauth openrouter-oauth adds Sign In with OpenRouter to browser apps via OAuth PKCE without a backend, SDK, or client credentials. CX Codex +1 362installs create-agent-tui create-agent-tui is a Claude Code skill that generates a TypeScript agent with terminal UI, tools, and sessions for building an agent from scratch or adding a terminal interface. CX Codex +1 358installs openrouter-analytics-query openrouter-analytics-query — a skill for building and running queries against the OpenRouter analytics API. Use it to pull metrics on model usage, group results by dimensions, and filter by time, model, or other parameters. CX Codex +1 355installs openrouter-tts openrouter-tts synthesizes speech audio from text using OpenRouter's speech API. Generates voiceovers, audiobook snippets, and audio files right from your prompt. CX Codex +1 327installs create-headless-agent create-headless-agent scaffolds headless TypeScript agents using Bun and @openrouter/agent. Builds CLI utilities, API servers, queue workers, and data pipelines without a terminal UI. CX Codex +1 320installs openrouter-stt openrouter-stt converts audio recordings into text using OpenRouter's speech-to-text API across models like Whisper and Chirp. CX Codex +1 319installs

Project sponsors

Companies that keep this analytics open