Claude-skill-registry add-openrouter-model

Fetch OpenRouter model details and provide guidance for adding models to acai-ts provider configuration.

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/add-openrouter-model" ~/.claude/skills/majiayu000-claude-skill-registry-add-openrouter-model && rm -rf "$T"

manifest: skills/data/add-openrouter-model/SKILL.md

Add OpenRouter Model

Fetches model details from OpenRouter API and provides structured information for the agent to add the model to

source/models/openrouter-provider.ts

Usage

Run this script from this file's directory.

./add-model.js google/gemini-3-flash-preview

How It Works

Fetches model data from
```
https://openrouter.ai/api/v1/models
```
Locates the exact model by the provided OpenRouter ID
Extracts and computes key information:
- Context window length (
```
context_length
```
  )
- Max output tokens (
```
top_provider.max_completion_tokens
```
  )
- Pricing (
```
pricing.prompt
```
  ,
```
pricing.completion
```
  )
- Supported features (checks
```
supported_parameters
```
  for reasoning/tool calling)
Outputs JSON with all details needed to add the model

JSON Output Format

The script outputs a JSON object wrapped in markers:

--- MODEL_DETAILS_JSON_START ---
{...}
--- MODEL_DETAILS_JSON_END ---

JSON Structure

{
  "modelKey": "gemini-3-flash-preview",
  "openrouterId": "google/gemini-3-flash-preview",
  "providerFile": "./source/models/openrouter-provider.ts",
  "registryId": "openrouter:gemini-3-flash-preview",
  "registryEntry": {
    "id": "openrouter:gemini-3-flash-preview",
    "provider": "openrouter",
    "contextWindow": 1048576,
    "maxOutputTokens": 65535,
    "defaultTemperature": 0.5,
    "promptFormat": "markdown",
    "supportsReasoning": true,
    "supportsToolCalling": true,
    "costPerInputToken": 0.0000005,
    "costPerOutputToken": 0.000003
  },
  "clientConfig": {
    "key": "gemini-3-flash-preview",
    "openrouterId": "google/gemini-3-flash-preview"
  },
  "modelInfo": {
    "id": "google/gemini-3-flash-preview",
    "name": "Gemini 3.0 Flash Preview",
    "contextLength": 1048576,
    "maxCompletionTokens": 65535,
    "pricing": {...},
    "supportedParameters": [...]
  }
}

How to Add Model to Provider File

Step 1: Add to

openrouterModels

object

source/models/openrouter-provider.ts

, find the

openrouterModels

const object (starts with

const openrouterModels = {

). Add the new model entry in alphabetical order by key:

const openrouterModels = {
  "claude-3-5-sonnet": openRouterClient("anthropic/claude-3.5-sonnet"),
  // ... existing models ...
  "gemini-3-flash-preview": openRouterClient("google/gemini-3-flash-preview"),  // ADD THIS
  "sonnet-4.5": openRouterClient("anthropic/claude-sonnet-4.5"),
  // ...
} as const;

Step 2: Add to

openrouterModelRegistry

object

Find the

openrouterModelRegistry

object and add the registry entry in alphabetical order by
registryId
:

export const openrouterModelRegistry: {
  [K in ModelName]: ModelMetadata<ModelName>;
} = {
  "openrouter:claude-3-5-sonnet": {
    id: "openrouter:claude-3-5-sonnet",
    // ... existing entry ...
  },
  // ... existing entries ...
  "openrouter:gemini-3-flash-preview": {
    id: "openrouter:gemini-3-flash-preview",
    provider: "openrouter",
    contextWindow: 1048576,
    maxOutputTokens: 65535,
    defaultTemperature: 0.5,
    promptFormat: "markdown",
    supportsReasoning: true,
    supportsToolCalling: true,
    costPerInputToken: 0.0000005,
    costPerOutputToken: 0.000003,
  },
  // ...
};

Step 3: Validate changes

Run the project's validation commands:

npm run typecheck
npm run lint
npm run format

Field Mapping Reference

JSON Field	Registry Field	Notes
`registryEntry.id`	`id`	Full registry ID
`registryEntry.provider`	`provider`	Always "openrouter"
`registryEntry.contextWindow`	`contextWindow`	Direct mapping from API
`registryEntry.maxOutputTokens`	`maxOutputTokens`	From `top_provider.max_completion_tokens`
`registryEntry.defaultTemperature`	`defaultTemperature`	Inferred from model ID (-1 for code models)
`registryEntry.promptFormat`	`promptFormat`	Inferred: gemini/claude/qwen/mistral → "markdown", gpt/openai → "xml", deepseek → "bracket"
`registryEntry.supportsReasoning`	`supportsReasoning`	Checks `supported_parameters` for `include_reasoning` or `reasoning`
`registryEntry.supportsToolCalling`	`supportsToolCalling`	Checks `supported_parameters` for `tools`
`registryEntry.costPerInputToken`	`costPerInputToken`	From `pricing.prompt`
`registryEntry.costPerOutputToken`	`costPerOutputToken`	From `pricing.completion`

Default Value Inferences

Field Logic

defaultTemperature

Returns

-1

if model ID contains "codex", "coder", or "code"; otherwise

0.5

promptFormat

Maps model family to format: gemini/claude/qwen/mistral/moonshotai → "markdown", gpt/openai → "xml", deepseek → "bracket", defaults to "markdown"

maxOutputTokens

Falls back to

context_length

max_completion_tokens

is not available

Error Handling

Validates model ID exists in OpenRouter API
Shows first 10 available models if ID not found
Provides clear error messages with suggestions

Examples

# Add Gemini 3 Flash Preview
./add-model.js google/gemini-3-flash-preview

# Add Claude 3.5 Sonnet
./add-model.js anthropic/claude-3-5-sonnet

# Add DeepSeek V3
./add-model.js deepseek/deepseek-v3.2