Communitygithub.com

shutckin/aivfx-content-kit

Runs a client AI video for a concept studio from brief to delivery. Takes the brief and real product photos, writes a synopsis, builds character and location sheets with 3 options each, a 16:9 approval deck, stills in waves, one prompt for the whole video, client revisions as a list, assembly and a delivery checklist. Core rule: the client approves the preproduction package before the first video frame, and the approved character and location sheets go as references into every generation. Use when a brief arrives for an advertising or product AI video. Triggers: 'client AI video', 'preproduction package', 'character sheet', 'location sheet'. Not for articles or covers (use blog-article and article-cover). Triggers (RU): «вот бриф», «новый клиент», «концепт студия», «препродакшн-пакет», «лист персонажа», «лист локации», «презентация клиенту», «правки от клиента», «готовим сдачу».

Qu'est-ce que aivfx-content-kit ?

aivfx-content-kit is a Claude Code agent skill that runs a client AI video for a concept studio from brief to delivery. Takes the brief and real product photos, writes a synopsis, builds character and location sheets with 3 options each, a 16:9 approval deck, stills in waves, one prompt for the whole video, client revisions as a list, assembly and a delivery checklist. Core rule: the client approves the preproduction package before the first video frame, and the approved character and location sheets go as references into every generation. Use when a brief arrives for an advertising or product AI video. Triggers: 'client AI video', 'preproduction package', 'character sheet', 'location sheet'. Not for articles or covers (use blog-article and article-cover). Triggers (RU): «вот бриф», «новый клиент», «концепт студия», «препродакшн-пакет», «лист персонажа», «лист локации», «презентация клиенту», «правки от клиента», «готовим сдачу».

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shutckin/aivfx-content-kit/tree/HEAD/skills/ai-video-concept

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Concept studio: клиентский AI-ролик от брифа до сдачи

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

Зачем

До первого кадра самого ролика собирается препродакшн-пакет: синопсис, лист персонажа, лист локации и презентация, и клиент его утверждает. Дальше утверждённые листы персонажа и локации подаются референсами в каждую генерацию, включая макро. Причина простая: без них модель каждый раз придумывает героя и комнату заново, лицо плывёт от кадра к кадру, кухня меняет мебель и окно, и первые волны кадров уходят в корзину целиком. Пакет собирается всегда, а не «если клиент попросит».

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

ИнструментЗачем здесьКто делает
Claude Code (или другой агент)ведёт папку проекта, пишет синопсис и промпты, разбирает правки, собирает презентацию, проверяет логи генерацийагент
Папка проектаinbox/ от клиента как есть, docs/ синопсис, презентация и журналы генераций, stills/r1, stills/r2 кадры по раундам плюс stills/preview*/ лёгкие JPG для телефона, videos/, final/агент
Seedream 5 Pro через Higgsfieldосновная модель для листов и кадров: одна модель на весь ролик держит картинку цельнойагент запускает после «да» владельца
Nano Banana Pro через Higgsfield в браузереправка готового кадра и прогон вариантов; на части тарифов агрегаторов в браузере без списания кредитов (проверь свой тариф); не для смешивания с другой моделью внутри одной сценыагент
Seedance через Higgsfieldвидео одним промптом на весь ролик, шоты с таймкодами внутри, весь батч утверждённых кадров разомагент
Klingальтернатива для видео, если Seedance не вытягивает конкретное движениеагент
Suno (или аналог)музыка, если она нужна по синопсисуагент пишет промпт, владелец слушает
HTML в PDF через headless Chromeпрезентация 16:9 с картинками, вшитыми в файлагент
DaVinci Resolve (или аналог)монтаж, звук, финальная сборкавладелец или монтажёр
motion-graphicsплашки, титры, финальная карточка поверх монтажаагент
film-lookодин лук хвостом каждого промптаагент
Клиентбриф, фото продукта, выбор вариантов, правкиклиент

Платные генерации запускаются только после «да» владельца проекта. Любая отправка клиенту (синопсис, презентация, мастер) уходит от человека и только по его прямому слову. Агент готовит и проверяет.

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

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

Покадровую таблицу детально делает shot-list, архивные кадры под текст ищет archive-footage, лук для всех генераций берётся из film-look, плашки и титры делает motion-graphics.

Этапы по порядку

0. Приём брифа -> 1. Синопсис в чат -> [ок] -> 2. Лист персонажа
-> 3. Лист локации -> 4. Презентация -> [согласование] -> 5. Статика
волнами -> 6. Видео -> 7. Правки клиента -> 8. Сборка и сдача

В квадратных скобках точки, где работа стоит, пока клиент не ответил. Состояние проекта веди в одном файле (status.md или project.json): текущий этап, что утверждено, что ждём. Новая сессия начинает с него.

Этап 0. Приём брифа

Всё от клиента клади в inbox/ как есть: голосовые, скрины переписки, документы, фото. Ничего не переписывай поверх оригинала. Опросник: templates/brief-questions.md.

До старта получить:

  • ТЗ или сценарий в любом виде, голосовые и скрины подходят;
  • реальные фото продукта в трёх ракурсах: фронтально, в три четверти (видна глубина) и с линейкой или предметом для масштаба. Все варианты упаковки, которые будут в кадре. Без фото не начинать;
  • видео-референсы, если есть;
  • хронометраж и площадка (отсюда соотношение сторон);
  • кто финально согласует и когда. Если согласует не тот, с кем идёт переписка, каждый круг правок приходит дважды.

Видео-референс разбери покадрово (контактный лист через ffmpeg, например tile=6x6) и опиши словами, что берёшь: ритм, свет, движение камеры, цвет. Это снимает половину недопонимания «я хотел как там».

Этап 1. Синопсис текстом в чат

Короткий docs/synopsis.md, клиенту уходит текстом в чат, а не документом: правка на этом этапе стоит дешевле всего. Состав:

  • логлайн: что зритель видит и что чувствует, 2-4 строки;
  • покадровая таблица с таймкодами (формат и проверка в shot-list);
  • механика переходов: как один шот переходит в другой, словами;
  • звук: музыка, голос, шумы, где входит музыка;
  • что изменено относительно ТЗ и почему, отдельным блоком.

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

Этап 2. Лист персонажа

Character reference sheet, 3 варианта с отличиями по лицу, причёске и одежде. Состав листа: templates/character-sheet.md. Эмоции и позы пишутся под сцены именно этого ролика: ест в кадре, значит в позах ложка.

  • Закладывай 2-3 итерации после первого выбора. Новые варианты одежды, своя модель клиента, длина волос: это норма, а не сбой.
  • Одежда на контраст с упаковкой. Герой в цвет продукта сливается с ним, и продукт теряется.
  • Для сцен вырежи из утверждённого листа крупный фронтальный портрет: на сетке лицо занимает пару процентов кадра и модель его не считывает. Лист остаётся для согласования, портрет идёт в генерации.

Этап 3. Лист локации

Location reference sheet, 3 варианта интерьера. Состав: templates/location-sheet.md. Главное: одна комната со всех сторон, по общему плану от каждой стены. Иначе на смене точки или облёте не окажется референса нужной стороны, и модель достроит свою.

Если ролик задуман одним проходом камеры, после листов сделай мастер-кадр сцены: герой уже в локации, предметы на местах, свет выставлен. 2-3 варианта по точке камеры, дальше каждый кадр генерится от утверждённого мастера.

Этап 4. Презентация

Горизонтальные слайды 16:9 в один PDF. Порядок, который работает:

обложка -> персонаж и локация (выбор из трёх) -> сцены по порядку с таймкодами -> перебивки -> финал -> план работ

Сборка: HTML с картинками, вшитыми в файл (base64), затем печать в PDF через headless Chrome. Вертикальные кадры в карточках показывай целиком (object-fit: contain на подложке), иначе они режутся в одинаковые полосы и выглядят как дубли. Шрифты обычный санс, цифры с tabular-nums, без моноширинных.

Перед отправкой проверь, что в презентации нет внутреннего: цен, бюджета, расхода кредитов, названий моделей, часов работы, внутренних ссылок и имён. Поиск по файлу словами «руб», «кредит», «бюджет», «час» и названиями моделей. Нашлось, значит переделать. Чек-лист пакета: templates/preprod-checklist.md.

Этап 5. Статика волнами

Только после утверждённого пакета. Порядок:

  1. база: «до», продукт, финал;
  2. «после» только i2i от утверждённого «до»: меняются поза, лицо, свет, остальное обязано совпасть, иначе приём не читается;
  3. макро и перебивки, тоже с листом локации.

Каждую волну показывай пронумерованными вариантами, чтобы ответ был одним словом. Новый раунд в новую папку (stills/r2), рядом лёгкие JPG-превью: крупные PNG до телефона не долетают.

Этап 6. Видео

Один промпт на весь ролик, шоты с таймкодами внутри, весь батч утверждённых кадров разом. Так цельнее, чем клеить отдельные клипы.

  • Шапка промпта: герой, локация, продукт, цветовая политика, звук, всё, что одинаково во всех шотах. Потом шоты с таймкодами и коротким заголовком-якорем у каждого («коробка», «саше», «финал»). Хвостом лук.
  • Не пиши «как на референсе 4»: картинки уходят в модель в произвольном порядке. Консистентность держит описание в шапке.
  • Начинай с самого рискованного места: переход, сложное движение, мелкий текст на продукте. Не выходит, меняй механику сцены (например, облёт камеры на перекрытие кадра предметом), а не подгоняй остальное.
  • Статичное макро замирает: в шапку строку о том, что в каждом шоте непрерывное движение. Финал замирает после жеста: продли действие.
  • Перед запуском выпиши список входящих кадров и пометь у каждого «ручная правка» или «генерация». Ручные правки (логотип, мелкий текст) храни отдельно и никогда не перезаписывай выводом модели.

Этап 7. Правки клиента

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

  1. Разбери в нумерованный список: номер, кадр, что поменять, цитата.
  2. Отправь список на подтверждение до работы: «правильно понял, вот 7 пунктов?». Переспросить дешевле, чем потерять пункт.
  3. Правку, которая противоречит утверждённому пакету, пометь отдельно: это новый круг, а не правка.
  4. Отчитывайся по тем же номерам: сделано, не сделано и почему.

Этап 8. Сборка

Монтаж, звук, плашки. Текст в генерацию не вшивается никогда: титры только на монтаже (motion-graphics), в кадрах оставлен воздух сверху.

Музыка, если нужна: входит после точки перелома, а не с первой секунды. Для Suno в стиле явный темп (BPM) и 3-5 конкретных технических признаков звука, коротко; структуру задают теги в поле текста. Длинный список прилагательных даёт перегруженный трек. Референс-трек клиента Suno не примет: разбери его темп и характер и переведи в промпт словами.

Что грузить в каждую генерацию

  • Портрет героя из утверждённого листа (не саму сетку).
  • Кадр или лист локации, включая макро-планы.
  • Реальное фото продукта или утверждённый эталон packshot.

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

Правило реального продукта. Упаковку по текстовому описанию не генерь: выйдет выдуманный продукт, и это отказ, а не правка. Форму словами не задать: «кубическая коробка» модель читает как «квадратная спереди». Нет фото нужного варианта (есть коробка, нет саше), сначала отдельный ровный packshot, его утверждают, потом сцены. Ориентацию упаковки держит референс, а не текст: фото под углом даст кувыркающуюся пачку. Капризный логотип вписывай режимом редактирования: сцена с пустым местом под продукт, затем отдельный прогон «положи этот packshot сюда, остальное не трогай». Мелкий продукт в общем плане модель додумывает: если он должен читаться, делай его крупнее и сюжетом кадра.

Лук. Ядро film-look хвостом каждого промпта. Тёплый грейд снимай в двух случаях: светлые интерьеры и предметка с фирменными цветами (утягивает в жёлтый монохром) и тёмная сцена с одной тёплой лампой (коричневое мыло). И ещё при холодном, монохромном или неоновом стиле. Соотношение сторон только параметром модели.

Референсы только PNG. В Higgsfield CLI загрузка JPEG падает с ошибкой подписи хранилища в логе, но сама команда ошибку не возвращает, и генерация молча уходит без референса. Конвертируй заранее (sips -s format png на macOS или любой конвертер) и после каждой пачки читай логи на строки с ошибками, а не проверяй наличие файла. Сбои связи с хранилищем лечатся повтором.

Где теряется время

  • Генерация без листов. Лицо и локация плывут, волну выкидывают целиком. Никаких сцен до утверждённых листов.
  • Одноимённые файлы. Из загрузок легко взять не тот кадр с похожим именем. Новая версия получает новое имя, перед подстановкой сверяй контрольную сумму (md5).
  • Забытая пересборка презентации. Картинки вшиты в HTML: поменял файл на диске, PDF соберётся со старой. Пересобирай при каждой смене.
  • Облёт камеры в статике. Модель картинок не понимает дугу: крутит героя на стуле, фон стоит. В статике задаётся то, что физически видно в кадре (какая стена за спиной, чьё плечо впереди). Движение камеры это задача видеомодели.
  • i2i от кадра со старой деталью. Длину волос и рукава так не поменять: картинка перебивает текст. Нужен референс, где деталь уже правильная, или генерация с нуля.
  • Материал названием. Название продукта модель трактует по-своему и рисует другой материал. Описывай физику поверхности (восковый, полупрозрачный, блик на гранях) и отдельно запрещай признаки чужого материала (пористость, корочка).

Чек-лист сдачи

  • Упаковка везде лицевой стороной, логотип не зеркальный, значки на месте, мелкий текст сверен с эталоном покадрово.
  • Продукт одинаковый во всех кадрах.
  • Герой с одним лицом во всех кадрах.
  • Свет меняется по драматургии, а не случайно.
  • Локация одна во всех кадрах, включая макро.
  • Текст на экране только на монтаже, в кадрах есть воздух.
  • Хронометраж и формат как в брифе, безопасные зоны площадки проверены.
  • Все пункты последнего списка правок закрыты.
  • Лёгкие превью для телефона лежат в stills/preview*/.

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

  • shot-list: покадровая таблица для синопсиса и её проверка.
  • film-look: один лук на все генерации проекта.
  • motion-graphics: плашки, титры, финальная карточка на сборке.
  • archive-footage: архивные кадры и журнал источников, если они есть.
  • youtube-thumbnail: превью, если ролик идёт и на канал.

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

Имена и версии моделей, какие форматы референсов принимает инструмент, тарифы и безлимиты агрегаторов. Порядок этапов и правила согласования устаревают медленно. Проверено на октябрь 2026.

Глубже

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

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

shutckin/aivfx-content-kit

Makes motion graphics on the HyperFrames engine (HTML scenes rendered to video) with an AIVFX studio layer: name lower thirds, chapters, numbers, Shorts and Reels hooks, end cards, titles. The brand (colors, fonts, motion, durations) lives in one file, the video is a brief of scene roles, motion is set in words, and the agent renders a draft over footage and a final ProRes 4444 with alpha. Gives timing rules, 9:16 and 16:9 safe zones, lint and black-frame checks, a delivery checklist and a brand file checker. Triggers: 'lower third', 'motion graphics', 'chapter card', 'shorts hook', 'end card', 'transparent overlay', 'brand kit for motion', 'HyperFrames'. Triggers (RU): «сделай плашку», «нижняя треть», «плашка с именем», «заставка», «глава», «титры», «хук для шортс», «финальная карточка», «моушен для ролика», «графика с альфой для монтажа», «заведи бренд для графики», «сделай на хайперфреймс».

shutckin/aivfx-content-kit

Packages YouTube videos and Shorts: a pack of 3-4 thumbnail variants of one idea for choice and A/B testing, title and thumbnail as one unit, one idea per image, face and emotion, a large object, text up to 3-4 words or none, readable on a small phone screen. Works from own frames and screenshots plus references, generates or refines the frame with models (Nano Banana, Seedream, GPT-Image, Higgsfield and others) with the film-look style and logos in one pass, keeps a consistent channel series, checks the file with a script (size, weight, name), reviews the small view by eye on a contact sheet and shows options to the owner before upload. Triggers: 'YouTube thumbnail', 'video packaging', 'thumbnail A/B test', 'Shorts cover', 'title and thumbnail'. Triggers (RU): «сделай превью», «обложку для ролика», «обложку для YouTube», «упакуй ролик», «варианты для A/B-теста», «заголовок и превью», «обложку для Shorts», «серия превью для канала».

Skills associés