add-openrouter-model
Fetch OpenRouter model details and provide guidance for adding models to acai-ts provider configuration.
When & Why to Use This Skill
This Claude skill automates the integration of OpenRouter models into the acai-ts provider configuration. It streamlines the development workflow by fetching real-time metadata—including context limits, pricing, and feature support—directly from the OpenRouter API and generating the exact code snippets required for the model registry, eliminating manual research and formatting errors.
Use Cases
- Rapidly onboarding newly released LLMs (e.g., Gemini 3 Flash or DeepSeek V3) into an agentic framework without manual documentation lookup.
- Ensuring accurate cost tracking and prompt management by automatically synchronizing pricing and context window data from OpenRouter.
- Automating the detection of model-specific capabilities like reasoning and tool-calling to correctly configure provider registries.
- Standardizing the prompt format and default parameters for different model families (Anthropic, Google, OpenAI, etc.) within a unified codebase.
| name | add-openrouter-model |
|---|---|
| description | Fetch OpenRouter model details and provide guidance for adding models to acai-ts provider configuration. |
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
# Get details for a specific model
{baseDir}/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_parametersfor reasoning/tool calling)
- Context window length (
- 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
In 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 if 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
{baseDir}/add-model.js google/gemini-3-flash-preview
# Add Claude 3.5 Sonnet
{baseDir}/add-model.js anthropic/claude-3-5-sonnet
# Add DeepSeek V3
{baseDir}/add-model.js deepseek/deepseek-v3.2