runway-dev-characters — скилл для Claude Code
Скилл runway-dev-characters для разработки интеграций с аватарами Runway. Помогает управлять аватарами, настраивать сессии в реальном времени и работать с документами знаний через SDK и MCP.
MIT 162 установок ★ 76 обновлён 2026-10-20
npx skills add runwayml/skills --skill runway-dev-characters -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/runway-dev-characters/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/runway-dev-characters/
1Через Skills CLI (Vercel)
npx skills add runwayml/skills --skill runway-dev-characters -a codex2Вручную: положить файлы
.agents/skills/runway-dev-characters/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add runwayml/skills --skill runway-dev-characters -a cursor2Вручную: положить файлы
.cursor/skills/runway-dev-characters/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install runwayml/skills skills/runway-dev-characters2Вручную: положить файлы
.github/skills/runway-dev-characters/SKILL.md1Через Skills CLI (Vercel)
npx skills add runwayml/skills --skill runway-dev-characters -a gemini-cli2Командой платформы
gemini skills install https://github.com/runwayml/skills --path skills/runway-dev-charactersВручную: положить файлы
.devin/skills/runway-dev-characters/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add runwayml/skills --skill runway-dev-characters -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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