К основному содержанию
скилл CX Codex

promo-director — скилл для Claude Code: видео для соцсетей из аудио

Скилл promo-director создаёт вертикальные видео 15 секунд для Instagram, TikTok и Twitter из готового трека. Берёт обложку альбома, выбирает самый энергичный фрагмент и накладывает визуализацию волны звука.

CC0-1.0 259 установок ★ 686 обновлён 2026-10-22

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add bitwize-music-studio/claude-ai-music-skills --skill promo-director -a claude-code
Открыть на GitHub

Что делает promo-director

Скилл генерирует видеоклипы размером 1080×1920 пикселей (формат 9:16) прямо после мастеринга. Вибирает из трека самую динамичную 15-секундную часть, накладывает на экран обложку альбома и анимированную волну звука в выбранном стиле — от минималистичной линии до сложной круговой визуализации. Цвета берёт из самой обложки, чтобы видео выглядело единообразно.

Для работы нужны FFmpeg с фильтрами showwaves, showfreqs, drawtext и gblur, а также Python-библиотеки Pillow, librosa и PyYAML. Без FFmpeg в системе скилл не запустится — это критическое требование. Может сгенерировать как отдельные видео для каждого трека, так и сборку «альбомный семплер» из кусочков всех композиций с кросс-фейдом.

Есть 9 готовых стилей визуализации: pulse (электроника), bars (поп и рок), line (акустика), mirror (амбиент), mountains (EDM), colorwave (инди), neon (синтвейв), dual (экспериментальная музыка) и circular (абстрактная). Скилл читает параметры из конфига ~/.bitwize-music/config.yaml и подсказывает, какой стиль лучше для жанра.

Какие задачи решает

  • Собрать 15-секундное видео для Reels из готового трека с визуализацией волны
  • Вывести обложку альбома поверх звуковой анимации с правильными цветами
  • Выбрать самый энергичный фрагмент трека вместо случайного начала
  • Создать альбомный семплер из всех композиций без превышения лимита Twitter (140 секунд)
  • Применить разные стили волн в зависимости от жанра музыки

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

  • Сгенерируй промо-видео для альбома sample-album в стиле pulse
  • Создай видеосемплер альбома с длительностью 12 секунд на трек
  • Сделай промо только для трека 01-intro.wav с нeon-визуализацией

Как установить promo-director

1Через Skills CLI (Vercel)

npx skills add bitwize-music-studio/claude-ai-music-skills --skill promo-director -a claude-code

2Вручную: положить файлы

~/.claude/skills/promo-director/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/promo-director/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о promo-director

Как установить promo-director в Claude Code?

Выполни команду npx skills add bitwize-music-studio/claude-ai-music-skills --skill promo-director -a claude-code, затем открой ~/.claude/skills/promo-director/SKILL.md. Для других платформ команда отличается: для Cursor — npx skills add bitwize-music-studio/claude-ai-music-skills --skill promo-director -a cursor, для GitHub Copilot — gh skill install bitwize-music-studio/claude-ai-music-skills promo-director.

Что нужно сделать перед тем, как использовать promo-director?

Установи FFmpeg (для macOS: brew install ffmpeg, для Linux: apt install ffmpeg) и убедись, что он содержит фильтры showwaves, showfreqs, drawtext и gblur. Установи Python-библиотеки: Pillow, librosa и PyYAML. Готовый трек (после мастеринга) и обложку альбома должны лежать в папке проекта.

Что произойдёт, если FFmpeg не установлен?

Скилл не запустится и вернёт ошибку. Нужно установить FFmpeg вручную: макрос: brew install ffmpeg, Linux: apt install ffmpeg. Это не опциональное требование, а обязательное.

Исходный текст

SKILL.md · CC0-1.0
---
name: promo-director
description: Generates 15-second vertical promo videos for social media from mastered audio. Use after mastering is complete and before release, when the user wants social media content.
model: sonnet
effort: low
prerequisites:
  - mastering-engineer
  - album-art-director
allowed-tools:
  - Read
  - Bash
  - Glob
  - bitwize-music-mcp
requirements:
  external:
    - name: ffmpeg
      purpose: Video generation and audio visualization
      install: "brew install ffmpeg (macOS) or apt install ffmpeg (Linux)"
      notes: "Requires showwaves, showfreqs, drawtext, gblur filters"
  python:
    - pillow
    - librosa
    - pyyaml
---

# Promo Director Skill

Generate professional promo videos for social media from mastered audio. Creates 15-second vertical videos (9:16, 1080x1920) optimized for Instagram Reels, Twitter, and TikTok.

## Purpose

After mastering audio, generate promotional videos that combine:
- Album artwork
- Audio waveform visualization (9 styles available)
- Track title + artist name
- Automatic color scheme extracted from artwork
- Intelligent segment selection (finds the most energetic 15 seconds)

## When to Use

- After mastering complete, before release
- User says "generate promo videos" or "create promo videos for [album]"
- When album has mastered audio + artwork ready

## Position in Workflow

```
Generate → Master → **[Promo Videos]** → Release
```

Optional step between mastering-engineer and release-director.

## Workflow

### 1. Setup Verification

**Check ffmpeg:**
```bash
ffmpeg -filters | grep showwaves
```

Required filters: `showwaves`, `showfreqs`, `drawtext`, `gblur`

If missing:
```
Error: ffmpeg not found or missing required filters

Install ffmpeg:
  macOS: brew install ffmpeg
  Linux: apt install ffmpeg

After installing, run this command again.
```

**Check Python dependencies:**

Call `get_python_command()` to verify the venv exists. If `venv_exists` is false, show the warning and suggest `/bitwize-music:setup`.

### 2. Album Detection

**Resolve audio path via MCP:**

Call `resolve_path("audio", album_slug)` — returns the full audio directory path including artist folder.

Example result: `~/bitwize-music/audio/artists/bitwize/albums/electronic/sample-album/`

**Verify contents:**
- ✓ Mastered audio files (.wav, .mp3, .flac, .m4a)
- ✓ Album artwork (album.png or album.jpg)

If artwork missing:
```
Error: No album artwork found in {audio_root}/artists/{artist}/albums/{genre}/{album}/

Expected: album.png or album.jpg

Options:
  1. Use /bitwize-music:import-art to place artwork
  2. Specify path manually: --artwork /path/to/art.png

Which option?
```

### 3. User Preferences

**Check config defaults first:**

Read `promotion` section from `~/.bitwize-music/config.yaml` for defaults:
- `promotion.default_style` - Default visualization style
- `promotion.duration` - Default clip duration
- `promotion.include_sampler` - Whether to generate album sampler by default
- `promotion.sampler_clip_duration` - Seconds per track in sampler

If config section doesn't exist, use built-in defaults (pulse, 15s, sampler enabled, 12s clips).

**Ask: What to generate?**

Options (default from config or "both"):
1. Individual track promos (15s each) + Album sampler (all tracks)
2. Individual track promos only
3. Album sampler only

**Ask: Visualization style?**

Default from `promotion.default_style` or `pulse` if not set.

| Style | Best For | Description |
|-------|----------|-------------|
| `pulse` | Electronic, hip-hop | Oscilloscope/EKG style with heavy glow (default) |
| `bars` | Pop, rock | Fast reactive spectrum bars |
| `line` | Acoustic, folk | Classic clean waveform |
| `mirror` | Ambient, chill | Mirrored waveform with symmetry |
| `mountains` | EDM, bass-heavy | Dual-channel spectrum (looks like mountains) |
| `colorwave` | Indie, alternative | Clean waveform with subtle glow |
| `neon` | Synthwave, 80s | Sharp waveform with punchy neon glow |
| `dual` | Experimental | Two separate waveforms (dominant + complementary colors) |
| `circular` | Abstract, experimental | Vectorscope (wild circular patterns) |

**Default recommendation:**
- Electronic/Hip-Hop → `pulse`
- Rock/Pop → `bars`
- Folk/Acoustic → `line`
- Ambient/Chill → `mirror`

**Ask: Custom duration?**

Default: 15 seconds (optimal for Instagram/Twitter)

Options:
- 15s (recommended, Instagram Reels sweet spot)
- 30s (longer preview)
- 60s (full clip, less common)

**For sampler:**

Default: 12 seconds per track

Calculate total:
```
Total duration = (tracks * clip_duration) - ((tracks - 1) * crossfade)
Twitter limit: 140 seconds
```

If over 140s:
```
WARNING: Expected duration {duration}s exceeds Twitter limit (140s)

Recommendation: Reduce --clip-duration to {140 / tracks}s
```

### 4. Generation

**Individual track promos:**

```
generate_promo_videos(album_slug, style="pulse", duration=15)
```

**Single track only:**
```
generate_promo_videos(album_slug, style="pulse", track_filename="01-track-name.wav")
```

**Album sampler:**

```
generate_album_sampler(album_slug, clip_duration=12, crossfade=0.5)
```

**Handle errors:**

Common issues:
- **ffmpeg filter error** → Check ffmpeg install includes filters
- **Font not found** → Install dejavu fonts or specify custom font
- **Artwork extraction fails** → Use default cyan color scheme
- **librosa unavailable** → Fall back to 20% into track for segment selection
- **Audio file corrupt** → Skip track, report, continue with others

### 5. Results Summary

**Report generated files:**

```
## Promo Videos Generated

**Location:** {audio_root}/artists/{artist}/albums/{genre}/{album}/

**Individual Track Promos:**
- {audio_root}/artists/{artist}/albums/{genre}/{album}/promo_videos/
- 10 videos generated
- Format: 1080x1920 (9:16), H.264, 15s each
- Style: pulse
- File size: ~10-12 MB per video

**Album Sampler:**
- {audio_root}/artists/{artist}/albums/{genre}/{album}/album_sampler.mp4
- Duration: 114.5s (under Twitter 140s limit ✓)
- Format: 1080x1920 (9:16), H.264
- File size: 45.2 MB

**Next Steps:**
1. Review videos: Open promo_videos/ folder
2. Test on phone: Transfer one video and verify quality
3. Populate social copy: Fill in promo/ templates (twitter.md, instagram.md, etc.)
4. [Optional] Upload to cloud: /bitwize-music:cloud-uploader {album}
5. Ready for release workflow: /bitwize-music:release-director {album}
```


## Technical Reference

See [technical-reference.md](technical-reference.md) for:
- Output specifications (resolution, format, bitrate)
- Visualization styles (pulse, bars, line, etc.)
- Platform compatibility (Instagram, Twitter, TikTok)
- Dependencies (required and optional)
- Troubleshooting common issues

© bitwize-music-studio · CC0-1.0 · bitwize-music-studio/claude-ai-music-skills

Похожие скиллы

Все скиллы по теме «Автоматизация и no-code: n8n, Zapier, Make» →
promo-video OpusGameLabs Скилл promo-video записывает плавное промо-видео Phaser-игры в портретной ориентации 9:16 с частотой 50 FPS через Chrome DevTools Protocol и FFmpeg. CX Codex +1 953установок vox-director Alisa0808 Скилл vox-director собирает ролик-объяснение или рекламу в стиле бумажного коллажа: сценарий, кадры-постеры, движение, озвучка, музыка и субтитры. Работает на Atlas Cloud API и локальном ffmpeg. CX Codex +1 ★ 3 014звёзд репо ableton-live-mcp-control reason-machines Скилл ableton-live-mcp-control для Claude Code подключает агента к Ableton Live через MCP. Агент создаёт MIDI-клипы, треки и устройства, захватывает аудио и строит спектрограммы в открытом Live Set. CX Codex +1 237установок vox-video-director modelstudioai Скилл vox-video-director для Claude Code превращает одну тему в готовое видео в стиле Vox: коллаж-анимацию с озвучкой, музыкой и субтитрами. CX Codex +1 161установок scenario-seedance-music-video scenario-labs Скилл scenario-seedance-music-video для сборки музыкального клипа из трека и промптов: планирует кадры под структуру песни, генерирует шоты через Seedance, собирает монтаж с оригинальным саундтреком. CX Codex +1 865установок record-promo OpusGameLabs Скилл record-promo записывает автономное геймплейное видео игры в 50 FPS для TikTok, Reels или X. Скилл сам управляет игрой и сохраняет готовый MP4. CX Codex +1 939установок

Из того же набора52

Весь набор →
pre-generation-check Скилл pre-generation-check проверяет готовность трека или альбома к генерации в Suno и выдаёт итог READY или NOT READY. CX Codex +1 264установок album-conceptualizer Скилл album-conceptualizer помогает спланировать концепцию альбома, порядок треков и тематическую дугу. Подходит для нового альбома и переработки существующего. CX Codex +1 262установок clipboard Скилл clipboard копирует тексты песен, промпты стилей и метаданные музыкальных треков в системный буфер обмена для быстрой вставки в Suno. CX Codex +1 261установок researchers-legal Скилл researchers-legal для Claude Code исследует судебные документы по уголовным и гражданским делам и собирает факты с цитатами. Разбирает темы, связанные с судебными процессами. CX Codex +1 261установок promo-writer Скилл promo-writer генерирует тексты для продвижения альбома в соцсетях с учётом формата каждой платформы. Пригодится перед релизом, когда шаблоны promo/ нужно заполнить. CX Codex +1 259установок tutorial Скилл tutorial проводит новичка через создание музыкального альбома: от идеи и жанра до треклиста, обложки и подтверждения плана. CX Codex +1 259установок import-audio Скилл import-audio для Claude Code переносит аудиофайлы в папку альбома и раскладывает stems по трекам. Обрабатывает WAV, MP3 и другие поддерживаемые форматы. CX Codex +1 257установок document-hunter Скилл document-hunter ищет и скачивает первичные публичные документы, судебные иски и правительственные отчёты через автоматизацию браузера Playwright. CX Codex +1 256установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой