Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add runwayml/skills --skill runway-dev-model-routers -a claude-code
Open on GitHub

What 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 configId and 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-code

2Manually: put the files in place

~/.claude/skills/runway-dev-model-routers/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/runway-dev-model-routers/

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

Similar skills

All skills for AI and ML →

From the same set7

Project sponsors

Companies that keep this analytics open