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
npx skills add OpenRouterTeam/skills --skill openrouter-analytics-schema -a claude-codeWhat 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.tsto inspect the analytics schema - Which grouping dimensions support the
request_countmetric?
How to install openrouter-analytics-schema
1Skills CLI (Vercel)
npx skills add OpenRouterTeam/skills --skill openrouter-analytics-schema -a claude-code2Manually: put the files in place
~/.claude/skills/openrouter-analytics-schema/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/openrouter-analytics-schema/
1Skills CLI (Vercel)
npx skills add OpenRouterTeam/skills --skill openrouter-analytics-schema -a codex2Manually: put the files in place
.agents/skills/openrouter-analytics-schema/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add OpenRouterTeam/skills --skill openrouter-analytics-schema -a cursor2Manually: put the files in place
.cursor/skills/openrouter-analytics-schema/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install OpenRouterTeam/skills skills/openrouter-analytics-schema2Manually: put the files in place
.github/skills/openrouter-analytics-schema/SKILL.md1Skills CLI (Vercel)
npx skills add OpenRouterTeam/skills --skill openrouter-analytics-schema -a gemini-cli2Platform CLI
gemini skills install https://github.com/OpenRouterTeam/skills --path skills/openrouter-analytics-schemaManually: put the files in place
.devin/skills/openrouter-analytics-schema/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add OpenRouterTeam/skills --skill openrouter-analytics-schema -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.