music-mv — скилл

Скилл делает музыкальный клип под вашу песню: каждый кадр рисует код, а шесть шагов с паузами ведут от разбора трека до монтажа

  • 130 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Расширенный доступ

Почему такой уровень

  • Запускает скрипты анализа и рендера, при первом запуске скачивает рендерер и браузер, пишет файлы в рабочую папку проекта.
Все причины и проверки

win-hao/music-mv

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/music-mv

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Запускает скрипты анализа и рендера, при первом запуске скачивает рендерер и браузер, пишет файлы в рабочую папку проекта.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

music-mv — скилл и одновременно учебник по созданию клипа в коде. Видеомодель не нужна: агент рисует каждый кадр кодом и собирает ролик через HyperFrames и FFmpeg. Достаточно сказать агенту «сделай клип для song.mp3», и он пройдет шесть шагов: разберет песню, выберет стиль, нарисует героя, напишет сценарий и раскадровку, покажет черновик и лишь затем соберет весь клип, после просмотра внесет правки. На каждом ключевом шаге агент останавливается и ждет вашего одобрения. Доступны четыре стиля со своей техникой рисования: пиксельная игра, бумажный коллаж, восковые мелки и объемная книга из бумаги. Скрипты определяют темп, доли и сегменты песни, делают контактные листы для проверки и возвращают исходный звук в готовый ролик.

Для кого. Музыкантам и авторам коротких роликов, которым нужен клип под свою песню без видеогенерации и без монтажной программы.

Подходит, если

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

Не подходит, если

  • Нужна фотореалистичная съемка: результат собирается из кода и выглядит рисованным.
  • Нет `ffmpeg`, Node.js или Python: без них скрипты анализа и рендера не запускаются.
  • Слабая модель в агенте: автор отмечает, что чем сильнее модель, тем подробнее получается картинка.

Пример запроса к агенту

Сделай клип для song.mp3 в стиле бумажного коллажа: сначала разбери песню и покажи стиль и героя.

Ограничения

Документация написана по-китайски, а английская подпись есть только под названием. Нужны Python 3.9 и выше с библиотеками `numpy`, `librosa` и `Pillow`, `ffmpeg` и Node.js 18 и выше. Рендерер HyperFrames и браузер без интерфейса скачиваются при первом запуске. Для кадров в акварельном или восковом стиле в проект ставится `puppeteer-core`. Транскрипцию лирики можно сделать через Whisper либо подготовить файл `lyrics.srt` самому. Права на песню остаются у автора, в репозитории нет роликов со звуком. Последний коммит в репозитории датирован октябрем 2026 года.

Как отключить. Удалите установленную папку скилла из каталога скиллов агента, например `~/.claude/skills/music-mv`. Скачанные рендерер и Chrome HyperFrames удаляются отдельно, рабочие папки клипов тоже.

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

Какие шаги проходит агент?

Шесть: разбор песни, выбор стиля, рисунок героя, сценарий и раскадровка, черновик перед полной сборкой, просмотр и правки. На каждом важном шаге агент ждет вашего согласия.

Какие стили есть?

Пиксельная игра 320 на 180 с палитрой в 24 цвета, бумажный коллаж, восковые мелки на p5.brush и бумажная объемная книга со слоями и тенями.

Как проверить результат?

Скрипт `contact_sheet.py` собирает контактный лист кадров через заданный шаг, `video_rhythm.py` проверяет склейки, неподвижные куски и черные кадры, а `finalize_audio.py` возвращает исходный звук.

Работает ли без установки скилла?

Да. Вместо скилла можно использовать файл с обучением из репозитория и отправлять агенту промпты по частям.

С какими агентами работает?

С любым агентом, который читает и пишет файлы и запускает команды, в том числе Claude Code и Codex. Автор указывает, что сильные модели рисуют подробнее.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Четыре скилла делают из песни с текстом анимированный клип в стиле акварели: раскадровка, параллельные художники и рендер.

СкиллРасширенный доступ61Звезды репозитория

Скилл делает 20–60-секундный ролик из вашей озвучки и реальных материалов в выбранном стиле, MP4 собирается локально.

СкиллРасширенный доступ53Звезды репозитория

Скилл ведет агента через семь этапов для ролика на 15–90 секунд: скрипт проверяет каждый этап, следующий ждет

СкиллРасширенный доступ140Звезды репозитория

Скилл делает промо-видео из кода: режиссура, анимация в браузере с размытием движения, своя музыка и готовый MP4 в 60 кадров

ПлагинРасширенный доступ79Звезды репозитория

Скилл ведет Claude Code от песни и текста до готового лирик-клипа в духе Vocaloid с рендером кадров в браузере и ffmpeg.

СкиллРасширенный доступ271Звезды репозитория

Скилл Video by Reference учится стилю у ролика-образца и собирает из кода анимированный короткий фильм с оригинальным саундтреком

СкиллРасширенный доступ76Звезды репозитория

Коротко о README

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

Бейдж для README

Сообщить о проблеме