Agent skill · research science · jeremylongshore
openrouter-model-catalog
Query, filter, and select from OpenRouter''s 400+ model catalog. Use
Why this skill is useful
Provides specific commands and Python scripts for querying and filtering the OpenRouter model catalog that the AI wouldn't reliably generate on its own.
What it needs
Requires curl, jq, python3 installed locally. Requires openrouter account access. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
OpenRouter Model Catalog Overview Query the GET /api/v1/models endpoint to browse 400+ models, filter by capabilities, compare pricing, and check provider endpoints. No API key required for the models endpoint. Prerequisites curl and jq for the command-line catalog queries — GET /api/v1/models itself requires no auth An OpenRouter API key exported as OPENROUTERAPIKEY only for the Special Routers completion example — see the openrouter-install-auth skill for setup Python 3.8+ with requests for filtering, plus the OpenAI SDK for the openrouter/auto example (pip install requests openai) Instructions 1. List the catalog per List All Models: curl -s https://openrouter.ai/api/v1/models jq '.data length'; add ?supportedparameters=tools to filter to tool-calling models. 2. Read Model Object Shape to interpret each entry — pricing.prompt/pricing.completion are per token (multiply by 1M for readable rates), plus contextlength, topprovider.maxcompletiontokens, and architecture.modality. 3. Filter programmatically per Python: Query and Filter — free models, tool-calling models, cheapest paid models sorted by prompt price, and 128K+ context models. 4. Compare per-provider pricing and quantization for a single model via GET /api/v1/models/{id}/endpoints per List Providers for a Model. 5. Pick behavior with a suffix per Model Variants (:free, :nitro, :floor, :extended, :thinking), or delegate selection entirely to openrouter/auto per Special Routers. 6. Sanity-check choices against the Popular Model Quick Reference, but always verify live pricing via /api/v1/models — prices change frequently. List All Models Model Object Shape Key fields: pricing.prompt / pricing.completion -- cost per token (not per million; multiply by 1M for readable rates) contextlength -- max input tokens topprovider.maxcompletiontokens -- max output tokens architecture.modality -- text->text, text+image->text, etc. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/openrouter-model-catalog--174453