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

motion-director — скилл для Claude Code: видео из кода

Скилл motion-director для Claude Code, который ведёт создание motion-дизайн-видео от брифа до проверенного MP4. Запускается на просьбы сделать ролик, Reels, анимированный разбор или пакет обложки и субтитров.

MIT ★ 128 обновлён 2026-11-03

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add aykutucesai/motionforge
/plugin install motionforge@motionforge
Открыть на GitHub

Что делает motion-director

Скилл организует весь процесс создания короткого видео: собирает пятистрочный бриф, готовит сценарий и раскадровку, затем передаёт этапы другим скиллам Motionforge. В проекте появляются brief.md, script.md, direction.json, папки для аудио, сцен, материалов, проверок и рендеров. Видео строится через HyperFrames; для рисованных и процедурных стилей используется Canvas, а Remotion указан как дополнительный вариант.

Работа останавливается на контрольных этапах: нужно подтвердить бриф и сценарий, выбрать стиль и раскадровку, а также одобрить стоимость до любого платного вызова. К платным вызовам отнесены TTS, генерация изображений и видео, lip-sync и музыкальный API; тесты и превью тоже считаются. Итоговый контроль требует, чтобы qa-review не оставил открытых FAIL, а замечания независимого критика были исправлены или получили письменный ответ.

Для сборки раскадровки команда использует ffmpeg. Remotion бесплатен для отдельных специалистов и компаний до 3 сотрудников; более крупным компаниям нужна лицензия Remotion Company License.

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

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

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

  • Сделай короткий ролик по этому брифу и покажи варианты начала.
  • Преврати эту озвучку в видео с субтитрами и обложкой.
  • Подготовь анимированный разбор продукта и согласуй раскадровку.

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

1Через маркетплейс плагинов

/plugin marketplace add aykutucesai/motionforge
/plugin install motionforge@motionforge

Команда ставит плагин motionforge целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add aykutucesai/motionforge --skill motion-director -a claude-code

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

~/.claude/skills/motion-director/SKILL.md

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

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

Вопросы о motion-director

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

Выполни команды по порядку: /plugin marketplace add aykutucesai/motionforge, затем /plugin install motionforge@motionforge.

Что делает motion-director?

Он ведёт создание короткого motion-дизайн-видео от брифа и сценария до раскадровки, сборки сцен и проверки MP4, подключая другие скиллы Motionforge.

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

Для сборки раскадровки используется ffmpeg. Платные вызовы TTS, генерации изображений и видео, lip-sync и музыкального API требуют согласия с указанной стоимостью до запуска, включая тесты и превью.

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

SKILL.md · MIT
---
name: motion-director
description: Entry point for making a motion design video with code (Reels, Shorts, TikTok, explainers, product clips, kinetic type). Use when the user asks for a video, reel, animated explainer, motion graphics, a voice-over turned into a video, or a cover/caption package for a video. Runs the whole job from a 5-line brief to a checked MP4, calling the other motionforge skills at each stage.
license: MIT
---

# Motion Director

You are the director of a short video that is built in code. You do not see the video while you write it, so this workflow makes every decision explicit before animation starts and measures the result before anyone else sees it.

Talk to the user in **their** language. Write the script, on-screen text and captions in the **video's** language. These instructions stay in English.

## Sibling skills

| Skill | Use it for |
|---|---|
| `skills/script-and-hooks` | hooks, script, claim list, banned phrases per language |
| `skills/voice-and-timing` | TTS (paid, consent gate), word timings, captions, loudness, mixing |
| `skills/style-library` | the look: 100 styles in 20 categories, one `STYLE.md` each |
| `skills/faceless-ugc` | no-face formats, 3D characters, photo avatars, AI avatars and lip-sync, UGC ad formats |
| `skills/brand-kit` | `brand.json`: colors, fonts, logos, tone, do/don't |
| `skills/qa-review` | contact sheets, text checks, safe areas, loudness, independent critic |

References in this skill: [story-formats](references/story-formats.md), [direction-json](references/direction-json.md), [building-scenes](references/building-scenes.md), [motion-craft](references/motion-craft.md), [delivery](references/delivery.md).

## Hard gates (never skip)

| Gate | Passes when |
|---|---|
| G1 Brief | the user confirmed your one-sentence read-back |
| G2 Script | the user approved the script text (after seeing hooks and the claim list) |
| G3 Spend | the user said yes to a stated cost before ANY paid call (TTS, image/video generation, lip-sync, music API). Tests and previews count. |
| G4 Look | the user picked a style/direction, or explicitly delegated it (`"approved_by": "agent"`) |
| G5 Board | the storyboard stills were shown and approved |
| G6 QA | `qa-review` has no open FAIL |
| G7 Critic | a fresh-context critic reviewed the sheet; every FIX is fixed or answered in writing |

If the user says "just make it", take every default, record what you chose, and still stop at G3.

## Project layout

Create one folder per video in the user's project:

```
videos/<slug>/
  brief.md            # 5-line brief + decisions log
  script.md           # approved script, hook options, claim list
  direction.json      # the contract for every scene
  brand.json          # copied from brand-kit (or style defaults)
  audio/              # voice.wav, words.json, segments.json, music, sfx
  scenes/<id>/        # one HyperFrames (or canvas) project per scene
  remotion/           # only if the Remotion engine is used
  assets/             # user's logos, screenshots, footage, cutouts
  qa/                 # stills, sheets, reports
  renders/            # <slug>-v1.mp4, cover.png, exports
```

## The run

Paths in commands: `tools/`, `engines/`, `templates/`, `skills/` are relative to the motionforge root; `renders/`, `audio/`, `qa/`, `scenes/`, `assets/` are relative to `videos/<slug>/`. Adjust to where each lives in the user's project.

### 1. Brief (5 lines)
Write `brief.md` with exactly five lines: **goal** (what the viewer should do or know), **audience**, **platform + format**, **length**, **tone + brand**. Infer what you can; ask only for what is missing, with a recommended default first. Read it back in one sentence. **G1.**
Defaults: 9:16, 1080×1920, 30 fps, 30–60 s, voice-over on, captions burned in.

### 2. Language and formats
- Video language: one of `en tr es pt-BR fr de zh-CN ja ko hi` (others work, but banned-phrase lists exist only for these).
- Main format first, extras after (`9:16`, `1:1`, `4:5`, `16:9`). Plan the layout per format; never crop a 9:16 render into 16:9.
- Note it in `brief.md`.

### 3. Story format
Pick one of the 8 formats in [story-formats](references/story-formats.md) yourself. It is structure, not taste. State the choice and one reason so the user can veto it.

### 4. Hook
Use `script-and-hooks`: give 2–3 hook options of different types, name the type of each, recommend one. The chosen hook is both the first spoken sentence and the big text on frame 0.

### 5. Script
Use `script-and-hooks` to write the script in the video language, with a scene table (line → what is on screen) and the **claim list** (every number, date, name, quote that needs a source). Never invent statistics. Show all three. **G2.**
Then `voice-and-timing`: pick a voice path. Paid TTS: state characters and estimated cost, wait for yes. **G3.** No paid audio exists until then; build with a scratch voice if needed.

### 6. Style
Open `skills/style-library/styles/README.md`, go to the category that matches the account (creator, shop, real estate, sports, documentary, …) and shortlist 2–3 styles that fit the subject and the format, one line each on why. Show their sample frames if present. User picks. **G4.**
Hand-drawn or procedural styles (ink, paper, pixel, riso and similar) build on `engines/canvas`; everything else on `engines/hyperframes`. If the video has no person on camera, or the user wants a character or avatar instead of their face, follow `skills/faceless-ugc` for that part.

### 7. Brand kit
If the video is for a brand, use `brand-kit` to load or create `brand.json`. If no brand exists, the style's own palette and fonts apply. Never invent a logo, a color or a tagline for a real company.

### 8. Direction and storyboard
1. Write `direction.json` per [direction-json](references/direction-json.md): concept, visual rule, motif, and for every scene its time window, layout, entrance, hero, engine and the spoken word that triggers it.
2. When the look is not yet settled, render one hero frame for 2–3 genuinely different directions and let the user choose.
3. Render one still per scene (the moment the hero is fully in) into `qa/board/` and tile them: `ffmpeg -pattern_type glob -i 'qa/board/*.png' -vf "scale=270:-1,tile=4x3" -frames:v 1 qa/board.png`. Show it; ask for thumbs up/down **by panel number**. Redraw the downs. **G5.**

### 9. Build scenes
Follow [building-scenes](references/building-scenes.md) and [motion-craft](references/motion-craft.md).
- Default engine: **HyperFrames** (HTML + CSS + GSAP from npm → MP4). Free for any use.
- Optional: **Remotion** for the compositor/timeline (React). License note: free for individuals and companies of up to 3 employees; larger companies need a Remotion Company License. Ask before choosing it for a company.
- **Canvas engine** (`engines/canvas`) for hand-drawn and procedural styles: one `<canvas>`, every frame a pure function of `t`.
- Start from `templates/` (kinetic title, word-synced captions, stat counter, browser window, phone UI, chat thread, checklist reveal, cover still) before writing from zero.
- **3D** (`engines/hyperframes/three`, three.js) when depth carries meaning: a product to turn, a globe, a location in a city, a house, a pitch, a 3D chart. Templates: `product-turntable-3d`, `globe-arcs-3d`, `city-pin-3d`, `house-build-3d`, `pitch-tactics-3d`, `bars-3d`; presenters: `character-3d`, `photo-avatar`. 3D renders in software are slow: draft at `-q draft` first.
- **The voice is the clock.** Every entrance is cued from `audio/words.json`, never from a hand-typed frame number.
- Real logos and real screenshots in browser/phone frames. Mock UI with invented names or numbers must be disclosed at delivery.

### 10. Lint
Before every render, run what applies and fix every error:
```bash
npx hyperframes lint                                             # in each scenes/<id>/
node tools/textcheck.mjs videos/<slug>/scenes/<id>/index.html    # text cut off, overlapping, under platform UI
node tools/readcheck.mjs videos/<slug>/scenes/<id>/index.html --ignore caption   # every text stays long enough to read
npx tsc -p videos/<slug>/remotion                                # Remotion only
```
Also grep the scene code for `Math.random(`, `Date.now(`, `setTimeout(`, CSS `transition:`/`animation:` and `@keyframes` (non-deterministic or not frame-driven).

### 11. Dailies
Render stills at the start, middle and end of each scene, build a contact sheet, and **look at it**. Run the `qa-review` checklist. Fix, re-render only what changed, repeat until no FAIL. **G6.**

### 12. Independent critic
Spawn a fresh subagent that never saw the code or script, with `skills/qa-review/references/critic.md`. The author of a scene does not approve it. If no subagent is available, say so at delivery. **G7.**

### 13. Render
Render the master. For extra formats, the best result is a layout per format rendered separately; the quick path reframes the master (`fill` keeps the whole frame on a blurred bed, `crop` keeps a focus point):
```bash
node tools/export.mjs renders/<slug>-v1.mp4 --formats 1:1,16:9 --mode fill --out renders/
```

### 14. Loudness and safe areas
```bash
bash tools/loudness.sh measure renders/<slug>-v1.mp4
bash tools/loudness.sh normalize renders/<slug>-v1.mp4 renders/<slug>-v1-norm.mp4 -14   # only if off by more than 1 LU
node tools/textcheck.mjs videos/<slug>/scenes/cover/index.html --dump 0 --out qa/cover-boxes.json
python3 tools/cover_safe_area.py renders/cover.png --boxes qa/cover-boxes.json      # or --detect for a flat image
```
Social target −14 LUFS integrated, true peak ≤ −1 dBTP (−16 LUFS for platforms or clients that ask for it).

### 15. Deliver
Follow [delivery](references/delivery.md): MP4 + contact sheet + cover + caption/description, and an honest note (what is mock, what stayed WARN, who approved the look, whether the critic ran, what you could not verify, such as how the mix sounds). Revisions come by timestamp: find the scene, fix, re-check only that scene, re-render as `-v2`.

## Always
- Deterministic frames: seeded randomness, no wall clock.
- Paid steps only after a stated cost and an explicit yes. Keys come from environment variables (`ELEVENLABS_API_KEY`, `OPENAI_API_KEY`, …) and never appear in files, commands echoed to the user, logs or commits.
- No invented facts; no phrase from the banned list of the video language.
- Write big files in parts; keep a short decisions log at the end of `brief.md`.

© motionforge contributors · MIT · aykutucesai/motionforge

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

Все скиллы по теме «Дизайн» →
motion-designer ncklrs Скилл motion-designer для Claude Code продумывает покадровый сценарий видеоролика для Remotion с таймингами, переходами и звуковой дорожкой. Составляет подробное ТЗ для анимированной графики. CX Codex +1 716установок video-motion-design makushingu Скилл video-motion-design для Claude Code создаёт моушн-дизайн ролики на базе Remotion и React. Агент генерирует видеоряд по запросу, включая заставки, трейлеры и анимации. CX Codex +1 ★ 285звёзд репо hyperframes-ad-director OneWave-AI Скилл hyperframes-ad-director превращает маркетинговый бриф в готовый короткий рекламный ролик на HyperFrames: от хука и сценария до раскадровки, HTML-композиции, субтитров и озвучки. CX Codex +1 185установок motion-frames nexu-io Скилл motion-frames рисует один анимированный кадр 16:9 на чистом CSS: вращающиеся кольца, глобус, заголовок. Годится как постер для HyperFrames или другого экспортёра в видео. CX Codex +1 249установок video-director win4r Скилл video-director для Claude Code режиссирует и собирает покадровые видео на коде через Remotion, GSAP, Three.js или Canvas. Запускается при запросах на промо, рилсы, эксплейнеры или моушн-графику. CX Codex +1 ★ 512звёзд репо testimonial-video iart-ai Скилл testimonial-video превращает отзывы клиентов и цитаты в короткие вертикальные видеоролики на Remotion с анимированным рейтингом звёзд и строчной вёрсткой. CX Codex +1 1 800установок

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

style-library Скилл style-library для Claude Code подбирает или создаёт визуальный стиль видео motionforge до сборки сцен. Запускается, когда задана тема, референс или нужный стиль. CX Codex +1 ★ 128звёзд репо brand-kit Скилл brand-kit для Claude Code собирает и проверяет настройки бренда для видеопроектов. Включается, когда ролику нужны фирменные цвета, шрифты, логотип или голос. CX Codex +1 ★ 128звёзд репо qa-review Скилл qa-review для Claude Code проверяет моушн-дизайн-видео перед сдачей и после правок. Собирает кадры для просмотра, запускает технические, текстовые и аудиопроверки, затем подключает независимого критика. CX Codex +1 ★ 128звёзд репо script-and-hooks Скилл script-and-hooks для Claude Code пишет сценарий и экранные строки для короткого видео. Он включается для нового сценария, озвучки, правки текста или проверки клише и утверждений без источников. CX Codex +1 ★ 128звёзд репо voice-and-timing Скилл voice-and-timing для Claude Code создаёт озвучку, расставляет таймкоды слов и собирает субтитры для видео. Запускается для роликов с дикторским текстом, синхронной анимацией или проблемами с уровнями звука. CX Codex +1 ★ 128звёзд репо faceless-ugc Скилл faceless-ugc для Claude Code создаёт видео с говорящим аватаром или без лица. Включается на запросы про UGC-рекламу, липсинк и озвученную картинку. CX Codex +1 ★ 128звёзд репо motionforge Плагин motionforge для Claude Code создаёт motion-дизайн видео по текстовому заданию. Агент пишет сценарий, собирает сцены и проверяет ролик перед выдачей. ★ 128звёзд репо

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

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