shot-list

---
name: shot-list
description: "Builds a shot list from a script, voiceover or brief: a table of shots (timecode, shot type, line or voiceover, visual, duration, source: shoot, generation, archive, stock, motion, screenshot), rules for breakdown and pacing per platform, a shooting plan by location, a generation plan, an archive and graphics list, and script notes. Includes a script that checks the table: total duration against target, empty cells, overly long shots, broken timecodes. Use when a script needs to become shots. Triggers: 'shot list', 'storyboard from script', 'break down the script', 'b-roll plan', 'shooting plan', 'how many shots for 30 seconds'. Triggers (RU): «раскадровка», «разбей сценарий на кадры», «шот-лист», «что снимать под текст», «какие перебивки», «план съёмки», «чем накрыть закадр», «сколько кадров на 30 секунд»."
---

# Раскадровка из сценария

> Instructions are in Russian. Respond in the user's language.

## Зачем

Сценарий читается, а ролик смотрится. Между ними таблица кадров: что
зритель видит в каждую секунду, откуда этот кадр берётся и сколько он
стоит. Без таблицы съёмка идёт «по ощущениям», генерации делаются лишние,
архив ищется под весь ролик сразу, а на монтаже выясняется, что под
третью фразу нечего поставить.

Таблица нужна и для согласования: клиент видит ритм до того, как
потрачены деньги на съёмку и генерации. В препродакшн-пакете
(`ai-video-concept`) это часть синопсиса.

## На чём работает

| Что | Зачем здесь |
|---|---|
| Сценарий, закадр или синопсис из `ai-video-concept` | вход; таблица кадров с таймкодами входит в синопсис |
| Таблица кадров в markdown | у каждого кадра таймкод встык и источник; проверяется `scripts/check_shotlist.py` |
| Higgsfield: Seedream 5 Pro, Nano Banana | статика для кадров `генерация`, с луком из `film-look` |
| Seedance | ролик целиком одним промптом: шапка (герой, локация, продукт, свет, звук), потом шоты с таймкодами из этой таблицы, в конце лук. У каждого шота короткое имя-якорь вместо «как на референсе 4»: картинки уходят в модель в произвольном порядке. В Higgsfield язык промпта ставь английский явно |
| `archive-footage` | всё с источником `архив` и `сток` |
| Монтаж (DaVinci Resolve или аналог), `motion-graphics` | текст и плашки кладутся поверх на монтаже, в генерацию не вшиваются |

## Когда включать

- Есть сценарий, закадровый текст или бриф, и нужно понять, что в кадре.
- Нужно разделить работу: что снимаем, что генерим, что ищем в архиве,
  что делает моушен.
- Ролик провисает по ритму, и надо понять где.

## Шаг 1. Параметры

Спроси одним сообщением всё, чего нет в тексте:

- площадка и соотношение сторон (Reels и Shorts 9:16, YouTube 16:9,
  квадрат или 4:5 для ленты);
- целевой хронометраж;
- характер: реклама, документальный, гайд, разбор;
- что доступно для съёмки: локации, реквизит, есть ли герой в кадре,
  сколько дней;
- можно ли генерацию и в каком объёме;
- стайл-шит проекта: лук генераций, шрифты и правила графики.

Что можно вытащить из текста, вытащи сам и уточни только пробелы.

## Шаг 2. Хронометраж текста

Закадр задаёт длину ролика жёстче всего. Ориентир для русского закадра в
спокойном темпе около 2-2,5 слов в секунду, в рекламном быстрее. Это
ориентир, не закон: прочитай текст вслух с секундомером или замерь на
дикторе проекта. Если текст на 40 секунд, а ролик 30, режь текст сейчас,
а не на монтаже.

## Шаг 3. Правила разбивки

**Хук в первые 2-3 секунды.** Самый сильный визуал и самая цепкая фраза.
Не «здравствуйте, сегодня расскажу».

**Темп смены плана:**

- Reels, Shorts, TikTok: 1,5-3 секунды на план;
- YouTube и длинные форматы: 3-7 секунд, говорящая голова может висеть
  дольше, если держит энергию.

**Чередование.** Одно лицо без перебивки дольше 5-8 секунд в длинном
формате и 3-4 секунд в вертикали зритель не держит. Чередуй крупность
(общий, средний, крупный, деталь) и тип (синхрон, перебивка, графика).

**Перебивка не повторяет слова буквально.** Говорят «деньги», купюры не
показывай: ищи контраст, следствие, неожиданный угол. Буквально можно
только конкретный предмет или интерфейс, о котором речь.

**Графика подчёркивает факт, а не заполняет пустоту.** Плашка нужна там,
где есть цифра, список, название, адрес. Если кадра хватает, графику не
ставь.

**Один кадр, одна мысль.** Две реплики на одном плане в вертикали почти
всегда провисают.

**Ничего не выдумывать.** Цифры, имена, названия, характеристики только
из сценария и материалов клиента. Не хватает факта, пиши в ячейке
`УТОЧНИТЬ У КЛИЕНТА`, не подставляй правдоподобное.

## Шаг 4. Таблица кадров

```
| # | Таймкод | Тип кадра | Реплика / закадр | Визуал | Длит. | Источник |
|---|---|---|---|---|---|---|
| 1 | 0:00 | Крупный, хук | ЗК: «...» | что в кадре, движение | 2 | съёмка: ракурс, свет |
```

Как заполнять:

- **Таймкод**: начало кадра, `м:сс` или `м:сс.д`. Начало следующего
  равно началу прошлого плюс его длительность.
- **Тип кадра**: крупность (общий, средний, крупный, деталь) плюс роль
  (хук, синхрон, перебивка, графика, финал).
- **Реплика / закадр**: точная цитата. `ЗК:` для закадра, без пометки для
  синхрона в кадре. Нет текста на этом плане, ставь `-`.
- **Визуал**: конкретный кадр в одном-двух предложениях: кто, что делает,
  движение камеры. «Нарезка кадров производства» это не план, а отписка.
- **Длит.**: секунды, можно дробные (`2.5`).
- **Источник**, одно слово в начале и подробности через двоеточие:
  - `съёмка`: ракурс, движение камеры, свет, время дня;
  - `генерация`: статика или видео, какие референсы, лук проекта
    (`film-look`), соотношение сторон параметром модели;
  - `архив`: что искать, факт из текста (поиск делает `archive-footage`);
  - `сток`: 2-3 запроса на английском;
  - `моушен`: роль графики (ниже);
  - `скриншот`: что на экране, нужна ли подсветка.

Для синхрона в кадре добавь в визуал крупность, фон, что в руках, куда
смотрит и энергию от 1 до 10: это нужно оператору и актёру.

## Шаг 5. Графика по ролям

Описывай роль плашки, а не шаблон, шаблон подберёт стайл-шит:

- `fact`: плашка-факт, заголовок и строка подписи;
- `number`: цифра со счётчиком и единицей;
- `note`: скромная заметка в углу;
- `list`: перечисление, до 3-4 пунктов;
- `endcard`: финальная карточка с логотипом.

Правила текста на экране: 3-7 слов в заголовке, плашка не пересказывает
закадр дословно, разные роли подряд (не три `fact` друг за другом),
логотип только из вектора клиента. Шрифты обычные, цифры набираются тем же
сансом с табличными цифрами (`font-variant-numeric: tabular-nums`), без
моноширинных шрифтов и «терминального» стиля.

## Шаг 6. Производные списки

Из готовой таблицы собери:

1. **Съёмочный план.** Все кадры с источником `съёмка`, сгруппированные
   по локации, внутри по свету и одежде, чтобы снять за минимум заходов.
   Отдельно: что снимается один раз и переиспользуется.
2. **План генераций.** Кадры `генерация`, сгруппированные по набору
   референсов (герой, локация, продукт). Сначала статика на выбор, потом
   анимация утверждённой.
3. **Список архива.** Кадры `архив` с фактом из текста, по которому
   искать. Передаётся в `archive-footage`.
4. **Сток-лист.** Запросы на английском одним списком без повторов.
5. **Моушен-лист.** Роли и тексты плашек по порядку появления.

## Шаг 7. Замечания по сценарию

Прямо и коротко: что трудно визуализировать, где провисает ритм, что
сократить или переставить, какие цифры не подтверждены. Это рабочая
правка, без реверансов. Реплика без единого конкретного существительного
обычно не накрывается ничем: это сигнал переписать её конкретнее.

## Проверка таблицы

```
python3 scripts/check_shotlist.py shotlist.md --target 30 --max 3
python3 scripts/check_shotlist.py shotlist.md --target 90 --tolerance 3
```

Скрипт находит первую таблицу с колонкой «Длит.» и проверяет: сумму
длительностей против `--target` с допуском `--tolerance` (по умолчанию 1
секунда), пустые ячейки (прочерк `-` считается осознанно пустой),
кадры дольше `--max` (по умолчанию 7 секунд, для вертикали ставь 3),
источник из списка и что таймкоды идут встык. Код выхода 1 при
нарушениях. Пример таблицы: `examples/shotlist-example.md`.

Скрипт ловит арифметику и пропуски. Ритм, смысл и «работает ли хук»
проверяешь глазами.

## Типичные ошибки

- **Таймкоды руками без пересчёта.** Вставили кадр в середину, хвост
  сдвинулся, а таймкоды остались старые. Монтажёр режет не туда.
- **Текст длиннее ролика.** Таблица сходится по кадрам, а закадр в эти
  секунды не влезает. Сначала хронометраж текста, потом кадры.
- **Источник «найдём».** Кадр без источника на съёмке превращается в
  «потом сгенерим», а потом не совпадает по луку с соседями.
- **Все генерации в разных стилях.** Один пресет лука на проект, иначе
  перебивки выпадают из ролика.
- **Графика вместо кадра.** Три плашки подряд, потому что «пусто». Пусто
  значит не придумали кадр.
- **Цифра из головы в сценарии.** Попадает на плашку крупно и становится
  обещанием клиента, которого он не давал.

## Связи с другими скиллами набора

- `ai-video-concept`: таблица входит в синопсис и препродакшн-пакет.
- `archive-footage`: поиск кадров с источником `архив` и журнал лицензий.
- `film-look`: лук для всех кадров с источником `генерация`.

## Что устаревает первым

Темп смены плана на площадках и безопасные зоны интерфейса в вертикали
меняются вместе с самими площадками. Правила разбивки устаревают
медленно. Проверено на октябрь 2026.

## Глубже

Полные шаблоны раскадровки, разборы реальных роликов и настройку под
команду студия AIVFX показывает в работе и в обучении: https://aivfx.ru.