# music-to-video

Скилл music-to-video собирает из музыки beat-синхронизированное видео HyperFrames. Подходит для клипов с текстом, слайд-шоу и кинетической промо-графики.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 78316 у репозитория
- Автор: calesthio
- Лицензия: AGPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/calesthio/OpenMontage/tree/HEAD/.agents/skills/music-to-video/SKILL.md
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/music-to-video

## Что делает

Скилл принимает музыкальный файл или видео, из которого можно взять звук, и строит ролик вокруг трека. Анализатор один раз создаёт `audiomap.json`, оркестратор раскладывает материал по кадрам, а отдельный субагент собирает каждый кадр. Текст и шаблоны позволяют начать без собственных медиафайлов.

Рабочий процесс проходит через `hyperframes.json`, `STORYBOARD.md`, HTML-композиции в `compositions/frames/` и итоговый `renders/video.mp4`. Перед анализом нужны Python 3 и библиотеки `librosa`, `numpy`, `soundfile`. Без них скрипт анализа не запустится. Пользователь отдельно подтверждает план и рендер; изображения и видео можно добавить для нарезки по той же музыкальной сетке.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add calesthio/OpenMontage --skill music-to-video -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/music-to-video/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/music-to-video/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add calesthio/OpenMontage --skill music-to-video -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/music-to-video/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add calesthio/OpenMontage --skill music-to-video -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/music-to-video/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install calesthio/OpenMontage .agents/skills/music-to-video
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/music-to-video/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add calesthio/OpenMontage --skill music-to-video -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/calesthio/OpenMontage --path .agents/skills/music-to-video
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/music-to-video/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/calesthio/OpenMontage/tree/HEAD/.agents/skills/music-to-video/SKILL.md

## Когда брать
- собрать видео из музыкального трека
- синхронизировать смену кадров с музыкой
- разложить ролик по фазам энергии и паузам
- добавить изображения и видео на общую beat-сетку

## Примеры запросов агенту
- Собери из `assets/bgm.mp3` beat-синхронизированное видео с текстом.
- Проанализируй этот трек и подготовь `STORYBOARD.md` для спокойного ролика.
- Возьми мои изображения и встрои их в кадры по музыкальной сетке.

## Похожие
- [music-video-subtitle-generator](https://affpapa.org/nevibecode/skills/music-video-subtitle-generator.md) — скилл · 3700 установок
- [scenario-seedance-music-video](https://affpapa.org/nevibecode/skills/scenario-seedance-music-video.md) — скилл · 865 установок
- [general-video](https://affpapa.org/nevibecode/skills/general-video.md) — скилл · ★ 328 у репозитория
- [launch-video](https://affpapa.org/nevibecode/skills/launch-video.md) — скилл · 3400 установок
- [8-bit-orbit-video-template](https://affpapa.org/nevibecode/skills/8-bit-orbit-video-template.md) — скилл · 3100 установок
- [weread-year-in-review-video-template](https://affpapa.org/nevibecode/skills/weread-year-in-review-video-template.md) — скилл · 2600 установок

Из того же набора: [calesthio/openmontage](https://affpapa.org/nevibecode/by/calesthio/openmontage.md) — 101 карточка

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
