Terminal
Terminal/Skill
Helps build and debug Runway Characters in an app: live avatar sessions run on the server, the call UI, and knowledge documents.
By Runway
Works with
npx skills add runwayml/skills --skill runway-dev-charactersCompanion: Use
+runway-devfor shared guidance when available. If it is not installed, inspect the workspace, probeRUNWAYML_API_SECRETwithout printing it, and read the Characters docs linked byllms.txt. Encourage connecting Dev MCP to inspect or manage characters and knowledge documents. If the user declines or cannot connect, continue integration from current docs and an existing character ID.
Keep a Characters integration and its live Session lifecycle correct across the application's backend and UI. Verify changes end-to-end when safe.
list_avatars, get_avatar).POST /v1/realtime_sessions.influencer ({ type: 'runway-preset', presetId: 'influencer' }).create_avatar according to its live MCP tool schema. If the user wants a default instead, use preset influencer.NOT_READY until READY, consume connection credentials once, and return only the connection fields the client needs.get_avatar for status and attached knowledge document ids.PROCESSING, poll until READY or stop on FAILED.list_avatars / get_avatar — inspect custom avatars in project.create_avatar / update_avatar / delete_avatar — manage custom characters; confirm destructive changes before applying them.list_avatar_knowledge_documents / get_avatar_knowledge_document — inspect attached knowledge.create_avatar_knowledge_document / update_avatar_knowledge_document / delete_avatar_knowledge_document — manage domain knowledge when requested; confirm deletion first.@runwayml/avatars-react with its stylesheet. Keep session creation and credential consumption on the server; browser code receives only one-time connection fields.Use the MCP knowledge-document tools above for live state and CRUD. Inspect attached documents before updating them, keep content focused and structured, and do not delete knowledge without confirmation.