video-shotcraft — скилл Claude Code и Codex, который снимает промо-ролики продукта кодом на Remotion
📂 Исходный код на GitHubСкилл для Claude Code и Codex: агент скриншотит реальные страницы продукта, собирает сториборд из карточек-рецептов движения, анимирует фильм в Remotion, подгоняет монтаж под бит музыки и добавляет звук — на выходе MP4 и редактируемый проект.
video-shotcraft — скилл Claude Code и Codex, который снимает промо-ролики продукта кодом на Remotion
video-shotcraft — скилл для Claude Code и Codex от автора Vincent Wei. Вы говорите агенту «сделай промо для моего продукта» — и он сам делает скриншоты ваших реальных страниц, собирает сториборд из библиотеки готовых шотов, анимирует фильм в Remotion, подгоняет монтаж под бит музыки, добавляет звук, проверяет каждый кадр и отдает готовый MP4. Проект собрал около 19,6 тыс. звёзд на GitHub и распространяется по лицензии Apache-2.0. У документа есть и русская версия.
Это не видеогенератор
Ключевая идея проекта: ни один кадр не рисуется нейросетью. Каждый кадр рисуется кодом из ваших скриншотов и текстов. Отсюда три следствия:
- картинка всегда резкая и в фирменном стиле продукта;
- ничего не «галлюцинирует»: в ролике ровно то, что на ваших страницах;
- результат полностью редактируемый — у вас остаются исходники фильма.
Как проходит производство
Конвейер задан в SKILL.md — это точка входа скилла, которую читает агент. Полный производственный процесс описан в references/pipeline.md.
- Агент делает скриншоты ваших реальных страниц.
- Подбирает шоты — короткие фрагменты с одним анимационным приёмом — из библиотеки готовых рецептов.
- Собирает сториборд фильма.
- Анимирует каждую сцену в Remotion: каждый кадр там описан React-компонентом.
- Режет монтаж под бит фонового трека и добавляет саунд-дизайн.
- Проверяет каждый кадр и отдает готовый MP4.
Библиотека шотов
Ядро скилла — 124 карточки-рецепта в 10 категориях, всего 150 шотов. Каждая карточка лежит в references/shots/<category>/<card>.md, а её реализация на Remotion — в demos/<category>/<card>/. Инструкции по подключению готового шота к своему проекту — в demos/README.md. Смотреть и выбирать карточки удобно в Галерее.
| Категория | Шотов | Пример из библиотеки |
|---|---|---|
| Opening & Brand | 11 | text-as-mask: продукт виден сквозь гигантские буквы заголовка |
| Camera | 13 | exploded-view: страница наклоняется в 3D и разлетается на части |
| Transitions | 19 | card-flock-tumble: стая карточек превращается в заголовок |
| Typography | 25 | flying-words: туннель из слов складывается в лозунг |
| UI Entrance | 22 | card-stack: веер карточек раскладывается на экране |
| Interaction | 13 | palette-theme-ripple: смена темы волной проходит по интерфейсу |
| Data | 9 | axis-rescale-shock: всплеск на графике ломает ось |
| Light & Emphasis | 23 | spotlight-sweep: прожектор находит заголовок |
| Rhythm | 8 | paparazzi-flash: три вспышки, три кадра, одна цифра |
| Outro | 7 | input-morph-assemble: строка чата собирается в логотип |
Установка
Проще всего просто дать агенту ссылку:
Install this skill for me: https://github.com/Vincentwei1021/video-shotcraft
Либо поставить через CLI skills.sh:
npx skills add Vincentwei1021/video-shotcraft
Либо вручную склонировать репозиторий и сделать симлинк в папку скиллов:
git clone https://github.com/Vincentwei1021/video-shotcraft.git
cd video-shotcraft
ln -s "$(pwd)" ~/.claude/skills/video-shotcraft # Claude Code
ln -s "$(pwd)" ~/.codex/skills/video-shotcraft # Codex
Из материкового Китая, если GitHub работает медленно, автор советует клонировать зеркало с AtomGit: git clone https://atomgit.com/VincentWei/video-shotcraft.git.
Как пользоваться
Никаких команд запоминать не нужно — просто опишите фильм обычными словами:
| Фраза | Что сделает агент |
|---|---|
| «Сделай промо для моего продукта с video-shotcraft» | предложит шаблон Ink Press, спросит разрешение, снимет страницы и соберет фильм |
| «Сделай лаунч-ролик для этого репозитория на шаблоне Ink Press» | самый быстрый путь: ваши скриншоты, тексты и логотип ложатся в проверенный шаблон |
| «Покажи эту фишку через шоты deck-deal-flyin и row-embed» | вы сами выбираете шоты по именам — имена копируются из Галереи |
| «Сделай крупный план продукта по мотивам spotlight-hero-card» | один шот, адаптированный под ваш продукт |
Motion Workbench — редактор после сдачи
После сдачи фильма скилл открывает в браузере редактор в стиле CapCut: node workbench/scripts/open.mjs <project>. Фильм раскладывается на дорожки шотов, переходов, титров и звуковых эффектов — ровно так, как он собран. Внутри можно править текст, размеры шрифтов и цвета любого шота, двигать и подрезать клипы, менять скорость, перетаскивать новые шоты из той же библиотеки и экспортировать результат через Remotion. Превью и финальный рендер совпадают покадрово. Подробный гайд по Workbench написан на китайском, а контракт интеграции описан в references/workbench.md.
Что вы получаете
| Результат | Детали |
|---|---|
| Готовый фильм | MP4, 1920×1080, 30 fps, h264, с музыкой и саунд-дизайном |
| Проект Remotion | Полные исходники фильма: каждый шот — React-компонент, который можно менять |
| Motion Workbench | Открывается после сдачи: дорожки, инспектор, замена шотов, экспорт |
| Черновик JianYing | Опционально: редактируемый проект в JianYing (CapCut CN) с клипами, титрами и аудиодорожками |
| Публикация в соцсети | Опционально, по запросу: публикация через Upload-Post в TikTok, Instagram, YouTube, LinkedIn, X и другие |
В комплекте также идут переиспользуемые Remotion-компоненты (2.5D-камера страницы, титры, флеш-склейки, счетчики цифр), инструменты поиска и загрузки звуков с Freesound, 5 фоновых треков, скрипты снятия скриншотов страниц и сам производственный метод — от визуального направления до финальной проверки (references/).
Экспорт в JianYing описан в references/jianying-export.md (проверено на JianYing Pro 11.2 для macOS), публикация в соцсети — в references/publish-upload-post.md, критерии визуальной проверки — в references/aesthetic-rules.md.
Что нужно для работы
| Зависимость | Зачем |
|---|---|
| Node.js и npm | рендер Remotion, шаблон и Workbench |
| ffmpeg / ffprobe | покадровые проверки и финальный контроль качества |
| uv | только для разбора бита фонового трека (разовый Python-скрипт) |
| puppeteer | только для снятия скриншотов; ставится по требованию |
Remotion при первом рендере сам скачивает headless Chrome. Автор тестировал скилл на macOS; для headless Linux и CI в репозитории есть заметки: на машинах с малым числом ядер нужен флаг --concurrency=1, вместо полноценного Chrome понадобится бинарник chrome-headless-shell, а при недоступности CDN Remotion путь к локальному бинарнику задается через --browser-executable.
Про звуки и лицензии
Звуковые эффекты скилл берет прямо с Freesound и скачивает в проект каждого видео. Гайд по подбору звуков описывает поиск, фильтрацию по лицензиям CC0 и CC BY, загрузку превью и ведение манифеста с указанием авторов. Общий набор звуков убран — вместо него своя библиотека собирается под каждый проект.
Лицензии:
- код и документация — Apache-2.0;
- аудио с Freesound — каждый файл под своей записанной лицензией, для CC BY нужно сохранить манифест и указать авторов;
- у Remotion своя лицензия: бесплатно для частных лиц и небольших команд, компаниям может понадобиться платная лицензия.
Рецепты движения автор собирал, изучая язык официальных промо-роликов ClickUp, Perplexity, Slack, Notion, Figma, Framer, Raycast, Pitch, Miro и других: техники (тайминг, смягчение движения, хореография) переосмыслены с нуля, никаких кусков чужого видео или брендовых материалов в библиотеке нет.
Чем это интересно
video-shotcraft — пример еще одного жанра агентских скиллов: не «сделай текст» и не «сделай картинку», а полноценное производство видео по методу из реальной индустрии — со сторибордом, бит-синхронизацией, саунд-дизайном и покадровой проверкой. У автора есть и проект-сосед video-talkcraft для говорящих роликов: на входе сценарий и закадровый голос, и каждое движение кадра привязано к голосу. А сама библиотека, как пишет автор, собрана и проверена тем же конвейером, который скилл и учит — в Claude Code.