runway-dev-model-routers — Claude Code skill: setup
runway-dev-model-routers is a skill for connecting image, video, or audio generation through a saved Runway Model Router.
MIT 177 installs ★ 76 updated 2026-10-20
npx skills add runwayml/skills --skill runway-dev-model-routers -a claude-codeWhat runway-dev-model-routers does
The skill checks an app’s configId and server-side request path, finds router details through Dev MCP, and helps wire in generate.video, generate.image, or generate.audio. SDK requests use the configured configId, not the router record’s UUID. Keep those identifiers distinct.
Before changing settings, the skill reads the current configuration: an update replaces the whole settings object and clears optional fields left out. It can also check eligible models and inspect how an existing task was routed. HTTP supports a non-billable check with dryRun: true; SDK dry-run support is undocumented. A live billable request requires the user’s approval.
What it helps with
- route image or video generation through a saved configuration
- look up a router using its
configId - change router settings without dropping untouched fields
- inspect which model handled an existing task
Example prompts for the agent
- Route this app’s video generation through its saved Runway Model Router.
- Find the router for
configIdand inspect its current settings. - Check which model handled this task and explain the routing result.
How to install runway-dev-model-routers
1Skills CLI (Vercel)
npx skills add runwayml/skills --skill runway-dev-model-routers -a claude-code2Manually: put the files in place
~/.claude/skills/runway-dev-model-routers/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/runway-dev-model-routers/
1Skills CLI (Vercel)
npx skills add runwayml/skills --skill runway-dev-model-routers -a codex2Manually: put the files in place
.agents/skills/runway-dev-model-routers/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add runwayml/skills --skill runway-dev-model-routers -a cursor2Manually: put the files in place
.cursor/skills/runway-dev-model-routers/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install runwayml/skills skills/runway-dev-model-routers2Manually: put the files in place
.github/skills/runway-dev-model-routers/SKILL.md1Skills CLI (Vercel)
npx skills add runwayml/skills --skill runway-dev-model-routers -a gemini-cli2Platform CLI
gemini skills install https://github.com/runwayml/skills --path skills/runway-dev-model-routersManually: put the files in place
.devin/skills/runway-dev-model-routers/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add runwayml/skills --skill runway-dev-model-routers -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 runway-dev-model-routers
How do I install runway-dev-model-routers in Claude Code?
Run npx skills add runwayml/skills --skill runway-dev-model-routers -a claude-code. The skill file is at ~/.claude/skills/runway-dev-model-routers/SKILL.md.
What does runway-dev-model-routers do?
It helps inspect and manage saved Runway Model Router configurations, then connect image, video, or audio generation through one.
Can I test routing without a billable request?
The HTTP API supports dryRun: true. SDK dry-run support is undocumented, and the skill only makes a live billable call with user approval.
Source text
SKILL.md · MIT
--- name: runway-dev-model-routers description: "Use when an application should send image, video, or audio generation through a saved Runway Model Router configuration, or when the user asks to inspect or manage one. Resolve the live config and follow current router docs. For a fixed direct model endpoint, use runway-dev-models instead." user-invocable: true --- # Runway Dev Model Routers Model Routers let an application refer to a saved routing preference instead of embedding a particular model choice. Consult `runway-dev` for account setup, credential handling, and SDK task guidance when that skill is installed. ## Existing integration 1. Inspect the application's existing `configId` and its server-side request path. 2. When the live configuration or access must be verified, use Dev MCP to locate the router by `configId`, then fetch details using the identifier returned by the tool. A router record UUID and its `configId` are distinct values; pass the configured `configId` in SDK requests. 3. Read the current overview and generation guide at `https://docs.dev.runwayml.com/model-routers/` and `https://docs.dev.runwayml.com/model-routers/generating/`. Router request fields and types differ from direct-model endpoints; use the schema for the modality being called. 4. Integrate the documented SDK method (`generate.video`, `generate.image`, or `generate.audio`) behind the application's server boundary. Chain the SDK task wait helper directly from `create()`. 5. For a non-billable routing check, the current API supports HTTP `dryRun: true`; SDK dry-run support is not documented. Keep the dry-run and eventual live input equivalent, and use current docs for response fields. Do not issue the live call unless the user requested or approved billable verification. ## Creating or changing a router Use live MCP tools to inspect or manage router state. Clarify missing targets or routing preferences; when the user has specified them, carry out the requested creation or update without requiring another confirmation or a JSON preview. Summarize the result in plain English unless the user asks for raw configuration. Updating `settings` replaces the full settings object and clears omitted optional fields. Read the current configuration before updating it and preserve settings the user did not ask to change. Updating only `name` or `description` leaves settings unchanged. Confirm before deleting a router unless the user already explicitly requested deletion of that exact router. Check current eligible models and constraints through Dev MCP when they affect the configuration. Do not hardcode a model catalog, pricing, or model eligibility in this skill. Check project credit balance immediately before an approved billable test. Use the available MCP tools for the requested action: `list_model_routers` and `get_model_router` for inspection; `create_model_router`, `update_model_router`, or `delete_model_router` for changes; `list_models` for current eligible models; `get_credit_balance` before an approved billable test; and `get_task_routing` to inspect an existing task's routing. ## Explain a routed result The response and task detail can expose routing information such as the selected model and estimated or actual cost. Use the live response or documented task inspection tool to describe what happened; do not assume the router chose a model based only on its preference settings. If the user asks why an existing task routed a certain way, inspect its routing details through the available MCP tool. ## Current docs - [Model Routers overview](https://docs.dev.runwayml.com/model-routers/) - [Generating through a Router](https://docs.dev.runwayml.com/model-routers/generating/) - [Configure a Router](https://docs.dev.runwayml.com/model-routers/configuration/) - [Runway Dev agent context](https://docs.dev.runwayml.com/ai-context.md)
© runwayml · MIT · runwayml/skills