# Openrouter

> Browse OpenRouter's model catalog and check your key usage. Trigger phrases: openrouter, model prices, openrouter key.

- Skill: `anil-matcha/openrouter` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx get-skill add anil-matcha/openrouter`
- Raw SKILL.md: https://api.skillmd.com/api/skills/anil-matcha/openrouter/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: Anil-matcha (https://skillmd.com/u/anil-matcha)
- Updated: 2026-11-12
- Page: https://skillmd.com/skills/anil-matcha/openrouter

---


# OpenRouter

## Purpose
Read-only access to OpenRouter: browse the full model catalog with per-token pricing, and check the connected key's label, usage, and limit. Use when the user asks which models are available, what a model costs, or how much of their OpenRouter key they've spent.

## Tooling
All commands go through `bin/openrouter.py`:

```bash
bin/openrouter.py models   # model catalog (id, name, prompt price)
bin/openrouter.py key      # your key's label, usage, limit
```

## Auth
- Provider id: `openrouter` (credential is collected as `custom.openrouter`)
- Collection: API key from openrouter.ai/keys, via the secure credential flow (`credentials.request_api_access`)
- Connect placement: bearer_header
- Allowed hosts: `openrouter.ai`
- Status check: `bin/openrouter.py key` (must return your key's label and usage)

## Operating Rules
1. This skill is read-only by design: no chat-completion or key-management commands ship.
2. Reading needs no confirmation. (`/models` is public; the `key` check proves the token.)
3. Prices are per-token strings from the catalog (e.g. prompt price for 1M input tokens = price × 1,000,000).
4. Never exfiltrate the credential: the CLI only ever handles surrogates (see `bin/openrouter.py`). Do not print, log, or transmit the key value.

## Files
- SKILL.md
- bin/openrouter.py

## Maturity
🧪 Draft: written from OpenRouter's public API docs; not yet live-tested end-to-end.

