runwayml / skills

★ 55

A skill package that teaches your agent 17 capabilities — every one documented and browsable below, no GitHub required · by runwayml.

Each skill below is one capability this package teaches your agent. Install the whole package, or open a skill to install just that one.

rw-api-reference🔥🔥🔥✓ VerifiedFreeQuick setup

Complete reference for Runway's public API: models, endpoints, costs, limits, and types

1 file — installable on its own

rw-check-compatibility🔥🔥🔥✓ VerifiedFreeQuick setup

Analyze a user's codebase to verify it can use Runway's public API (server-side requirement)

1 file — installable on its own

rw-check-org-details🔥🔥🔥✓ VerifiedPaid serviceNeeds API keys

Query the Runway API for organization details: rate limits, credit balance, usage tier, and daily generation counts

1 file — installable on its own

rw-fetch-api-reference🔥🔥🔥✓ VerifiedFreeQuick setup

Retrieve the latest Runway API reference from docs.dev.runwayml.com and use it as the authoritative source before any integration work

1 file — installable on its own

rw-generate-audio🔥🔥🔥✓ VerifiedAccount requiredNeeds API keys

Generate audio using the Runway API via runnable scripts. Supports TTS, sound effects, voice isolation, dubbing, and voice conversion.

1 file — installable on its own

rw-generate-image🔥🔥🔥✓ VerifiedAccount requiredNeeds API keys

Generate images directly using the Runway API via runnable scripts. Supports text-to-image with optional reference images.

1 file — installable on its own

rw-generate-video🔥🔥🔥✓ VerifiedAccount requiredNeeds API keys

Generate videos directly using the Runway API via runnable scripts. Supports text-to-video, image-to-video, and video-to-video with seedance2, gen4.5, veo3,…

1 file — installable on its own

rw-integrate-audio🔥🔥🔥✓ VerifiedFreeQuick setup

Help users integrate Runway audio APIs (TTS, sound effects, voice isolation, dubbing)

1 file — installable on its own

rw-integrate-character-embed🔥🔥🔥✓ VerifiedFreeQuick setup

Help users embed Runway Character avatar calls in React apps using the @runwayml/avatars-react SDK

1 file — installable on its own

rw-integrate-characters🔥🔥🔥✓ VerifiedFreeQuick setup

Help users create Runway Characters (GWM-1 avatars) and integrate real-time conversational sessions into their apps

1 file — installable on its own

rw-integrate-documents🔥🔥🔥✓ VerifiedFreeQuick setup

Help users add knowledge base documents to Runway Characters for domain-specific conversations

1 file — installable on its own

rw-integrate-image🔥🔥🔥✓ VerifiedFreeQuick setup

Help users integrate Runway image generation APIs (text-to-image with reference images)

1 file — installable on its own

rw-integrate-uploads🔥🔥🔥✓ VerifiedFreeQuick setup

Help users upload local files to Runway for use as inputs to generation models

1 file — installable on its own

rw-integrate-video🔥🔥🔥✓ VerifiedFreeQuick setup

Help users integrate Runway video generation APIs (text-to-video, image-to-video, video-to-video)

1 file — installable on its own

rw-recipe-full-setup🔥🔥🔥✓ VerifiedPaid serviceNeeds API keys

Complete Runway API setup: check compatibility, configure API key, and integrate generation endpoints

1 file — installable on its own

rw-setup-api-key🔥🔥🔥✓ VerifiedPaid serviceNeeds API keys

Guide users through obtaining and configuring a Runway API key

1 file — installable on its own

use-runway-api🔥🔥🔥✓ VerifiedAccount requiredNeeds API keys

Directly use the Runway API from the agent to generate media, manage resources, and inspect account state

4 files — installable on its own

Runway API Skills

Video generation at scale. Generate videos, images, and audio with Runway's API — batch Ad campaigns, product videos, multishot stories, and creative iteration. Supports seedance2, gen4.5, veo3, Nano, Banana Pro, and more.

Works with Claude Code, Cursor, Codex, and other compatible agents.

Two Ways to Use

1. Generate media at scale

Tell your agent what to create and it handles the rest — calls the API, polls for completion, downloads the result. Generate one asset or orchestrate hundreds.

Copy & paste — that's it

Generate a 15-second product video from this image using seedance2

Copy & paste — that's it

Generate a video for each of these 5 product photos, 9:16 ratio for Instagram Reels

Copy & paste — that's it

Create a voiceover for this ad script, then generate a sound effect of applause

2. Integrate into your app

Guide your agent through adding Runway capabilities to a server-side project: verify compatibility, set up credentials, write framework-specific routes, and handle edge cases like file uploads and task polling.

Copy & paste — that's it

Set up Runway video generation in my Next.js app

Installation

Claude Code (community marketplace)

Copy & paste — that's it

claude plugin marketplace add anthropics/claude-plugins-community
claude plugin install runway-api-skills@claude-community

You can also run /plugin in Claude Code, open Discover, search for runway-api-skills, and install from there. After installing or updating plugins, run /reload-plugins if skills do not appear immediately.

Other agents (`npx skills`)

Copy & paste — that's it

npx skills add runwayml/skills

Select all the skills with your keyboard (Space to select, arrow keys to navigate), then press Enter to install.

Prerequisites

A Runway developer account with prepaid credits ($10 minimum)
For generation skills: uv (Python package runner) and RUNWAYML_API_SECRET env var
For integration skills: a server-side project — Node.js 18+ or Python 3.8+ with a backend framework

Available Skills

Generation (run directly)

Generate media assets directly — your agent runs the scripts, polls for completion, and saves the output.

Skill	Description
`rw-generate-video`	Generate videos: text-to-video, image-to-video, video-to-video
`rw-generate-image`	Generate images: text-to-image with optional reference images
`rw-generate-audio`	Generate audio: TTS, sound effects, voice isolation, dubbing, voice conversion

Integration (add to your app)

Add Runway generation to your server-side project with framework-specific code.

Skill	Description
`rw-integrate-video`	Text-to-video, image-to-video, video-to-video, and character performance generation
`rw-integrate-image`	Text-to-image generation with optional reference images via `@Tag` syntax
`rw-integrate-audio`	Text-to-speech, sound effects, voice isolation, dubbing, and speech-to-speech

Getting Started

Skill	Description
`rw-recipe-full-setup`	End-to-end setup: compatibility check → API key → SDK install → integration code → test
`rw-check-compatibility`	Analyze your project to verify it can safely call the Runway API server-side
`rw-setup-api-key`	Guide through account creation, SDK installation, and environment variable configuration
`rw-check-org-details`	Query your organization's rate limits, credit balance, usage tier, and daily generation counts

Characters (Real-Time Avatars)

Skill	Description
`rw-integrate-characters`	Create GWM-1 avatars and set up server-side session management for real-time conversations
`rw-integrate-character-embed`	Embed avatar call UI in React apps using `@runwayml/avatars-react`
`rw-integrate-documents`	Add knowledge base documents to avatars for domain-specific conversations

Utilities

Skill	Description
`use-runway-api`	Call any public API endpoint to manage resources, trigger generations, and inspect state
`rw-integrate-uploads`	Upload local files to get `runway://` URIs for use as generation inputs
`rw-api-reference`	Complete API reference — models, endpoints, costs, rate limits, and error codes
`rw-fetch-api-reference`	Fetch the latest API docs from docs.dev.runwayml.com/api as the source of truth

Supported Models

Video

Model	Use Case	Cost
`seedance2`	Reference image and video, long duration	36 credits/sec
`gen4.5`	High quality, general purpose	12 credits/sec
`gen4_turbo`	Fast, image-driven (image required)	5 credits/sec
`gen4_aleph`	Video-to-video editing	15 credits/sec
`veo3`	Premium quality	40 credits/sec
`veo3.1` / `veo3.1_fast`	High quality / fast Google models	10–40 credits/sec

Image

Model	Cost
`gen4_image`	5–8 credits
`gen4_image_turbo`	2 credits
`gemini_2.5_flash`	5 credits

Audio

Model	Use Case
`eleven_multilingual_v2`	Text-to-speech
`eleven_text_to_sound_v2`	Sound effects
`eleven_voice_isolation`	Isolate voice from audio
`eleven_voice_dubbing`	Dub audio to other languages
`eleven_multilingual_sts_v2`	Voice conversion

Characters

Model	Description
`gwm1_avatars`	Real-time conversational avatars (5-min max session)

Quick Start

Generate media directly

Copy & paste — that's it

Generate a 10-second video of a sunset over the ocean

Copy & paste — that's it

Generate an image of a red door in a white wall

Copy & paste — that's it

Create a voiceover saying "Welcome to our store" and save it as welcome.mp3

Integrate into a project

Copy & paste — that's it

Set up Runway video generation in my Next.js app

Copy & paste — that's it

Add an endpoint to generate videos from text prompts

Supported Frameworks

The integration skills generate framework-specific code for:

Node.js — Express, Fastify, Next.js (App Router & Pages Router), Remix, SvelteKit, Nuxt, Astro
Python — FastAPI, Flask, Django
Serverless — Vercel Functions, AWS Lambda, Cloudflare Workers

API Reference

Base URL: https://api.dev.runwayml.com
Auth header: Authorization: Bearer <RUNWAYML_API_SECRET>
Version header: X-Runway-Version: 2024-11-06
Official docs: docs.dev.runwayml.com
API Reference: docs.dev.runwayml.com/api
Developer portal: dev.runwayml.com

License

Install the whole package (17 skills):

Copy & paste — that's it

npx skills add https://github.com/runwayml/skills

Or install a single skill:

Copy & paste — that's it

npx skills add https://github.com/runwayml/skills --skill <name>

Pick the skill name from the Skills tab — each entry there installs independently.