К основному содержанию
скилл CX Codex

runway-dev-characters — скилл для Claude Code

Скилл runway-dev-characters для разработки интеграций с аватарами Runway. Помогает управлять аватарами, настраивать сессии в реальном времени и работать с документами знаний через SDK и MCP.

MIT 162 установок ★ 76 обновлён 2026-10-20

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add runwayml/skills --skill runway-dev-characters -a claude-code
Открыть на GitHub

Что делает runway-dev-characters

Скилл предназначен для разработчиков, которые встраивают Runway Characters (в SDK они называются Avatars) в своё приложение. Он охватывает весь цикл: от выбора или создания аватара до управления живыми сессиями, настройки знаний и обработки состояний подключения в UI.

Скилл направляет на актуальную документацию Characters integration guide и SDK docs, помогает правильно организовать архитектуру сервера (создание сессий на backend с помощью @runwayml/sdk, хранение API Secret на сервере), выбрать правильный клиентский пакет (@runwayml/avatars-react для React или @runwayml/avatars для веб). Через MCP-инструменты скилл позволяет проверять список доступных аватаров, их состояние, управлять документами знаний и создавать кастомные аватары.

Основное ограничение: скилл не применяется к генерации видео с аватарами из текста или аудио — для этого используй другие инструменты Runway. Если MCP недоступен, можно продолжить разработку кода на основе документации и известных ID, но этап проверки живого состояния аккаунта будет отложен.

Какие задачи решает

  • Выбрать готовый аватар или создать кастомный для приложения
  • Настроить сессию на backend и безопасно передать credentials клиенту
  • Обработать состояния подключения (permission, connecting, active, failed, ended) в UI
  • Управлять документами знаний для аватара через API
  • Проверить состояние аватара после создания и переподключиться при ошибке соединения

Примеры запросов агенту

  • Помоги встроить аватар Runway в React-приложение, используя компоненты из @runwayml/avatars-react
  • Проверь доступных аватаров и их статус через MCP-инструменты
  • Создай документ знаний для аватара и убедись, что сессия готова к подключению

Как установить runway-dev-characters

1Через Skills CLI (Vercel)

npx skills add runwayml/skills --skill runway-dev-characters -a claude-code

2Вручную: положить файлы

~/.claude/skills/runway-dev-characters/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/runway-dev-characters/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о runway-dev-characters

Как установить скилл runway-dev-characters в Claude Code?

Выполни npx skills add runwayml/skills --skill runway-dev-characters -a claude-code, затем открой ~/.claude/skills/runway-dev-characters/SKILL.md.

Что делает скилл runway-dev-characters?

Скилл направляет разработку интеграций с Runway Characters (аватарами): помогает выбрать или создать аватар, настроить сессии в реальном времени, управлять знаниями и обработать состояния подключения.

Чем скилл отличается от прямого использования SDK?

Скилл связывает в одно целое документацию, примеры управления состояниями UI, правила безопасности (хранение API Secret на сервере) и MCP-инструменты для проверки аватаров и знаний в реальном времени. Без скилла пришлось бы искать эти части отдельно.

Исходный текст

SKILL.md · MIT
---
name: runway-dev-characters
description: "Use when building or maintaining a Runway Characters integration, including avatar discovery or management, realtime Sessions, knowledge, and the call interface. Follow current Characters and SDK docs. Do not use for generating avatar videos from text or audio."
user-invocable: true
---

# Runway Characters

The Developer Portal calls these **Characters**; the API and SDK use **Avatars**. A realtime **Session** is one live conversation. Consult `runway-dev` for account setup and shared credential guidance when installed.

## Workflow

1. Inspect the app's call experience and server architecture. Ask whether it should use an existing Character, a documented preset, or a newly created custom Avatar only when that choice is not already clear.
2. When live account state or a user's Character matters, use Dev MCP to inspect the available Avatars and their state. Do not substitute a different Avatar or guess a preset ID. If a custom Avatar is requested, use its reference image and current API/MCP schema.
3. Follow the current [Characters integration guide](https://docs.dev.runwayml.com/characters/integration/) and [SDK documentation](https://docs.dev.runwayml.com/_llms-txt/characters.txt). Check the `@runwayml/avatars-react` README for current React components, hooks, and styles; use `@runwayml/avatars` for a non-React web client.
4. Create Sessions server-side with `@runwayml/sdk`. Keep `RUNWAYML_API_SECRET` on the server. Follow the current Session readiness and credential-consumption flow; expose only the one-time connection fields the browser SDK needs. Never send the API secret to the browser.
5. Handle permission, connecting, active, failed, and ended states in the app UI. End or cancel a Session during teardown according to the current SDK/API guidance. If single-use credentials have already been consumed and connection fails, create a new Session rather than reusing them.
6. Run local checks. A live Session may incur usage; only open one for verification when requested or approved.

## Live data and knowledge

Use the available MCP tools to inspect live Avatars with `list_avatars` and `get_avatar`, and knowledge documents with `list_avatar_knowledge_documents` and `get_avatar_knowledge_document`. `create_avatar`, `update_avatar`, and `delete_avatar` manage Avatars; the corresponding `*_avatar_knowledge_document` tools manage knowledge documents. After creating an Avatar, check it with `get_avatar` until its state is `READY` or `FAILED`. Read the existing record and current tool contract before changing it, and confirm destructive deletes with the user. If MCP is unavailable, continue app code that can be implemented from docs and existing IDs, and pause only the step that requires live account state.

## Current docs

- [Characters overview](https://docs.dev.runwayml.com/characters/)
- [Build an integration](https://docs.dev.runwayml.com/characters/integration/)
- [Session concepts and lifecycle](https://docs.dev.runwayml.com/characters/concepts/)
- [Characters documentation set](https://docs.dev.runwayml.com/_llms-txt/characters.txt)
- [React SDK](https://github.com/runwayml/avatar-sdk-react)

© runwayml · MIT · runwayml/skills

Похожие скиллы

Все скиллы по теме «ИИ и ML» →
venice-characters veniceai Скилл venice-characters для Claude Code ищет публичных персонажей Venice, показывает отзывы и подключает персонажа к чату через API. Используется в каталогах персонажей и приложениях с готовыми ролями. CX Codex +1 ★ 176звёзд репо runway-video calesthio Скилл runway-video для Claude Code помогает проектировать и вызывать API Runway Developer для генерации видео без случайных списаний. CX Codex +1 142установок runway-image calesthio Скилл runway-image для Claude Code создаёт и редактирует изображения через официальный API Runway. Запускается для text-to-image, референсов и правок по описанию. CX Codex +1 132установок scenario-runway scenario-labs Скилл scenario-runway для Claude Code, Codex, Cursor, Copilot, Gemini CLI и OpenCode подключает модели Runway через MCP Scenario: Gen4.5 генерирует клипы из текста или первого кадра, Aleph 2 редактирует существующие ролики. CX Codex +1 839установок roblox-characters gamedev-skills Скилл roblox-characters для Claude Code помогает чинить скрипты персонажей Roblox, их анимации и управление движением. Активируется при сбоях после возрождения, проблемах с репликацией или конфликте спринта с Humanoid. CX Codex +1 9 300установок runway social-media-skills Скилл для промптинга и режиссуры Runway: задаёт движение камеры, держит одного персонажа в разных шотах и правит готовый материал. CX Codex +1 1 200установок

Из того же набора7

runway-dev Подключает Runway Dev к приложениям через актуальные API и официальный SDK. Помогает разрабатывать и отлаживать интеграции. CX Codex +1 948установок runway-dev-models Скилл runway-dev-models для подключения прямых эндпоинтов моделей Runway Dev в приложение. Подходит, когда нужно работать с изображениями, видео, аудио или задачами через официальный SDK. CX Codex +1 844установок runway-dev-recipes Скилл runway-dev-recipes подключает готовые многошаговые воркфлоу Runway Dev API — Recipes — для генерации изображений и видео через SDK. CX Codex +1 217установок runway-dev-model-routers Скилл runway-dev-model-routers для Claude Code подключает генерацию изображений, видео и аудио через сохранённый Runway Model Router. Проверяет маршрутизацию и помогает настроить её в приложении. CX Codex +1 177установок runway-dev-workflows Скилл runway-dev-workflows для Claude Code подключает приложение к опубликованному Workflow в Runway через Dev API. Он включается при настройке такого вызова или поддержке уже существующего. CX Codex +1 124установок runway-api Плагин runway-api интегрирует генерацию видео и картинок через API Runway в Claude Code. Помогает настраивать маршрутизацию моделей и отслеживать ошибки. ★ 76звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой