Упаковка говорящей головы

01Как выглядит#

• Это роутер: агент выбирает одну-две трактовки из четырёх под ваш ролик.
• База — субтитры по словам, картинка в картинке, врезки, звуковые акценты, финальная проверка.
• Pop-out — вы «выпрыгиваете» из рамки: текст стоит за головой, голова поверх рамки (три слоя: подложка, текст, вырезанный спикер).
• Kinetic — субтитры гуляют по кадру по смыслу: снизу, сверху, по центру, в глубине.
• Editorial — тёплая журнальная гамма: слоновая кость, графит, терракота.
• По умолчанию база плюс kinetic-субтитры, остальное по запросу.

02Когда брать#

Что нужно на входе: Готовый MP4: селфи, интервью, фрагмент эфира, демонстрация сервиса. Присылаете в телеграм-бот или кладёте в папку.

03Как запустить#

Напишите агенту обычными словами или наберите команду. Например:

Или коротко: /reels-talking-head — агент сам задаст недостающие вопросы.

04Что происходит по шагам#

1. 1

   Видео в бот

   делаете вы

   Присылаете ролик в телеграм-бот. Приёмник складывает его в workspace/reels/_inbox/.

2. 2

   Расшифровка и трактовка

   вместе

   Агент расшифровывает речь по словам, группирует во фразы и предлагает трактовку: база, pop-out, kinetic или editorial.

3. 3

   Свои материалы

   делаете вы

   Агент спрашивает скриншоты, фото и ссылки для врезок. Ничего не прислали — врезки будут типографикой.

4. 4

   Композиция HyperFrames

   делает агент

   Собирает сцену по контракту talking-head-recut со своими правилами безопасных зон.

5. 5

   Контактный лист

   делаете вы

   До рендера показывает лист кадров: текст не на лице, врезки читаются, ничего не перекрывается.

6. 6

   Рендер и приёмка

   делает агент

   Рендерит MP4, отправляет в бот. Дальше по желанию подпись, гайд и воронка.

05Шаблоны файлов#

{
  "version": 3,
  "canvas": { "width": 1080, "height": 1920, "fps": 30 },
  "faceSafeZone": { "top": 560, "bottom": 1190 },
  "cta": "СЛОВО",
  "beats": [
    { "id": "hook",  "start": 0.0, "end": 3.4, "type": "hook", "text": "3 ВЕЩИ ПОСЛЕ РЕГИСТРАЦИИ" },
    { "id": "step1", "start": 3.6, "end": 11.5, "type": "panel", "title": "ШАГ 1",
      "rows": [ { "kind": "chips", "items": ["Настройки", "Профиль"] } ] },
    { "id": "step2", "start": 11.8, "end": 20.0, "type": "panel", "title": "ШАГ 2",
      "rows": [ { "kind": "toggle", "label": "Память", "on": 21.6 } ] },
    { "id": "stat",  "start": 20.1, "end": 27.0, "type": "panel",
      "rows": [ { "kind": "stat", "value": 12000, "label": "токенов" } ] },
    { "id": "cta",   "start": 31.5, "end": 35.0, "type": "cta", "text": "Пиши СЛОВО" }
  ]
}

06Команды движков#

Обычно их запускает агент. Пригодятся, если хотите повторить шаг сами или понять, что он делает.

node scripts/reel-inbox.mjs
python ~/.claude/skills/reels-overlay-steps/engine/transcribe_file.py <video> words.json
node scripts/shot-web.mjs <url> shot.png --w 1200 --h 900      # настоящий скриншот для врезки

pnpm dlx hyperframes check <папка>
pnpm dlx hyperframes snapshot <папка> --at <секунда>
pnpm dlx hyperframes remove-background ...    # вырезка спикера для pop-out, ~30 мин, запускать заранее
pnpm dlx hyperframes render <папка> -o output.mp4 --fps 30

07Грабли и правила#