# vox-director

Скилл собирает ролик-объяснение или рекламу в стиле бумажного коллажа: сценарий, кадры-постеры, движение, озвучка, музыка и субтитры. Работает на Atlas Cloud API и локальном ffmpeg.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 2446
- Автор: Alisa0808
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/Alisa0808/vox-director/tree/HEAD/SKILL.md
- Обновлён: 2026-10-05
- HTML: https://affpapa.org/nevibecode/skills/vox-director

## Что делает

Скилл ведёт проект от одной темы до готового файла. Сначала он раскладывает тему на биты по выбранной драматургической дуге, потом генерирует по коллажному постеру на каждый бит, оживляет их через image-to-video, добавляет голос, музыку и подписи. Всё автоматизировано скриптами, состояние проекта живёт в одном `beats.json` под `out/<project>/`.

Внутри три режима входа: тема (B-roll), видео с говорящим человеком (A-roll) и одна фотография человека или продукта, встроенная в коллаж (C-roll). Есть отдельные скрипты: `style_bakeoff.py` для выбора визуального стиля, `keyframes.py` для постеров, `clips.py` для анимации. Стиль задаётся пресетами вроде `american-retro`, `punk-zine`, `soviet-constructivist` или собирается вручную из измерений промпта.

Перед запуском проверьте три вещи: переменную `ATLASCLOUD_API_KEY`, наличие `ffmpeg` и `ffprobe` в PATH и библиотеку Pillow для Python. Без ключа скилл останавливается сразу, так что это первое, что стоит завести. Два места требуют вашего решения: карта битов до генерации и выбор аспекта под конкретную видеомодель. Для реальных людей и логотипов брендов модели Omni и Seedance отказывают — там нужен `kwaivgi/kling-video-o3-pro/image-to-video`.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Alisa0808/vox-director --skill vox-director -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Alisa0808/vox-director --skill vox-director -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Alisa0808/vox-director --skill vox-director -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Alisa0808/vox-director vox-director
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Alisa0808/vox-director --skill vox-director -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/Alisa0808/vox-director
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add Alisa0808/vox-director --skill vox-director -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/Alisa0808/vox-director/tree/HEAD/SKILL.md

## Когда брать
- разложить тему на биты по подходящей драматургической дуге
- сгенерировать коллажный постер для каждого бита с заголовком внутри картинки
- оживить статичные постеры через image-to-video с разным движением камеры
- собрать озвучку, музыку и субтитры в один ролик
- встроить фото человека или продукта в коллаж без отказа видеомодели

## Примеры запросов агенту
- сделай vox-видео про историю метро, 60 секунд
- собери коллажную рекламу продукта из этого фото
- преврати эту тему в motion collage с озвучкой

## Похожие
- [videoagent-director](https://affpapa.org/nevibecode/skills/videoagent-director.md) — скилл · 540 установок
- [videoagent-video-studio](https://affpapa.org/nevibecode/skills/videoagent-video-studio.md) — скилл · 10500 установок
- [muapi-one-shot-video](https://affpapa.org/nevibecode/skills/muapi-one-shot-video.md) — скилл · 664 установки
- [layer-video](https://affpapa.org/nevibecode/skills/layer-video.md) — скилл · 3400 установок
- [scenario-wan](https://affpapa.org/nevibecode/skills/scenario-wan.md) — скилл · 370 установок
- [kling](https://affpapa.org/nevibecode/skills/kling.md) — скилл · 588 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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