promo-director

Generate vertical promo videos from mastered audio files using ffmpeg and Python.

Updated Jun 8, 2026
One-click install
npx skills add https://github.com/apavanello/claude-ai-music-skills --skill promo-director-apavanello
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: promo-director
Source: https://github.com/apavanello/claude-ai-music-skills/tree/main/skills/promo-director
Command: npx skills add https://github.com/apavanello/claude-ai-music-skills --skill promo-director-apavanello

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ffmpeg, python, and includes scripts (resource) and assets (resource) components.

What problem does it solve?

This Skill automates the generation of 15-second vertical promo videos optimized for social media, saving time and ensuring a polished final product.

Core Features & Use Cases

  • Video Generation: Creates vertical promo videos with album artwork, waveform visualization, and track information.
  • Automatic Color Scheme: Extracts color scheme from album artwork for consistent branding.
  • Intelligent Segment Selection: Finds the most energetic 15 seconds of the track for optimal engagement.
  • Use Case: After mastering an album, use this Skill to quickly generate promos for Instagram Reels, Twitter, and TikTok, ready for release.

Quick Start

Generate a promo video for your album using the promo-director skill with the following command: the promo-director skill my-album

Frequently Asked Questions about promo-director

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create vertical social media promo videos from mastered audio files?

To create vertical social media promo videos from mastered audio files, you can use a tool that automatically extracts the track's metadata, album artwork, and waveform to generate a visually engaging video clip optimized for platforms like TikTok and Instagram Reels.

Can ffmpeg automatically find the most energetic segment of a track for video marketing?

Yes, ffmpeg can be used within a scripted workflow to find the most energetic segment of a track for video marketing. The process intelligently analyzes the mastered audio to select an optimal 15-second clip for maximum social media engagement.

Does Python need to be installed to generate album promotion videos with waveform visualization?

Yes, Python needs to be installed to generate album promotion videos with waveform visualization. It is required for handling the scripting, configuration, and metadata extraction needed to automate the video generation process alongside ffmpeg.

What is the best way to automate audio visualization for Instagram Reels and TikTok?

The best way to automate audio visualization for Instagram Reels and TikTok is using a tool that extracts waveform data and album artwork colors to automatically render vertical 15-second video clips. This ensures consistent branding and optimal engagement without manual video editing.

Are there limitations when generating 15-second vertical promo videos from mastered audio?

A limitation when generating 15-second vertical promo videos from mastered audio is that the output is strictly formatted for short-form social media platforms. The duration is fixed to 15 seconds, which may not suit longer promotional formats or detailed audio visualization needs.