beat-sync-video-editing — скилл для Claude Code: монтаж видео
Скилл собирает монтаж под ритм трека: выбирает куски видео, режет их по битам и рендерит результат через FFmpeg.
npx skills add ecliptic-ai/skills --skill beat-sync-video-editing -a claude-codeЧто делает beat-sync-video-editing
Скилл описывает формат EditPlan — JSON, где указано, с какой секунды брать аудио и какие фрагменты видео куда поставить. Длительности клипов в секундах, начало — строками MM:SS. Сумма длительностей должна совпадать с длительностью аудио, допуск 0.5 с. Порядок клипов задаётся намеренно и не обязан быть хронологическим.
Работа идёт в четыре шага. Сначала скрипт gemini-edit-plan.sh отправляет видео и аудио в Gemini, и модель смотрит картинку и слушает трек одновременно. Потом validate-plan.sh проверяет план, build-filter.sh собирает строку для -filter_complex, а финальный рендер делает сам FFmpeg с libx264 и aac. Для первого шага нужен GEMINI_API_KEY, а ещё curl и jq в системе. Форматы видео и аудио ограничены списком, который принимает Interactions API: mkv туда не входит, поэтому его придётся перегнать заранее.
Загруженные файлы скрипт по умолчанию оставляет на 48 часов, чтобы следующие запуски не тратили время на повторную загрузку. Строку ECLIPTIC_FILES с именами и URI он печатает в stderr — потеряете её, и придётся смотреть список через list-gemini-files.sh. Модель по умолчанию gemini-3.6-flash, менять её можно переменной GEMINI_MODEL.
Какие задачи решает
- нарезать клипы так, чтобы склейки попадали в биты трека
- собрать JSON-план монтажа из исходного видео и песни
- проверить план до рендера и поймать несовпадение длительностей
- получить готовую строку
-filter_complexдля FFmpeg - переиспользовать уже загруженные в Gemini файлы между запусками
Примеры запросов агенту
- сделай монтаж под этот трек, склейки по битам
- проверь мой EditPlan на ошибки
- собери фильтр FFmpeg из этого плана и отрендери видео
Как установить beat-sync-video-editing
1Через Skills CLI (Vercel)
npx skills add ecliptic-ai/skills --skill beat-sync-video-editing -a claude-code2Вручную: положить файлы
~/.claude/skills/beat-sync-video-editing/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/beat-sync-video-editing/
1Через Skills CLI (Vercel)
npx skills add ecliptic-ai/skills --skill beat-sync-video-editing -a codex2Вручную: положить файлы
.agents/skills/beat-sync-video-editing/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ecliptic-ai/skills --skill beat-sync-video-editing -a cursor2Вручную: положить файлы
.cursor/skills/beat-sync-video-editing/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ecliptic-ai/skills beat-sync-video-editing2Вручную: положить файлы
.github/skills/beat-sync-video-editing/SKILL.md1Через Skills CLI (Vercel)
npx skills add ecliptic-ai/skills --skill beat-sync-video-editing -a gemini-cli2Командой платформы
gemini skills install https://github.com/ecliptic-ai/skills --path plugins/ecliptic/skills/beat-sync-video-editingВручную: положить файлы
.devin/skills/beat-sync-video-editing/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ecliptic-ai/skills --skill beat-sync-video-editing -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о beat-sync-video-editing
Как установить beat-sync-video-editing в Claude?
Выполните npx skills add ecliptic-ai/skills --skill beat-sync-video-editing -a claude-code. После этого файл скилла лежит в ~/.claude/skills/beat-sync-video-editing/SKILL.md.
Что делает beat-sync-video-editing?
Помогает смонтировать видео под музыку: агент строит EditPlan с таймингами клипов, проверяет его, собирает фильтр FFmpeg и рендерит результат.
Что нужно для работы скилла?
Ключ GEMINI_API_KEY, утилиты curl и jq, а также сам FFmpeg для финального рендера. Видео в mkv придётся заранее перекодировать — этот формат Interactions API не принимает.
