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

scenario-video-to-motion — скилл для Claude Code: что умеет

Скилл scenario-video-to-motion для Claude Code переносит движения людей из видеоролика в 3D-анимацию персонажей через Scenario MCP. Создаёт циклы движения и риги для Unreal, Unity или Blender.

MIT 516 установок ★ 3 964 обновлён 2026-10-23

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

Что делает scenario-video-to-motion

Скилл извлекает движения человека из видеозаписи через модели Scenario с возможностью video23d. В зависимости от выбранной модели он автоматически привязывает скелет к загруженному мешу в форматах FBX, GLB или OBJ либо возвращает чистый трек движения на скелете Mixamo или MetaHuman. Доступны параметры фиксации перемещения на месте moveInPlace, зацикливания loop, захвата лица и настройки осей.

Процесс идёт через вызовы инструментов MCP: загрузка видео и меша через upload_asset, подбор модели через recommend, чтение схемы полей и запуск генерации. Экспорт поддерживает FBX для Unreal, Roblox, Maya или Blender, причём старый импортёр Blender отсекает ASCII FBX и требует новый модуль импорта.

Для работы необходим настроенный Scenario MCP. Запуск моделей расходует баланс аккаунта, поэтому скилл сначала запрашивает расчёт стоимости через model_run с флагом dry_run: true.

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

  • перенести движения человека из видеоролика на 3D-персонажа
  • получить мокап на скелете Mixamo или MetaHuman
  • настроить зацикленную анимацию бега или танца для Unreal Engine
  • подготовить файл анимации с фиксацией персонажа на месте через moveInPlace

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

  • Возьми движения из танца в dance.mp4 и перенеси на персонажа hero.glb в виде цикла для Unreal
  • Сделай мокап бега на месте из run.mp4 на скелете Mixamo с параметром moveInPlace
  • Перенеси захват движений из video.mp4 на модель bot.fbx и подготовь экспорт для Blender

Как установить scenario-video-to-motion

1Через Skills CLI (Vercel)

npx skills add scenario-labs/skills --skill scenario-video-to-motion -a claude-code

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

~/.claude/skills/scenario-video-to-motion/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/scenario-video-to-motion/

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

Вопросы о scenario-video-to-motion

Как установить scenario-video-to-motion в Claude Code?

Выполните команду npx skills add scenario-labs/skills --skill scenario-video-to-motion -a claude-code. Также файл скилла можно сохранить по пути ~/.claude/skills/scenario-video-to-motion/SKILL.md.

Что делает scenario-video-to-motion?

Скилл превращает видеозапись в 3D-анимацию через Scenario MCP, выполняя автоматический риг меша или перенося движения на скелеты Mixamo и MetaHuman.

Что нужно для работы scenario-video-to-motion?

Требуется запущенный сервер Scenario MCP с доступом к инструментам upload_asset, recommend и model_run. Генерация анимаций списывает средства со счёта Scenario.

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

SKILL.md · MIT
---
name: scenario-video-to-motion
description: "Use when turning a reference video into 3D character animation through the Scenario MCP: markerless motion capture from a phone clip or a generated performance, auto-rigging an uploaded FBX, GLB, or OBJ character and applying the captured motion, raw motion on a Mixamo or MetaHuman skeleton to retarget yourself, in-place locomotion, looping clips, facial capture, or FBX exports for Blender, Maya, Unreal, Unity, or Roblox. Keywords: mocap, video to motion, video23d, animation from video."
license: MIT
---

# Scenario Video to Motion

## Overview

Video-to-motion members watch the people in a clip and return 3D animation: either your character
mesh, auto-rigged and moving, or the motion alone on a standard skeleton. They are the `video23d`
capability, and they differ more than their shared name suggests: which character input they take,
which skeleton comes back, and which file formats they write.

Siblings: `scenario` (connection, scope, upload, `jobs_wait`), `scenario-3d` (making or rigging the
mesh first), `scenario-video` (generating a reference performance when no footage exists), and
`scenario-video-editing` (trimming and resizing the clip). If a sibling skill named here is missing
from your available skills, load it with `skill_get` (Scenario MCP) or ask the user to install it
(https://github.com/scenario-labs/skills#install); unattended, proceed from tool schemas and flag
the gap.

## Quick reference

| Step             | Call                                                               | Watch for                                            |
| ---------------- | ------------------------------------------------------------------ | ---------------------------------------------------- |
| Upload inputs    | `upload_asset` with `kind: "video"`, then `kind: "3d"` for a mesh  | The mesh is optional on every member                 |
| Fit the clip     | `asset_get`, then trim or resize per `scenario-video-editing`      | Duration, size, and even-dimension limits per member |
| Pick a member    | `recommend` with `capability: "video23d"` and the user's own words | Read `next_step` per the `scenario` skill            |
| Read the inputs  | `model_schema_get`                                                 | Each file field's `kind`, the output enums           |
| Price, then run  | `model_run` with `dry_run: true`, then `wait: false`               | The `video` field carries `cost_impact`              |
| Wait and inspect | `jobs_wait`, then `asset_display`                                  | Facing, foot contact, and frame count                |

## Choose the output before the member

Three outcomes, and members cover different ones. Settle it with the user first (unattended: a
character whose existing rig the project depends on takes motion only; otherwise animate the mesh).

- **Your character, animated.** A member takes the mesh, auto-rigs it, and applies the motion. The
  rig is the member's own: it does not retarget onto a skeleton the mesh already carries, so clips
  built for an existing rig need bone remapping.
- **Motion only, on a named skeleton.** A member returns the animation on a Mixamo-style or
  MetaHuman skeleton without uploading your character. Choose this when the character is already
  rigged. The file can include a template mesh: inspect it, then omit that mesh when retargeting
  onto the user's rig.
- **Motion only, from a mesh member.** Some mesh members also offer an animation-only flag, which
  drops the mesh from the download.

`recommend` ranks the members on measured cost and latency and names which take a character. Ask it
with the user's words, including the outcome above, rather than with a bare capability.

## Read the schema, field by field

Field names repeat across members with different meanings, so read each field's `kind` before
filling it:

- One member's `characterFile` takes a 3D mesh; another member's `characterFile` takes a reference
  image of the character, while its mesh field is `characterModel`. The field's `kind` (`3d` or
  `image`), not its name, says which asset it takes.
- Output formats differ: one member writes engine-specific FBX variants (`fbx-blender`,
  `fbx-unreal`, `fbx-roblox`, Maya scene files), one a plain `glb` or `fbx` (its schema names `fbx`
  for Unity), and one exposes no format field at all. Pick the engine target in the run:
  `asset_download`'s `format` conversion is not documented to keep the animation.
- An FBX export can be ASCII. Blender's legacy FBX importer rejects it; use its newer ASCII-capable
  importer. Check the imported animation before calling the file Blender-ready.
- Controls worth setting when present: `moveInPlace` for game locomotion driven by code, `loop` for
  cycles, the frame rate field (named `frameRate`, `fps`, or `targetFps`), keyframe cleanup, and the
  `forward` and `up` axes when the motion arrives turned or lying down.
- Some members track several people (`numPeople`) or capture the face; both carry `cost_impact`.

## Footage that captures well

- One person, full body in frame for the whole clip, feet visible, a static camera, no one crossing
  in front. Loose clothing and props hide joints.
- Trim to the move that ships: price follows the clip, and members cap the input. At authoring time
  one capped it at 30 seconds and about 30 MB, another required even pixel width and height. Read
  `max_duration` and `max_size` when exposed by the schema. An absent cap is not a promise of
  unlimited input. Fix an over-cap clip with the video editing tools before pricing.
- No footage? Generate the performance with a video model per `scenario-video`: a single full-body
  character on a plain background, a locked-off camera, and the action described beat by beat. The
  generated clip is then the input like any other.
- Motion extraction targets human movement. A creature or a non-biped mesh needs checking frame by
  frame, and often a DCC pass.

## Worked example: a dance clip on a game character

The user has a phone clip of a dance and a character GLB, and wants an Unreal-ready loop.

1. `upload_asset` the clip (`kind: "video"`) and the GLB (`kind: "3d"`) per the `scenario` skill.
2. `asset_get` the clip: read the duration and dimensions. Trim to the eight seconds that loop with
   the video cut tool, and resize to even dimensions if a candidate member requires it.
3. `recommend` with `capability: "video23d"` and a prompt such as "apply the dance in this video to
   my uploaded character mesh, looping, exported for Unreal". Follow `next_step` per the `scenario`
   skill: present `ask_user` options; on `proceed`, take its pick without asking.
4. `model_schema_get` on the pick. Put the GLB in the field whose `kind` is `3d`. Set the Unreal
   output target if the format enum has one, `loop: true`, and `moveInPlace: true` if the game moves
   the character itself.
5. `model_run` with `dry_run: true` and quote the price. Then run with `wait: false`: these jobs
   take minutes. Retire it with `jobs_wait`, re-calling with `pending_job_ids` on timeout.
6. `asset_display` the result, or open it in a DCC. Check the facing, that the feet meet the ground,
   and that the loop point does not pop. If facing is wrong, check `forward` and `up` when the
   schema exposes them before blaming the capture. A preview link alone is not a visual check.
7. `asset_download` with no `format`, and hand over the file with the skeleton it uses.

## Common mistakes

- Expecting the motion on the character's existing rig: mesh members auto-rig from scratch. Use a
  motion-only member and retarget when the rig must stay.
- Filling a field by its name: `characterFile` is a mesh on one member and an image on another.
- Sending the full source video: the price grows with the clip, and over-cap clips fail.
- Converting the download to another 3D format instead of setting the export target in the run.
- Treating a sideways or upside-down result as a failed capture before trying the axis fields.
- Polling `job_get` instead of `jobs_wait`, or re-running a job that only timed out.

© scenario-labs · MIT · scenario-labs/skills

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

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
blender-export-pipelines blender-agent-skills Скилл blender-export-pipelines для Claude Code настраивает экспорт ассетов из Blender под игровые движки и другие форматы. Включается, когда ассет нужно выгрузить из Blender и проверить результат. CX Codex +1 681установок blender-export RobLe3 Скилл blender-export для Claude Code и пяти других платформ, который экспортирует сцены Blender в glTF/GLB, FBX, OBJ, USD и STL с нужными настройками под каждую цель. CX Codex +1 2 600установок blender-facial-shapekeys blender-agent-skills Скилл blender-facial-shapekeys для Claude Code настраивает лицевые риги и шейп-кеи в Blender 5.3 для ARKit 52 и экспорта в движки. Запускается при подготовке трехмерных персонажей к анимации или экспорту. CX Codex +1 548установок unreal-export https://github.com/arjun988 Скилл unreal-export для Claude Code автоматизирует экспорт моделей из Blender под Unreal Engine с учётом масштаба, коллизий и иерархии. CX Codex +1 533установок 3d-spatial dylantarre Скилл 3d-spatial переносит 12 классических принципов анимации Диснея в 3D, VR и AR. Помогает настроить физику, сплайны и тайминги в Blender, Unity или Unreal Engine. CX Codex +1 861установок meshy-3d calesthio Скилл meshy-3d для Claude Code создаёт 3D-модели из текста и изображений через Meshy. Он запускает генерацию, обработку текстур, риггинг и экспорт. CX Codex +1 142установок

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

Весь набор →
scenario-seedance-drafts Скилл scenario-seedance-drafts для Claude Code помогает сравнить черновые видео Seedance в 480p и завершить выбранный вариант в 1080p. Запускается при подготовке нескольких дублей одного ролика и выборе финального. CX Codex +1 542установок scenario-reel-recast Скилл scenario-reel-recast для Claude Code переносит танец из Reels, TikTok или Shorts на персонажа с референсного листа. Сохраняет движения, тайминг и ракурс, а песню возвращает в готовое видео. CX Codex +1 541установок scenario-motion-loops Скилл scenario-motion-loops для Claude Code создаёт зацикленную анимацию на Canvas 2D и рендерит её в MP4. Запускается для фонов, заставок и переходов в фирменных цветах. CX Codex +1 534установок scenario-unity-web Скилл scenario-unity-web настраивает сборку Unity 6.3 под браузер, сжатие для itch.io или CrazyGames и отслеживает зависания от многопоточного кода. CX Codex +1 533установок scenario-godot-expert Скилл scenario-godot-expert автоматизирует работу с Godot 4.7.2 через headless-скрипты, тесты GUT и захват кадров без мыши. Пригодится агентам для сборки сцен, тестов и замера времени кадра. CX Codex +1 498установок scenario-unreal-animation Скилл scenario-unreal-animation настраивает анимационный пайплайн в Unreal Engine 5: от ретаргетинга IK Rig и Motion Matching до оптимизации AnimBP и LOD для MetaHuman. CX Codex +1 485установок scenario-unreal-lighting-rendering Скилл scenario-unreal-lighting-rendering для Claude Code настраивает физическое освещение, Lumen GI и MegaLights в Unreal Engine 5.8. Калибровка камеры и проверка прокси-сцены помогают выявлять шум, утечки света и тёмные интерьеры. CX Codex +1 481установок scenario-unreal-world-building Скилл scenario-unreal-world-building для Unreal Engine 5 в Claude Code: помощь при строительстве уровней и открытых миров — World Partition, OFPA, Data Layers, ландшафт, процедурная генерация (PCG), Nanite, потоковая загрузка. CX Codex +1 481установок

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

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