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

scenario-motion-loops — скилл для Claude Code: что делает и установка

Скилл scenario-motion-loops для Claude Code создаёт зацикленную анимацию на Canvas 2D и рендерит её в MP4. Запускается для фонов, заставок и переходов в фирменных цветах.

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

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

Что делает scenario-motion-loops

Скилл собирает зацикленную анимацию в одном HTML-файле: кадр зависит от времени, а цвета задаются через палитру. Скрипт render-loop.mjs проверяет совпадение кадров на стыке цикла и рендерит видео. Для проверки и рендера нужен PASS.

Для работы нужны Node 18 или новее, ffmpeg 5.1 или новее с ffprobe и установленный Playwright. Playwright должен запускаться из папки проекта; для Chromium выполните npm install playwright и npx playwright install chromium либо используйте --channel chrome с установленным Google Chrome. По умолчанию видео рендерится в 1920×1080, 24 fps; для вертикального формата можно задать ширину и высоту флагами.

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

  • создать зацикленный анимированный фон для титров
  • отрендерить заставку или переход в фирменных цветах
  • проверить стык цикла перед экспортом в MP4
  • наложить вырезанного персонажа на анимацию

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

  • Создай зацикленный фон для титров в цветах бренда и отрендери его в MP4.
  • Сделай анимированную заставку и проверь, чтобы стык цикла не был заметен.
  • Наложи PNG персонажа с прозрачным фоном на цикл и подготовь вертикальный MP4.

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

1Через Skills CLI (Vercel)

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

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

~/.claude/skills/scenario-motion-loops/SKILL.md

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

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

Вопросы о scenario-motion-loops

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

Выполните npx skills add scenario-labs/skills --skill scenario-motion-loops -a claude-code. Файл скилла появится по пути ~/.claude/skills/scenario-motion-loops/SKILL.md.

Что делает scenario-motion-loops?

Создаёт зацикленную анимацию на Canvas 2D в HTML-файле, проверяет стык цикла и экспортирует результат в MP4. Можно добавить вырезанное изображение персонажа.

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

Нужны Node 18 или новее, ffmpeg 5.1 или новее с ffprobe и Playwright. Для рендера Playwright должен быть установлен в папке, откуда запускается скрипт.

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

SKILL.md · MIT
---
name: scenario-motion-loops
description: "Use when someone wants seamless looping motion graphics for video in their own brand colors: animated backgrounds behind titles, filler for the dead seconds between AI shots, bumpers, transitions or shape animations, built as code and rendered to MP4, optionally with their mascot, product or character from Scenario composited over the loop. Keywords: seamless loop, motion background, canvas animation, motion graphics, loop seam, motion blur, H.264 export, alpha composite."
license: MIT
---

# Scenario Motion Loops

## Overview

A loop is a pure function of time, drawn with Canvas 2D in one HTML file. Nothing is generated, so
nothing warps or flickers, one color change rebrands it, and it renders at any size.

- `draw(ctx, w, h, t, P)` paints the frame at `t` seconds. Every period divides the 12 s loop, so
  the frame at 12 s is the frame at 0 s.
- [scripts/loop-template.html](scripts/loop-template.html) holds the helpers (`M.*`), the palette
  (`P`) and `tile(...)` registration. Tiles from the Motion Loops exploration on scenario.com (80
  loops, each with its code) run in it unchanged.
- [scripts/render-loop.mjs](scripts/render-loop.mjs) checks the page, renders stills or the MP4, and
  checks the encoded file.
- Scenario makes only the subject: a mascot, product or character as a cut-out PNG with alpha. The
  page draws it on the loop's clock, so the composite keeps the motion blur and still loops. The
  loop itself costs nothing.

Needs Node 18 or newer, ffmpeg 5.1 or newer with ffprobe, and Playwright where the script runs
(`npm install playwright`, then `npx playwright install chromium`, or `--channel chrome` with Google
Chrome installed). Connection, model discovery, uploads and pricing: see the `scenario` skill. The
cut-out: `scenario-image-editing`. The video shot: `scenario-video`, and its background removal:
`scenario-video-editing`. 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

```bash
cp scripts/loop-template.html loop.html            # one loop per file: settings, draw(), overlay
# open loop.html in a browser to preview; ?t=3 freezes it, ?tone=accent or ?tone=light switches tone
node scripts/render-loop.mjs loop.html --check     # determinism and loop seam, no video
node scripts/render-loop.mjs loop.html --stills look --at 0,3,6,9               # stills to look at
node scripts/render-loop.mjs loop.html --out loop.mp4                            # 12 s, 1920x1080, 24 fps
node scripts/render-loop.mjs loop.html --params "overlay=subject.png" --out loop.mp4   # with a cut-out
node scripts/render-loop.mjs loop.html --width 1080 --height 1920 --out loop-9x16.mp4  # vertical
node scripts/render-loop.mjs --qa loop.mp4 composite.mp4   # seam and format check of any MP4
```

- Run it from a folder where Playwright is installed. Existing files are never overwritten without
  `--force`.
- The page check renders one moment twice (they must match) and compares the frame at exactly 12 s
  with the frame at 0 s. It also compares the step across the loop point with the motion around it
  and at every cycle boundary.
- A render refuses to encode unless the check prints `PASS`. `--ignore-seam` is only for a cut
  designed to sit at the loop point; it waives the seam verdict of both checks.
- Defaults, the settings the 80 loops shipped with: 24 fps, 8 motion-blur sub-frames over a 180
  degree shutter, 2x supersampling, H.264 High, CRF 16, 4:2:0, BT.709 limited range, faststart.
- A full 1080p render took about 6 minutes at authoring time (about 1.3 s per frame). Run it with a
  long timeout, or in the background.

Rules every tile follows:

- **Periods**: every period divides 12 s (1, 1.5, 2, 3, 4, 6, 12). Use `M.phase(t, period, offset)`.
- **Scrolls**: move a whole number of pattern repeats per period; a fractional repeat jumps at the
  seam.
- **Randomness**: only from `M.rand(i, salt)`. Never `Math.random`, `Date` or state carried between
  frames: motion blur and the checks render frames out of order.
- **Units**: sizes from `u = h / 100`, counts from `w`, so a loop holds at 16:9, 9:16, 1:1 and
  thumbnail size.
- **Colors**: only from `P` (`bg`, `fg`, `fg2`, `mid`, `accent`, `paper`, `ink`). Rebrand by
  changing `BRAND`; fix contrast by changing tone (dark, accent, light), never by adding a color.
- **Multi-hue loops**: a rainbow or hue sweep is the one exception. Compute hues as
  `hsl(${360 * M.phase(t, 12)}, ...)` with a period dividing 12, and keep its settings in `BRAND` so
  it still rebrands from one place.
- **Easing**: from `M.ease`, with anticipation, overshoot and holds. Constant speed only for scrolls
  and streams.

Patterns that close the loop, depth without a 3D engine, and review habits:
[references/loop-craft.md](references/loop-craft.md). Read it before writing a new `draw()`.

## Worked example: a brand mascot floating over a coded loop

Goal: a 12 s seamless 1920x1080 loop in the brand's colors with the brand's mascot floating in it,
and optionally a version where the mascot waves.

1. **Build the loop first (local, free).** `cp scripts/loop-template.html mascot-loop.html`, set
   `BRAND.accent` to the brand color, and keep the example tile (Perspective Floor, a grid streaming
   toward the camera) or write your own `draw()`. Then:

   ```bash
   node scripts/render-loop.mjs mascot-loop.html --check
   node scripts/render-loop.mjs mascot-loop.html --stills look --at 0,3,6,9
   ```

   `--check` must end in `PASS`. Look at the stills.

2. **Make the cut-out.** Connect and pick the team and project per the `scenario` skill. Upload the
   user's mascot file if there is one. `recommend` with:

   ```json
   {
     "capability": "img2img",
     "prompt": "The mascot from the reference image, full body, three-quarter view, a light floating pose, cut out on a transparent background with clean edges, no shadow, no text",
     "limit": 5
   }
   ```

   Without a file, use `"capability": "txt2img"` and describe the mascot. Prefer a member whose
   `model_schema_get` schema offers a transparent background. Otherwise remove the background
   afterwards per `scenario-image-editing`. Price with `dry_run` and wait for the user's go.
   Unattended, run only within a budget the task states; otherwise stop and report the price. Then
   `asset_download` with `"format": "png"` and `curl -L -o subject.png "<url>"` into the folder of
   `mascot-loop.html`.

3. **Inspect the cut-out.** View the PNG at 100% over the loop's background color. Halos at the
   outline show on dark tones: regenerate rather than hide them. A background remover's schema often
   has an edge or threshold setting: raise it on the re-run.

4. **Composite in the canvas and render.**

   ```bash
   node scripts/render-loop.mjs mascot-loop.html --params "overlay=subject.png" --stills look --at 0,0.75,1.5,2.25 --force
   node scripts/render-loop.mjs mascot-loop.html --params "overlay=subject.png" --out mascot-loop.mp4 --psnr 4
   ```

   `drawOverlay()` in the page floats the subject on a 3 s bob and a 6 s sway with a contact shadow,
   so the composite still loops. Adjust size and placement there. The script checks the page,
   renders 288 frames, encodes, and checks the file's loop point. `--psnr` compares one encoded
   frame with its lossless render.

5. **Optional: a shot where the mascot moves.**
   - Generate it per `scenario-video`: `img2video` from the cut-out, prompted "the mascot waves and
     turns its head, plain flat background, locked-off camera, no cuts". A plain background and a
     locked camera make the removal clean.
   - Remove its background per `scenario-video-editing`, choosing WebM VP9 with alpha (ProRes 4444
     for editing software).
   - Render the loop without the overlay (`--out loop-plain.mp4`) and lay the shot over it:

   ```bash
   ffmpeg -stream_loop -1 -i loop-plain.mp4 -c:v libvpx-vp9 -i shot.webm \
     -filter_complex "[1:v]fps=24,scale=-2:720[s];[0:v][s]overlay=(W-w)/2:(H-h)/2:shortest=1,format=yuv420p,setparams=colorspace=bt709:color_primaries=bt709:color_trc=bt709:range=tv" \
     -c:v libx264 -crf 16 -preset slow -colorspace bt709 -color_primaries bt709 -color_trc bt709 \
     -color_range tv -movflags +faststart -an composite.mp4
   ```

   The composite is as long as the shot. It is not a seamless loop unless the shot loops: run `--qa`
   on anything meant to loop.

6. **Hand over** the HTML (the loop stays editable), the MP4, the stills and any composite.

## Common mistakes

- **A seam jump at 12 s.** A period that does not divide 12 (a 5 s cycle), or a scroll that moves
  2.5 repeats. `--check` reports `SEAM JUMP`. Fix the period; never crossfade the ends.
- **State, `Math.random` or `Date` in a tile.** The same `t` gives different frames and the loop
  cannot close. `--check` reports `NOT DETERMINISTIC`.
- **Color helpers that only read hex.** `P.mid` and `M.mixColor` return `rgb()` strings, and a
  hex-only parser silently turns them black. Use the template's `M.rgba` and `M.mixColor`.
- **Strobing on fast moves.** Eight sub-frames show stepped copies on a whole-frame push; one
  full-page swipe needed 40. Raise `--samples` for very fast loops.
- **Treating every flag as a bug.** A designed snap (a pop, a burst) or a hold at the loop point can
  trip the seam check. Look at the frames before changing the code.
- **A counter that wraps wrong.** Anything indexed by cycle wraps with `M.mod`, or it reads "06 /
  05" at the loop point.
- **Text before the font loads.** Canvas text does not wait for web fonts: await
  `document.fonts.load(...)` before the first frame, or draw no text.
- **Opening the page from `file://` to render.** A local overlay image taints the canvas and the
  readback fails. `render-loop.mjs` serves the folder over a local address; the browser preview is
  unaffected.
- **Chasing bitrate.** On flat color the file looks small, but the encoder adds almost no loss. The
  real loss is 4:2:0 chroma on thin saturated lines: check with `--psnr` and thicken those lines.
- **Color flags without `setparams`.** `-colorspace`, `-color_primaries` and `-color_trc` alone left
  primaries and transfer untagged on ffmpeg 7. End the filter chain with `setparams`, as both
  commands here do. `--qa` reports `UNTAGGED COLOR` otherwise.
- **Losing the alpha of a VP9 shot.** ffmpeg's built-in VP9 decoder ignores alpha and the shot
  arrives in a black box. Put `-c:v libvpx-vp9` before `-i shot.webm`. ffprobe reports such a file
  as `yuv420p` with `alpha_mode=1`; it still has alpha.
- **Making the loop with a video model.** A generated clip's last frame rarely meets its first. Keep
  the loop in code; use Scenario for the subject.

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

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

Все скиллы по теме «Дизайн» →
gamification-loops omer-metin Скилл gamification-loops для Claude Code проектирует баллы, значки, стрики и лидерборды, опираясь на психологию мотивации. Держит фокус на удержании пользователя, а не на росте цифр. CX Codex +1 640установок continuous-loops dylantarre Скилл continuous-loops для Claude Code учит агента создавать зацикленные CSS-анимации по принципам классической мультипликации. Создаёт анимации для лоадеров, пульсаций, шиммеров и фоновых эффектов. CX Codex +1 569установок marketing-loops coreyhaines31 Скилл marketing-loops для Claude Code настраивает повторяющиеся маркетинговые задачи по расписанию или событию. Он задаёт проверку, условия действия и момент остановки. CX Codex +1 59 000установок motion-design LottieFiles Скилл motion-design для Claude Code помогает проектировать анимации интерфейса: выбирать длительность, easing и последовательность движения. Задачи анимации — микровзаимодействия, загрузка и переходы между страницами. CX Codex +1 27 800установок design-motion-principles kylezantos Скилл design-motion-principles для Claude Code создаёт анимацию интерфейсов и проверяет уже готовую. Запускается на задачах с переходами, наведением и микровзаимодействиями. CX Codex +1 14 500установок framer-motion-animator patricio0312rev Скилл framer-motion-animator помогает создавать анимации и микроинтерфейсы на Framer Motion: от переходов между страницами до жестов свайпа и скролла. Пригодится при вёрстке интерактивных React-компонентов. CX Codex +1 11 700установок

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

Весь набор →
scenario-video-color-grade Скилл scenario-video-color-grade для Claude Code и Cursor подбирает цвета, исправляет свет и экспортирует таблицы LUT для видео и изображений. CX Codex +1 558установок scenario-unity-2d Скилл scenario-unity-2d настраивает 2D-игры в Unity 6.3 URP: импорт спрайтов, тайлмапы, освещение, физику прыжка и Pixel Perfect Camera без размытия и дрожания. CX Codex +1 544установок 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-unity-web Скилл scenario-unity-web настраивает сборку Unity 6.3 под браузер, сжатие для itch.io или CrazyGames и отслеживает зависания от многопоточного кода. CX Codex +1 533установок scenario-video-to-motion Скилл scenario-video-to-motion для Claude Code переносит движения людей из видеоролика в 3D-анимацию персонажей через Scenario MCP. Создаёт циклы движения и риги для Unreal, Unity или Blender. CX Codex +1 516установок 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установок

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

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