agentleFS
mcdenil-skillsmcdenil-skills/AutoMontage-Agent/.agents/skills/motion-reel/SKILL.md

motion-reel

Skill9 starsChanged 25 days agoMITView on GitHub

Создаёт анимационный Reels/Shorts без камеры из темы, сценария или готовой озвучки в AutoMontage-Agent: script, выбор аудио, таймкоды, motion brief, настоящий preview, явное утверждение, MotionReel final и QA. Используй для «ролик без камеры», «анимационный рилс», «кинетический текст», «motion-reel» и «видео из озвучки»; в новом чате предлагает готовый стиль, уникальный Creative Motion или работу по референсу.

  • Reads credentials

14 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

Анимационный ролик без камеры

Тема → script → выбор озвучки → таймкоды → motion brief → preview → явное утверждение → final → QA. Планирование выполняй в текущей подписке Claude Code/Codex. Отдельные OpenAI/Anthropic API для сценария, режиссуры или монтажа не нужны.

Сначала покажи выбор монтажа

Прочитай reel-turnkey/references/creative-motion.md. Прочитай reel-turnkey/references/motion-craft.md – числа и запреты движения. Если пользователь ещё не выбрал маршрут, сразу покажи карточку «Что делаем?» (вопрос «Как монтируем?») только с неясными вопросами: формат (вертикаль 9:16 или горизонталь 16:9 – --aspect horizontal) и способ монтажа – уникальный Creative Motion (рекомендуется), Creative Motion + оверлеи Higgsfield (смета и «да» до генерации), готовый установленный стиль или «Решай сам». При явном выборе не спрашивай снова; «реши сам» означает Creative Motion. После выбора автономно реши типографику, палитру, композиции, B-roll, музыку и тайминги, а пользователю покажи один полный проверенный preview.

Границы

  • Используй отдельную композицию MotionReel и схему schema/motion-brief.schema.json. Исходник – аудио, без faceSrc, подставного видео и требования показывать спикера в хуке.
  • Готовый маршрут использует восемь сцен: kinetic-title, card, steps, list, counter, media, cta, chart и публичную тему motion-neutral; стандарт – вертикаль 1080×1920, 30 FPS. Горизонтальный ролик 16:9 (1920×1080) – по явной просьбе: automontage motion <аудио> --project <имя> --aspect horizontal (с --brief/--script флаг отклоняется); все восемь сцен имеют свою горизонтальную раскладку, output.aspect: "horizontal" в ТЗ. Формат выбирай один раз в начале: вертикаль и горизонталь не смешиваются в одном ролике.
  • Creative Motion создаёт новый арт-дирекшн и project-local полноразмерный motion-слой внутри projects/<id>/motion-vNN/. После официальной нормализации он подключается как проверенная media-сцена с audioMode: mute по умолчанию (эффекты в слое – только по просьбе пользователя, тогда mix); narration остаётся мастер-аудио. Общий движок не меняется.
  • Все материалы ролика сохраняй внутри игнорируемой projects/<id>/. Не меняй движок, общие сцены и тему ради одного клиента. Не публикуй его текст, голос, медиа или рендеры.
  • Расписание, очереди и автопубликация – будущий отдельный слой. Этот движок отдаёт локальный MP4; не обещай фоновый выпуск роликов и не подключай аккаунты площадок.
  • Полные рендеры в одном checkout запускай последовательно.

1. Прими тему и подготовь script

Прочитай AGENTS.md, доступную локальную память и состояние Git. Проверь окружение через automontage doctor. Для проверки установки без ключей и Whisper используй automontage demo --motion: он создаёт только draft с тестовыми тонами, не речь. Первичная установка зависимостей и Remotion browser может потребовать интернет; подготовленное демо рендерится офлайн. Повторная команда не перезаписывает существующую папку.

Если маршрут ещё не выбран, покажи стартовую карточку до подготовки script. После выбора не задавай вопросы о вкусовых деталях, которые можешь решить самостоятельно; вынеси их в полный preview. До него допустим максимум один действительно блокирующий вопрос о смысле, правах или CTA.

Извлеки цель, аудиторию, главную мысль, длину, обязательные факты и CTA. Напиши короткий script из одного тезиса на сцену; сохрани его локально. Факты, числа и цитаты бери из материалов пользователя или проверенных источников. Покажи неподтверждённые формулировки как предложения, не выдавай выдуманные достижения за факты. Покажи текст до записи/платной генерации голоса.

2. Выбери озвучку

По умолчанию используй готовый MP3/WAV/M4A или запись пользователя. Если аудио ещё нет, сначала подготовь script; не подменяй человеческую озвучку тестовыми тонами демо.

automontage motion narration.wav --project "Название ролика"

Команда копирует аудио в новый workspace, получает таймкоды через локальный faster-whisper и создаёт односценовый draft scaffold. Это заготовка, её нужно превратить в смысловой план. Whisper при первом запуске может скачать модель. Если установка/модель отсутствует, помоги доустановить её; не запрашивай OpenAI API. Если распознавание прервалось после создания проекта, исправь причину и продолжи automontage motion --project-dir projects/<id>.

Необязательная ElevenLabs-озвучка

Это отдельный платный API: до вызова покажи точный script и выбранный голос, объясни, что текст будет отправлен ElevenLabs, а стоимость зависит от аккаунта провайдера. Получи явное согласие на передачу текста и расходы. Наличие ключа не означает согласия. Не обещай бесплатную генерацию и не повторяй запрос ради проверки.

Ключ ELEVENLABS_API_KEY и приватный ELEVENLABS_VOICE_ID пользователь задаёт локально в environment или .env. В репозитории нет ID голоса по умолчанию. Не проси ключ в чат, не показывай его/ID в логах, props, manifest или браузере.

Только после согласия (ID может быть задан приватной переменной):

automontage motion --script script.txt --voice elevenlabs \
  --project "Название ролика" --accept-provider-cost

--voice-id <voice-id> – необязательное явное переопределение приватного ID. API возвращает аудио и alignment; они превращаются в таймкоды слов без повторного Whisper. Результаты и кэш живут только в игнорируемом workspace. Ключ кэша учитывает script, voice ID, модель, настройки голоса и формат. Отсутствующие ключ/ID/согласие блокируют запрос.

Timeout, разрыв ответа или неоднозначный сбой не повторяются автоматически: запрос мог уже стоить денег. Сохрани workspace и журнал попытки, проверь состояние у провайдера с пользователем; не удаляй attempt.json, не обходи блокировку новым проектом. Повреждённый кэш требует разбора, а не новой оплаты. При отсутствии согласия продолжи с готовым локальным аудио.

Музыкальный ролик без речи

Промо, трейлер или ролик из AI-кадров под музыку без голоса собирай флагом --music-only:

automontage motion soundtrack.wav --project "Название ролика" --music-only
automontage motion --project-dir projects/<id> --music-only

Вторая команда продолжает уже созданный проект, например после ошибки «narration transcript is empty» (CLI сам печатает её с путём проекта) или после сбоя Whisper, который не успел записать transcript/words.json. Проект, где в транскрипте уже есть речь, флаг не переделывает: ответ --music-only refuses a project whose transcript already has speech; use the narration path. Флаг нельзя сочетать с --model, --brief, --version-label, --script, --voice, --voice-id, --accept-provider-cost. Правила для такого ролика:

  • источник – готовый сведённый саундтрек (музыка, удары, свуши), он и есть мастер-аудио; файл остаётся input/narration.<ext>, а в brief стоит audioRole: "music";
  • Whisper не запускается, transcript/words.json – пустой []; тайминги сцен ставь по долям и акцентам трека, края – по кадрам FPS brief;
  • блок music в brief запрещён: дополнительную музыку сведи в сам исходник;
  • экранный текст – только утверждённый пользователем текст, не выдумывай слоганы и цифры;
  • разрешён project-local Remotion-пакет из projects/<id>/motion-vNN/: рендер с withAudio=false ровно на durationInFrames brief, подключение одной полноразмерной media-сценой (start 0, end = длительность, fit: cover, audioMode: mute, frame: "full" – клип на весь кадр без рамки и зума сцены) через publishBriefRevision. Технику preview (чёрные провалы, громкость, 48 кГц, кадр) проверяет автоматический барьер motion-preview (D-049); остальной QA пакета – ручной: полный просмотр, safe zones, текст, синхронизация с треком;
  • слой motion-kit (automontage layer) медиа-сценой по-прежнему не ставь.

Дальше обычный путь: preview (с автоматическим барьером) → ручной QA → явное «утверждаю» пользователя → approve-brief --confirm-preview-viewed → final. Генерацию AI-кадров, бюджет и provenance ведёт навык ai-promo.

3. Подготовь timed motion brief

Прочитай transcript/words.json, сверь script и фактическую речь, длительность и конец слов. Есть призыв с кодовым словом или в личку – запиши обещание по разделу «Обещание в ролике» навыка skills/lead-magnet/SKILL.md после этой сверки или утверждения сценария для аватара. Озвучка – источник времени. Создай полный пакет по reference: сцены, экранный текст, события анимации, выбранные локальные media и музыкальные решения. Публикуй новую Markdown+JSON draft-ревизию через publishBriefRevision; не переписывай историю.

Тайминги start/end – глобальные секунды от начала аудио, без пересечений и за границами длительности; каждый край совпадает с кадром FPS brief. Планируй событие примерно раз в 1,5–2,2 секунды, используя готовые reveal-анимации (в горизонтали 16:9 ритм держат сцены и анимация; если под ними спикер – его план не меняется чаще раза в 8 с, гейт G17). Не добавляй выдуманные timing/CSS/JS-поля. Длинную мысль разбивай на сцены. steps показывает узел → соединитель → следующий узел. counter заканчивается на проверенном числе; обычная полоса субтитров выключена, необязательный caption используй только когда он помогает чтению.

Переходы между сценами задаёт необязательное поле сцены transition (cut по умолчанию, fade, slide, wipe, push; поля и числа – в reference, правила – в motion-craft.md): только на смене мысли, один «большой» переход (push) на ролик, у первой сцены перехода нет.

Проверенные фото/видео и музыка должны лежать локально внутри workspace и иметь SHA-256. Remote URL и неподтверждённый файл не подставляй в brief. Для видео явно выбери trim и звук: mute по умолчанию, mix или replace только по смыслу. Motion Review сейчас только для просмотра; его lesson-инструменты правок и Pexels-полка для этого режима недоступны.

В Creative Motion дополнительно создай ДНК дизайна, 6–10 разных визуальных конструкций для ролика на 2–3 минуты и anti-template карту по shared reference. Не повторяй одну композицию, не ставь одинаковые motion-механики рядом, используй современную гарнитуру с кириллицей, реальные экраны/логотипы и поэтапно строящиеся схемы. Project-local слой должен сохранять глобальный таймкод narration и по умолчанию не содержать собственного звука (эффекты – только по просьбе пользователя, тогда mix).

4. Покажи настоящий preview

Во всех примерах <id> и vNN замени фактическими путями последней ревизии из project.json. Команды node scripts/... выполняй из корня движка.

Цикл критика (до рендера preview). Кадры рисуются прямо из композиции черновика ТЗ, без рендера видео: automontage layer sheet --mode moments --project-dir projects/<id> кладёт кадры ключевых моментов, лист и телефонный лист в qa/moments-stills-*. Запусти субагента motion-critic (в Codex – отдельного агента с заданием из motion-critic.md); передай ему путь к свежему qa/moments-stills-<sha8>.json, который напечатал layer sheet, и номер круга. Он только читает кадры и отвечает JSON-отчётом. Сохрани ответ в файл и прогони automontage critic --project-dir projects/<id> --report <файл.json>: команда сверяет отчёт с последними кадрами и текущим ТЗ и печатает решение. При fix («Решение: исправлять») исправь три названные худшие сцены новой draft-ревизией ТЗ и снова нарисуй кадры → критик (не больше трёх кругов). Внутри цикла только кадры: рендер видео внутри цикла запрещён (automontage preview до решения критика не запускай). При stop («Решение: остановиться») собери preview: он рендерится один раз после stop. В сообщении пользователю назови оценки и причину остановки.

automontage preview --project-dir projects/<id> --brief brief/vNN-draft.motion.json
node scripts/qa-preview.js --project-dir projects/<id>
automontage review --project-dir projects/<id>

Preview проходит через настоящий MotionReel и сохраняется только в previews/. Полный 1080p preview собирается в качестве финала без вшитой надписи – ЧЕРНОВИК рисует плеер пульта, пока brief не утверждён; фрагмент и 4K содержат watermark ЧЕРНОВИК в кадре. Перед публикацией его меряет автоматический барьер motion-preview (docs/MOTION-KIT.md, D-049): чёрные провалы между сценами, громкость −14 ± 1 LUFS и true peak ≤ −1,5 dBTP (на полном preview), одна дорожка 48 кГц, размер и FPS кадра. При ❌ preview не публикуется, прошлый остаётся, причина и способ исправления – в qa/motion-preview-full.json: исправь и собери preview заново, обхода нет. Посмотри полный ролик, начало, steps, плотный текст, counter, media и CTA; проверь читаемость, safe zones, звуковую синхронизацию, паузы и отсутствие обрезанных слов. Для Creative Motion также проверь отсутствие повторяющихся композиций, пустых чёрных переходов, обрезанных скриншотов и случайного системного шрифта. Покажи пользователю полный preview и соответствующий пакет ТЗ. Успешный QA, Save и просмотр не являются утверждением. После правки создай новый draft и новый полный preview.

5. Явное утверждение, final и QA

Утверждение чистого полного preview сразу даёт финал копированием (DECISIONS.md D-051): пульт и approve-brief.js кладут просмотренный файл в final/<slug>.mp4, final QA идёт в фоне (строка «Проверка финала…» во входящих). Тогда команду final ниже не запускай – проверь сам финал.

Если пользователь нажал «Утверждаю» в пульте, а в automontage inbox строка «Утверждено» (фрагмент, 4K, preview прежней версии движка), approveBrief уже выполнен и brief/vNN-approved.motion.json создан – сразу собирай final:

automontage motion --project-dir projects/<id> --brief brief/vNN-approved.motion.json --version-label reviewed

При явном «утверждаю» в чате – только после однозначного утверждения пользователем именно показанной версии и подтверждения полного просмотра – сначала утверди brief, затем та же команда final:

node scripts/project/approve-brief.js projects/<id> brief/vNN-draft.motion.json --confirm-preview-viewed
automontage motion --project-dir projects/<id> --brief brief/vNN-approved.motion.json --version-label reviewed

Если approve-brief.js напечатал final: …, вторую команду не выполняй: финал уже готов.

После финала и QA всегда предложи чистку этого ролика: automontage clean --project <id> --level archive без --yes – покажи ГБ и список файлов (строка «Можно освободить N ГБ: …» после финала – та же подсказка). Удаляй командой с --yes только после явного «да» пользователя в чате; без «да» ничего не удаляй.

Approval связывает hashes draft, preview и narration. Только текущая зарегистрированная approved-копия может попасть в renders/ и final/; receipt нельзя составлять вручную. Изменение script/аудио/таймингов/темы/сцен требует нового draft, preview и утверждения. Уже утверждённые JSON bytes не редактируй, даже ради форматирования.

Движок проверяет полный decode и геометрию/FPS/длительность до публикации final. Дополнительно посмотри и прослушай весь итог, проверь H.264/AAC, один выходной аудиопоток, громкость, синхронизацию начала/середины/конца и отсутствие watermark. При music проверь ducking: речь должна быть понятна. Технический PASS не заменяет визуальную и звуковую проверку. При сбое сохраняется предыдущий final; устрани причину, не выдавай failed-версию за готовую. Отдай ссылку на локальный файл из manifest.final (обычно final/<slug>.mp4), длительность и краткий QA-итог.

Motion-слой из kit

Ролик только из озвучки без видео спикера собирается встроенным MotionReel, как раньше. Kit нужен, когда в кадре есть аватар или спикер: такой ролик веди по skills/reel-turnkey/SKILL.md и подключай слой через automontage layer brief. Не ставь слой kit media-сценой motion brief: preview motion-reel проходит только технический барьер motion-preview (D-049), а гейты L и G8 слоя kit – нет (D-038 в DECISIONS.md).

Пути – от корня движка; весь путь, команды и гейты – docs/MOTION-KIT.md.

Перед layer new всегда соберите master из подтверждённой черновой нарезки (по умолчанию рабочий 1080p): автор посмотрел её в пульте и нажал «Нарезка готова» или подтвердил словами в чате. Таймингов ещё нет – слой не создаём: пока нарезка ждёт автора, master и layer new отказывают. Master – один раз из оригинала: --edit edit/roughcut-vNN.json или копия edit/vNN-source.json с правками автора; порядок и поздняя оговорка после master (новый master и новый слой, полный круг) – skills/reel-turnkey/references/rough-cut.md. Вырезать нечего – в нарезке один кусок на всю запись по кадровым границам; «режь сам» до показа и аватар (нарезки нет) – свой список edit/v02-source.json. 4K/родной размер – только по явной просьбе пользователя через master --quality source. Далее берите активные source.localPath и transcript.words из project.json; при смене размера старый слой пересоберите, иначе G6 его остановит. Для ролика только из озвучки этот шаг не нужен: master и kit требуют видео.

  1. automontage layer new --project-dir projects/<папка> создаёт motion-vNN/. Субагенту слоя отдай одно задание: skills/reel-turnkey/references/motion-layer-brief.md с этой папкой.
  2. automontage layer check --project-dir projects/<папка> --layer motion-vNN – после каждой правки плана, за секунды: ритм, safe-zone, спикер в хуке, звуки, сток, чужое видео. Сток под вставку – automontage layer stock (без PEXELS_API_KEY клип кладут вручную).
  3. Цикл критика (до рендера preview). Кадры рисуются прямо из композиции слоя, без рендера видео: automontage layer sheet --mode moments --project-dir projects/<папка> --layer motion-vNN кладёт кадры ключевых моментов, лист и телефонный лист в qa/moments-stills-* (слой должен пройти layer check, иначе команда отказывает). Запусти субагента motion-critic (в Codex – отдельного агента с заданием из motion-critic.md); передай ему путь к свежему qa/moments-stills-<sha8>.json, который напечатал layer sheet, и номер круга. Он только читает кадры и отвечает JSON-отчётом. Сохрани ответ в файл и прогони automontage critic --project-dir projects/<папка> --report <файл.json>: команда сверяет отчёт с последними кадрами и печатает решение. При fix («Решение: исправлять») исправь три названные худшие сцены в плане слоя, затем снова layer check → layer sheet --mode moments → критик (не больше трёх кругов). Внутри цикла только кадры: рендер видео внутри цикла запрещён (ни layer render, ни automontage preview). При stop («Решение: остановиться») переходи к рендеру: preview рендерится один раз после stop. В сообщении пользователю назови оценки и причину остановки.
  4. automontage layer render – ждёт слот машинной очереди, проверяет длину слоя и голос в его звуке. Тяжёлые команды (layer render, layer import, preview, final и master) запускай в фоне; при ожидании смотри automontage queue. layer render --no-wait сразу отказывает, если очередь занята; это не обход ограничения.
  5. automontage layer import → automontage layer brief → automontage preview. Preview рендерится один раз после stop цикла критика; он проверяет баланс голоса и музыки; при стопе он не публикуется, в пульте остаётся прошлый.
  6. automontage layer sheet --project-dir projects/<папка> – контакт-лист текущего preview и кадры вокруг новых правок пульта к нему. Команда только предупреждает.

В пульт уходит только preview, у которого отчёты layer check, layer render и preview в qa/ без ❌. Каждое ⚠️ прочитай; исключения (waivers) – только с причиной.

Коридор G8 для аватара откалиброван по утверждённому эталону: под речью музыка примерно на 38 LU тише голоса, предупреждение вне 35–41 LU, стоп ниже 3 или выше 46 LU. layer brief --music <трек> по умолчанию собирает утверждённый рецепт (gainDb −16, ducking −40 dB, ratio 4), и он проходит G8. Попросили музыку слышнее – подними music.gainDb на 6–8 дБ: предупреждение G8 тогда ожидаемо. Против вкуса владельца музыку ради гейта не меняй: если G8 остановил preview, исправь микс по подсказке про music.gainDb или покажи число владельцу.

Правку из пульта вноси в тот же слой (новый слой – только при новом исходнике), затем снова layer check → цикл критика → layer render → layer import → layer brief → automontage preview и automontage inbox --accept. Утверждает только владелец: «Утверждаю» в пульте или «утверждаю» в чате.

Пульт роликов

  • В начале работы выполни automontage inbox и сначала обработай входящие этого ролика.
  • Создавая варианты одной темы (хуки, серию), положи в каждую папку pult-card.json с общим group и подписью variantLabel.
  • Показывая preview, напомни: его можно посмотреть и утвердить в «Пульте роликов» (automontage pult).
  • Выполненную правку из пульта отмечай: automontage inbox --accept <папка> <id> (имя папки без projects/).

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.