puntorigenpuntorigen/avatar-skills/bg-music/SKILL.md

bg-music

Skill3 starsChanged 4 months agoMITView on GitHub

Generate background music tracks for social media posts, presentations, reels, and app content using ElevenLabs Music on Replicate. Supports emotional mood presets (uplifting, calm, dramatic, playful, etc.), configurable duration (up to 5 minutes), multiple output formats (MP3/WAV), and fade-in/fade-out. Use when the user asks to generate, create, or produce background music, BGM, backing tracks, mood music, or any musical audio content for posts, reels, presentations, or videos.

2 other projects use a version of this.

Adopted by

Most recently taken up by

puntorigen/skillstheir own version, first seen Jul 8, 2026
jperrello/C0BALT_CUTtheir own version, first seen Jun 22, 2026

Other versions2 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 2
jperrello/C0BALT_CUT★ 2same name
puntorigen/skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository45 other files it gives its agents.
- asset-generatorSkill
- audio-theaterSkill
- avatar-ambient-sfxSkill
- avatar-camera-anglesSkill
- avatar-framesSkill
- avatar-inventSkill
- avatar-locationSkill
- avatar-reel-composerSkill
- avatar-talking-videoSkill
- bg-music-hqSkill
- brand-content-strategySkill
- broll-actor-copySkill
- broll-avatar-cameraSkill
- broll-browser-recorderSkill
- broll-coreSkill
- broll-cursorSkill
- broll-finderSkill
- broll-generatorSkill
- broll-storySkill
- broll-terminalSkill
- broll-web-captureSkill
- caption-word-revealSkill
- carousel-generatorSkill
- cuento-reelSkill
- facebook-videosSkill
- gpt-image-2Skill
- instagram-videosSkill
- luxury-hnwi-salesSkill
- onboarding-scriptSkill
- pdf-remixSkill
- reel-discoverySkill
- reel-restyleSkill
- rule-of-six-editSkill
- seedance-2Skill
- sound-effectsSkill
- tiktok-videosSkill
- video-bg-replaceSkill
- video-composeSkill
- video-remixSkill
- video-scene-analysisSkill
- video-transcribeSkill
- viral-video-scriptSkill
- voice-cloneSkill
- voice-isolateSkill
- youtube-videosSkill

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.

≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.

Common
Distinctive
Very specific

Very specific:
Use --fade-in and --fade-out to customize (in ms), or --no-fade to disable.
line 166

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.

Files

SKILL.md

Background Music Generator

Generate production-ready background music for social media posts, presentations, reels, and in-app content using ElevenLabs Music on Replicate.

Setup

Install dependencies (one-time):

pip3 install -r ~/.cursor/skills/bg-music/scripts/requirements.txt

Set your Replicate API token (skipped if already configured by another skill):

python3 ~/.cursor/skills/bg-music/scripts/setup_key.py YOUR_REPLICATE_API_TOKEN

Quick Reference

Generate background music

python3 ~/.cursor/skills/bg-music/scripts/generate_bgm.py "gentle piano melody for a pet care post" \
  --mood calm --duration 30 --output bgm_calm.mp3

Prompt enhancement (default)

The script auto-enhances your description into an optimal prompt for ElevenLabs Music. Use --raw-prompt to skip:

# Enhanced (default)
python3 ~/.cursor/skills/bg-music/scripts/generate_bgm.py "upbeat happy vibe" -m uplifting -d 30 -o happy.mp3

# Raw: use your prompt verbatim
python3 ~/.cursor/skills/bg-music/scripts/generate_bgm.py "Lo-fi hip hop beat, warm vinyl texture, 85 BPM, C major" \
  --raw-prompt -d 45 -o lofi.mp3

Generate variations

# Same mood, different results
python3 ~/.cursor/skills/bg-music/scripts/generate_bgm.py "warm acoustic background" \
  -m heartfelt -d 30 -n 3 -o acoustic.mp3
# Generates: acoustic_1.mp3, acoustic_2.mp3, acoustic_3.mp3

Choose output format

# High-quality MP3
python3 ~/.cursor/skills/bg-music/scripts/generate_bgm.py "epic cinematic track" \
  -m epic -d 30 -f mp3_high_quality -o epic.mp3

# CD-quality WAV
python3 ~/.cursor/skills/bg-music/scripts/generate_bgm.py "ambient meditation pad" \
  -m calm -d 60 -f wav_cd_quality -o ambient.wav

generate_bgm.py Options

Option	Short	Description
`--mood MOOD`	`-m`	Emotional mood preset (see below)
`--duration SECS`	`-d`	Duration in seconds (5-300, default: 30)
`--output PATH`	`-o`	Output file path (default: auto-named)
`--variations N`	`-n`	Number of variations to generate (1-5)
`--output-format FMT`	`-f`	Audio format (default: mp3_standard)
`--raw-prompt`		Use prompt as-is, skip enhancement
`--fade-in MS`		Fade-in duration in ms (default: 500)
`--fade-out MS`		Fade-out duration in ms (default: 1500)
`--no-fade`		Disable fade-in/fade-out
`--bpm INT`		Suggest BPM in the prompt (optional, mood has defaults)
`--key KEY`		Suggest musical key (e.g. "C major", "A minor")
`--list-moods`		Show all available mood presets

Output Formats

Format	Quality	Best For
`mp3_standard`	128kbps MP3	Social media, general use (default)
`mp3_high_quality`	192kbps MP3	Higher quality, still compact
`wav_16khz`	16kHz WAV	Voice-focused content
`wav_22khz`	22kHz WAV	Medium quality WAV
`wav_24khz`	24kHz WAV	Good quality WAV
`wav_cd_quality`	44.1kHz WAV	Uncompressed CD quality

Mood Presets

Mood	Best For	Default Dur.	Character
`uplifting`	Success stories, achievements, celebrations	30s	Bright, optimistic, major key
`calm`	Wellness tips, mindful moments, care routines	30s	Gentle, ambient, soothing
`playful`	Fun pet content, games, lighthearted posts	20s	Bouncy, cheerful, quirky
`heartfelt`	Adoption stories, bonds, emotional moments	30s	Warm, acoustic, intimate
`dramatic`	Transformations, reveals, before/after	20s	Building tension, cinematic
`confident`	Tips, expertise, professional advice	25s	Steady, assured, modern
`nostalgic`	Memories, throwbacks, reflection	30s	Warm, vintage, soft
`energetic`	Fitness, active pets, outdoor adventures	25s	Driving, uptempo, powerful
`mysterious`	Teasers, coming soon, curiosity hooks	20s	Suspenseful, textural, dark
`inspiring`	Milestones, growth, motivational content	30s	Soaring, orchestral, hopeful
`cozy`	Home life, comfort, seasonal content	30s	Lo-fi, warm, intimate
`epic`	Big announcements, launches, hero moments	25s	Cinematic, powerful, layered
`tender`	Gentle care, lullabies, quiet moments	30s	Delicate, piano, strings
`corporate`	Presentations, pitch decks, demos	30s	Clean, modern, understated
`generic`	General purpose (default)	30s	Neutral, versatile

Moods are defined in scripts/moods.json and can be customized.

Common Workflows

Background music for social media posts

# Happy pet content
python3 ~/.cursor/skills/bg-music/scripts/generate_bgm.py "cheerful background for a dog playing at the park" \
  -m playful -d 20 -o assets/bgm/dog_park.mp3

# Heartfelt adoption story
python3 ~/.cursor/skills/bg-music/scripts/generate_bgm.py "emotional piano for pet adoption story" \
  -m heartfelt -d 30 -o assets/bgm/adoption_story.mp3

Presentation backing track

python3 ~/.cursor/skills/bg-music/scripts/generate_bgm.py "clean modern background for tech presentation" \
  -m corporate -d 60 --fade-out 3000 -o assets/bgm/presentation.mp3

Reel / short-form video music

python3 ~/.cursor/skills/bg-music/scripts/generate_bgm.py "trendy upbeat track for instagram reel" \
  -m energetic -d 15 --bpm 120 -o assets/bgm/reel_beat.mp3

Long-form content (up to 5 minutes)

python3 ~/.cursor/skills/bg-music/scripts/generate_bgm.py "ambient background for a meditation session" \
  -m calm -d 300 -f wav_cd_quality -o assets/bgm/meditation.wav

Try different styles for the same concept

# Generate 3 variations, pick your favourite
python3 ~/.cursor/skills/bg-music/scripts/generate_bgm.py "warm acoustic guitar background" \
  -m heartfelt -d 30 -n 3 -o assets/bgm/acoustic.mp3

Fade-In / Fade-Out

Background music tracks benefit from smooth fades. By default:

Fade-in: 500ms gentle ramp
Fade-out: 1500ms smooth tail

Use --fade-in and --fade-out to customize (in ms), or --no-fade to disable.

Fades are applied via ffmpeg after generation -- the model generates the full track, then fades are applied as post-processing.

Model

Uses ElevenLabs Music (elevenlabs/music) on Replicate -- studio-grade music generation with:

Text-to-music from natural language prompts
Instrumental-only mode (enabled by default for background music)
Up to 5 minutes of audio per generation
Multiple output formats (MP3 and WAV at various quality levels)
Commercial use license

Pricing: ~$8.30 per 1000 seconds of output audio (~120 seconds for $1).

Prompt Enhancement

Enhancement adds musical descriptors to improve results:

Injects mood-specific style keywords (tempo, instruments, tonality)
Adds production quality descriptors (mixed, mastered, professional)
Suggests BPM range when appropriate
Adds "background music" / "instrumental" framing
Keeps your core description intact

Configuration

Config at ~/.cursor/skills/bg-music/config.json:

{
  "replicate_api_token": "YOUR_TOKEN",
  "default_mood": "generic",
  "default_duration": 30,
  "default_output_format": "mp3_standard"
}

Falls back to tokens from sound-effects, avatar-video-reel, or brand-asset-studio skills.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free