Viral Captions And Ctas
vyralcontent/content-skills
Write captions, on-screen text, hashtags, and CTAs for short-form video that earn saves and sends without tripping engagement-bait penalties.
Generates 15-second vertical promo videos for social media from mastered audio.
Install Promo Director
$ npx skills add bitwize-music-studio/claude-ai-music-skills --skill promo-director -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install bitwize-music-studio/claude-ai-music-skills promo-director --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/bitwize-music-studio/claude-ai-music-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/promo-director .claude/skills/promo-director && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "promo-director" agent skill from https://github.com/bitwize-music-studio/claude-ai-music-skills/tree/main/skills/promo-director into .claude/skills/promo-director/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "promo-director", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/bitwize-music-studio/claude-ai-music-skills/tree/main/skills/promo-directorType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add bitwize-music-studio/claude-ai-music-skills --skill promo-director -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install bitwize-music-studio/claude-ai-music-skills promo-director --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/bitwize-music-studio/claude-ai-music-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/promo-director .agents/skills/promo-director && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "promo-director" agent skill from https://github.com/bitwize-music-studio/claude-ai-music-skills/tree/main/skills/promo-director into .agents/skills/promo-director/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "promo-director", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add bitwize-music-studio/claude-ai-music-skills --skill promo-director -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install bitwize-music-studio/claude-ai-music-skills promo-director --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/bitwize-music-studio/claude-ai-music-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/promo-director .cursor/skills/promo-director && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "promo-director" agent skill from https://github.com/bitwize-music-studio/claude-ai-music-skills/tree/main/skills/promo-director into .cursor/skills/promo-director/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "promo-director", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/bitwize-music-studio/claude-ai-music-skills.git --path skills/promo-director--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add bitwize-music-studio/claude-ai-music-skills --skill promo-director -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install bitwize-music-studio/claude-ai-music-skills promo-director --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/bitwize-music-studio/claude-ai-music-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/promo-director .gemini/skills/promo-director && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "promo-director" agent skill from https://github.com/bitwize-music-studio/claude-ai-music-skills/tree/main/skills/promo-director into .gemini/skills/promo-director/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "promo-director", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install bitwize-music-studio/claude-ai-music-skills promo-directorInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add bitwize-music-studio/claude-ai-music-skills --skill promo-director -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/bitwize-music-studio/claude-ai-music-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/promo-director .github/skills/promo-director && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "promo-director" agent skill from https://github.com/bitwize-music-studio/claude-ai-music-skills/tree/main/skills/promo-director into .github/skills/promo-director/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "promo-director", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add bitwize-music-studio/claude-ai-music-skills --skill promo-director -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install bitwize-music-studio/claude-ai-music-skills promo-director --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/bitwize-music-studio/claude-ai-music-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/promo-director .opencode/skills/promo-director && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "promo-director" agent skill from https://github.com/bitwize-music-studio/claude-ai-music-skills/tree/main/skills/promo-director into .opencode/skills/promo-director/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "promo-director", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
promo-director- GitHub stars
- 544
- Token cost
- ~1.7k tokens
- SKILL.md length
- 474 words
- Files
- 3
- Skills in repo
- 51
- Repo updated
- First seen
- Licence
- CC0-1.0
At a glance
Generates 15-second vertical promo videos for social media from mastered audio.
- Works in 5 steps: Setup Verification → Album Detection → User Preferences → …
- Wants social media content
- SKILL.md covers Purpose, When to Use, Position in Workflow and Workflow, plus 1 more section
- Calls ffmpeg
What it does
Promo Director is an agent skill from bitwize-music-studio/claude-ai-music-skills. 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.
Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `technical-reference.md` and `visualization-guide.md`).
It sits in Media & Creative, covering Video production and Social media posts. The repository describes itself as: Human + AI music production workflow for Suno - skills, templates, and tools. The licence is CC0-1.0.
When your agent uses it
- Wants social media content
- Tasks that involve Video production
- Tasks that involve Social media posts
Example prompts
- “Use the promo-director skill to generate 15-second vertical promo videos for social media from mastered audio”
- “/promo-director”
Requirements
- Python 3
- Pre-approved tools (allowed-tools): Read, Bash, Glob, bitwize-music-mcp
Workflow steps
5 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 58f32c2. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
ReadBashGlobbitwize-music-mcp
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
ffmpeg
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Promo Director loads about 1.7k tokens when it runs. Until then it costs about 47 tokens; SKILL.md has 474 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check: notes
The automated check noted patterns worth knowing about, such as sudo or a known installer.
- NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
allowed-tools: Read, Bash, Glob, bitwize-music-mcp
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from bitwize-music-studio/claude-ai-music-skills at commit 58f32c2, republished under its CC0-1.0 licence (© bitwize-music-studio). 474 words, ~1,679 tokens.
Download SKILL.mdSave it as
.claude/skills/promo-director/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.- 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.
- allowed-tools
- Read, Bash, Glob, bitwize-music-mcp
- model
- sonnet
- effort
- low
- prerequisites
- mastering-engineer, album-art-director
- requirements.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]** → ReleaseOptional step between mastering-engineer and release-director.
Workflow
1. Setup Verification
Check ffmpeg:
ffmpeg -filters | grep showwavesRequired 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 stylepromotion.duration- Default clip durationpromotion.include_sampler- Whether to generate album sampler by defaultpromotion.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"):
- Individual track promos (15s each) + Album sampler (all tracks)
- Individual track promos only
- 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) |
Show full SKILL.md (140 more words)Show less
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 secondsIf over 140s:
WARNING: Expected duration {duration}s exceeds Twitter limit (140s)
Recommendation: Reduce --clip-duration to {140 / tracks}s4. 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 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. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 2 other files in skills/promo-director of bitwize-music-studio/claude-ai-music-skills.
- SKILL.md
- technical-reference.md
- visualization-guide.md
Open the folder on GitHubat commit 58f32c2
Compare with similar skills
Promo Director next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Promo Director this skillbitwize-music-studio/claude-ai-music-skills | 544 | — | ~1.7k | Automated safety check: Notes | CC0-1.0 | |
| Viral Captions And Ctasvyralcontent/content-skills | 134 | 1 repos | ~2.8k | Automated safety check: Pass | MIT | |
| Cy Release Videocompozy/compozy | 2.8k | — | ~1.2k | Automated safety check: Pass | MIT | |
| Upload Postsundial-org/awesome-openclaw-skills | 663 | — | ~2k | Automated safety check: Pass | None | |
| Tiktok SlideshowLeoYeAI/openclaw-master-skills | 2.2k | — | ~4.4k | Automated safety check: Pass | MIT | |
| Eva Feature Screenshotvvedantb/eva | 101 | — | ~3.2k | Automated safety check: Notes | MIT |
Similar skills
Cy Release Video
compozy/compozy
Create or revise CompozyOS release videos with high-resolution product captures, Ultramock camera scenes, and the reusable Remotion package.
Upload Post
sundial-org/awesome-openclaw-skills
Upload content to social media platforms via Upload-Post API.
Tiktok Slideshow
LeoYeAI/openclaw-master-skills
Creates TikTok image carousels (slideshows with text overlays on photos) via the ViralBaby API.
Eva Feature Screenshot
vvedantb/eva
Grab a single clean HD screenshot of a new eva feature from the real running app (Playwright at deviceScaleFactor 2, 1280 layout captured crisp at 2560×1440, dev overlays hidden) and write a tweet…
App Promo Materials
glifxyz/glif-mcp-server
Plan and make launch, store, ad and campaign graphics with Glif: real app screens turned into store listings and launch posts, or a coordinated set of product photos, ads, a short video and a jingle…
More from bitwize-music-studio/claude-ai-music-skills
All 51 skills in this repoAlbum Conceptualizer
bitwize-music-studio/claude-ai-music-skills
Designs album concepts, tracklist architecture, and thematic planning through 7 structured phases.
Album Dashboard
bitwize-music-studio/claude-ai-music-skills
Shows a structured progress dashboard for an album with percentage complete per phase, blocking items, and status breakdown.
Album Ideas
bitwize-music-studio/claude-ai-music-skills
Tracks and manages album ideas including brainstorming, planning, and status updates.
Clipboard
bitwize-music-studio/claude-ai-music-skills
Copies track content (lyrics, style prompts, streaming lyrics) to the system clipboard.
Cloud Uploader
bitwize-music-studio/claude-ai-music-skills
Uploads promo videos and content to Cloudflare R2 or AWS S3.
Configure
bitwize-music-studio/claude-ai-music-skills
Sets up or edits the plugin configuration file interactively.
Related
Categories
Questions about Promo Director
What does Promo Director do?
Generates 15-second vertical promo videos for social media from mastered audio. Promo Director is an agent skill from bitwize-music-studio/claude-ai-music-skills. Generates 15-second vertical promo videos for social media from mastered audio.
When should I use Promo Director?
Promo Director fits situations like: wants social media content; tasks that involve Video production; tasks that involve Social media posts.
How do I install Promo Director in Claude Code?
Run `npx skills add bitwize-music-studio/claude-ai-music-skills --skill promo-director -a claude-code`. Or copy the skill folder (skills/promo-director in bitwize-music-studio/claude-ai-music-skills) into .claude/skills/promo-director in your project. Claude Code loads it when a task matches its description.
How do I install Promo Director in Codex?
Run `npx skills add bitwize-music-studio/claude-ai-music-skills --skill promo-director -a codex`. Or copy the skill folder (skills/promo-director in bitwize-music-studio/claude-ai-music-skills) into .agents/skills/promo-director in your project. Codex loads it when a task matches its description.
Can I use Promo Director in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add bitwize-music-studio/claude-ai-music-skills --skill promo-director -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/promo-director, .gemini/skills/promo-director, .github/skills/promo-director and .opencode/skills/promo-director in your project.
What does Promo Director need to run?
Going by SKILL.md and its folder, Promo Director needs the command-line tools its instructions call (ffmpeg). Our summary lists: Python 3. Its frontmatter pre-approves these tools: Read, Bash, Glob, bitwize-music-mcp.
Does Promo Director access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Promo Director safe to install?
Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.
What licence does Promo Director use?
Promo Director is published under the CC0-1.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Promo Director use?
About 1.7k tokens (SKILL.md is roughly 6.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Promo Director?
Skills that share tags, products or a category with Promo Director: Viral Captions And Ctas (vyralcontent/content-skills, 134 stars), Cy Release Video (compozy/compozy, 2.8k stars), Upload Post (sundial-org/awesome-openclaw-skills, 663 stars) and Tiktok Slideshow (LeoYeAI/openclaw-master-skills, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Promo Director?
bitwize-music-studio (a GitHub organization) maintains it in bitwize-music-studio/claude-ai-music-skills, which has 544 GitHub stars. The repository holds 51 skills in this directory. The repository was last updated on October 7, 2026.
Source: bitwize-music-studio/claude-ai-music-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.