Agent skill

Background Music

Pick background music from the assets/music/ library and configure auto-ducking (music dips automatically under speech) via meta.json audio.music for the Remotion assembly layer.

MITAuto-check passedMedia & Creative

Install Background Music

skills CLI

$ npx skills add notivn/AIEV --skill background-music -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install notivn/AIEV background-music --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/notivn/AIEV.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/background-music .claude/skills/background-music && rm -rf skills-src

Use ~/.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/

Paste into Claude Code

Install the "background-music" agent skill from https://github.com/notivn/AIEV/tree/main/.claude/skills/background-music into .claude/skills/background-music/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "background-music", 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

$skill-installer install https://github.com/notivn/AIEV/tree/main/.claude/skills/background-music

Type 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.

skills CLI

$ npx skills add notivn/AIEV --skill background-music -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install notivn/AIEV background-music --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/notivn/AIEV.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/background-music .agents/skills/background-music && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "background-music" agent skill from https://github.com/notivn/AIEV/tree/main/.claude/skills/background-music into .agents/skills/background-music/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "background-music", 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.

skills CLI

$ npx skills add notivn/AIEV --skill background-music -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install notivn/AIEV background-music --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/notivn/AIEV.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/background-music .cursor/skills/background-music && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "background-music" agent skill from https://github.com/notivn/AIEV/tree/main/.claude/skills/background-music into .cursor/skills/background-music/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "background-music", 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

$ gemini skills install https://github.com/notivn/AIEV.git --path .claude/skills/background-music

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add notivn/AIEV --skill background-music -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install notivn/AIEV background-music --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/notivn/AIEV.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/background-music .gemini/skills/background-music && rm -rf skills-src

Use ~/.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/

Paste into Gemini CLI

Install the "background-music" agent skill from https://github.com/notivn/AIEV/tree/main/.claude/skills/background-music into .gemini/skills/background-music/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "background-music", 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.

GitHub CLI

$ gh skill install notivn/AIEV background-music

Installs 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).

skills CLI

$ npx skills add notivn/AIEV --skill background-music -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/notivn/AIEV.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/background-music .github/skills/background-music && rm -rf skills-src

Use ~/.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/

Paste into GitHub Copilot

Install the "background-music" agent skill from https://github.com/notivn/AIEV/tree/main/.claude/skills/background-music into .github/skills/background-music/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "background-music", 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.

skills CLI

$ npx skills add notivn/AIEV --skill background-music -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install notivn/AIEV background-music --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/notivn/AIEV.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/background-music .opencode/skills/background-music && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "background-music" agent skill from https://github.com/notivn/AIEV/tree/main/.claude/skills/background-music into .opencode/skills/background-music/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "background-music", 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: background-music
GitHub stars: 127
Token cost: ~1.1k tokens
SKILL.md length: 539 words
Files: 1
Skills in repo: 14
Repo updated: Oct 9, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Pick background music from the assets/music/ library and configure auto-ducking (music dips automatically under speech) via meta.json audio.music for the Remotion assembly layer.

Works in 5 steps: Pick a track by mood → Generate speech ranges from the transcript → Volume levels → …
Asks to add/adjust background music on a video
SKILL.md covers 1. Pick a track by mood, 2. Generate speech ranges from…, 3. Volume levels and 4. Declare it in meta.json, plus 2 more sections
Calls ffmpeg

What it does

Background Music is an agent skill from notivn/AIEV. Pick background music from the assets/music/ library and configure auto-ducking (music dips automatically under speech) via meta.json audio.music for the Remotion assembly layer. Read when the brief/edit prompt has a "Nhạc nền" (background music) section set to auto, or when the user asks to add/adjust background music on a video.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative, covering Video production and Motion graphics. It works with Remotion and FFmpeg. The repository describes itself as: Automatic AI video editing. Claude directs HyperFrames (HTML + GSAP motion graphics) and Remotion (timeline assembly) to turn raw footage into a finished MP4 - transcript… The licence is MIT.

When your agent uses it

Asks to add/adjust background music on a video
Tasks that involve Video production
Tasks that involve Motion graphics

Example prompts

“Nhạc nền”
“/background-music”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

Pick a track by mood
Generate speech ranges from the transcript
Volume levels
Declare it in meta.json
Verify (mandatory before final)

What it can do on your machine

Read from SKILL.md and the folder at commit e40fe03. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
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

Background Music loads about 1.1k tokens when it runs. Until then it costs about 87 tokens; SKILL.md has 539 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~87
When it runs · the whole SKILL.md, loaded when a task matches: ~1.1k

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 passed

The automated check found no risky patterns in SKILL.md.

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 notivn/AIEV at commit e40fe03, republished under its MIT licence (© notivn). 539 words, ~1,075 tokens.

Download SKILL.mdSave it as .claude/skills/background-music/SKILL.md (or your agent's skills folder).

name: background-music
description: Pick background music from the assets/music/ library and configure auto-ducking (music dips automatically under speech) via meta.json audio.music for the Remotion assembly layer. Read when the brief/edit prompt has a "Nhạc nền" (background music) section set to auto, or when the user asks to add/adjust background music on a video.

Background Music - music bed + auto-ducking

Background music is played by Remotion in the assembly layer (the MusicTrack component): the track loops, fades in over 0.5s at the start of the video, fades out over 1s at the end, and auto-ducks (smooth 0.4s volume dip) around every speech segment. Claude's job is to pick the track + generate the speech ranges + declare audio.music correctly in meta.json - everything else is deterministic inside Remotion.

1. Pick a track by mood

Read assets/music/library.json - each entry has file, tags (mood: nang-luong, chill, cam-hung, cang-thang, vui-ve...), durationMs, description.
Pick ONE track whose mood matches the video content (motivational video -> nang-luong/cam-hung; slow explainer -> chill...).
A track shorter than the video is fine - MusicTrack loops it automatically, no need to concatenate files with ffmpeg.

2. Generate speech ranges from the transcript

Speech ranges = the segments that DO contain speech (in seconds, on the already-cut composition timeline) - these are the moments the music gets ducked.

Take the word timestamps from the transcript (already remapped if autoCut ran).
Merge adjacent words into one continuous range.
Merge two ranges if the gap between them is < 0.6s - a short breath between two sentences is not worth having the music swell back up and drop again.
Result: [[startSec, endSec], ...] - usually just a few ranges for a talking-head video (silent intro, body, outro).

3. Volume levels

Context	volume	Notes
Speech present (`duckVolume`)	0.10-0.15	Music sits ~18-20dB below the voice - the voice is ALWAYS clearer than the music
No speech (`volume`): intro/outro/pauses	0.30-0.40	Music carries the emotion but does not bury the sfx

Loud / bass-heavy tracks -> take the lower bound of both ranges (0.10 / 0.30).

4. Declare it in meta.json

Copy the music file into the project's assets/ (same as sfx) so the project stays portable - NEVER point directly at the shared library:

powershell

Copy-Item "assets/music/<file>" "video-projects/<id>/assets/music/<file>"

Then declare it (path relative to the project root):

json

"audio": {
  "voice": "...",
  "sfx": [...],
  "music": {
    "file": "assets/music/<file>",
    "volume": 0.35,
    "duckVolume": 0.12,
    "speech": [[1.2, 14.8], [16.1, 42.5]]
  }
}

The server stages the file into the Remotion staging directory during assembly - nothing else to do.

Show full SKILL.md (213 more words)Show less

5. Verify (mandatory before final)

Render a draft (assemble-draft) then listen at 3 points: start of the video (fade-in + intro level), middle of the video during speech (music must sit clearly under the voice), end of the video (clean fade-out).
The only standard: the voice MUST be clearer than the music at every moment. If you have to strain to make out the words -> lower duckVolume.
If in doubt about the levels, measure with ffmpeg -i <draft.mp4> -af volumedetect -f null NUL over a speech segment and a non-speech segment, and compare the two mean_volume values.

Mistakes to avoid

Music louder than speech - duckVolume is too high, or the speech ranges are missing a segment. Re-check transcript coverage: every spoken segment must fall inside a range.
Forgetting the final fade-out - MusicTrack fades out over 1s based on durationInFrames; but if the composition's total duration is computed wrong, the music gets cut off abruptly. Verify the end point when listening to the draft.
Music with Vietnamese lyrics - it fights the speech, the listener's brain cannot separate two layers of words. ONLY use instrumental music.
Downloading music from the internet - FORBIDDEN (copyright). Only use the assets/music/ library. If the library is empty -> skip background music and state that clearly in the report.

Files

Just SKILL.md in .claude/skills/background-music of notivn/AIEV.

Open the folder on GitHubat commit e40fe03

Compare with similar skills

Background Music 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.

Background Music compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Background Music this skillnotivn/AIEV	127	—	~1.1k	Automated safety check: Pass	MIT	today
HyperFrames Video Entry Pointheygen-com/hyperframes	60k	3 repos	~5.2k	Automated safety check: Pass	Apache-2.0	today
Black White Text OpenerPluviobyte/video-production-skills	671	—	~1k	Automated safety check: Pass	None	2 mo ago
Super Video MakerBomx/super-video-maker-skill	310	—	~11k	Automated safety check: Notes	None	2 mo ago
Render Offer Adgooseworks-ai/goose-skills	1.2k	—	~2.5k	Automated safety check: Pass	MIT	yesterday
Remotion Video Enhanceranbeime/skill	7.8k	—	~1.9k	Automated safety check: Notes	None	yesterday

Similar skills

HyperFrames Video Entry Point
heygen-com/hyperframes
Entry point for making, editing and rendering videos from HTML compositions with HyperFrames, routing each request to the right workflow.
60k GitHub starsUsed in 3 repos~5.2k tokens
Media & CreativeAuto-check passed
Black White Text Opener
Pluviobyte/video-production-skills
Create reusable black-background white-text opening animations for new videos.
671 GitHub stars~1k tokensUpdated 2 mo ago
Media & CreativeAuto-check passed
Super Video Maker
Bomx/super-video-maker-skill
End-to-end AI video production skill for agentic frameworks.
310 GitHub stars~11k tokensUpdated 2 mo ago
Media & CreativeAuto-check: notes
Render Offer Ad
gooseworks-ai/goose-skills
Render a punchy ~12s vertical (9:16) music-only direct-response OFFER ad as a 4-beat kinetic-typography film — HEADLINE slam → real PRODUCT drop → CLAIM/proof → CTA pill — from one config of copy…
1.2k GitHub stars~2.5k tokensUpdated yesterday
Media & CreativeAuto-check passed
Remotion Video Enhancer
anbeime/skill
Adds Remotion-style video transitions and Framer Motion page animations to PPT-based videos and HTML slide viewers, planning the animation sequence first.
7.8k GitHub stars~1.9k tokensUpdated yesterday
Media & CreativeAuto-check: notes
Remotion Best Practices
lyonjs/shortvid.io
Best practices for Remotion - Video creation in React. An agent skill from lyonjs/shortvid.io.
147 GitHub starsUsed in 33 repos~1k tokens
Media & CreativeAuto-check passed

Questions about Background Music

What does Background Music do?

Pick background music from the assets/music/ library and configure auto-ducking (music dips automatically under speech) via meta.json audio.music for the Remotion assembly layer. Background Music is an agent skill from notivn/AIEV.music for the Remotion assembly layer.

When should I use Background Music?

Background Music fits situations like: asks to add/adjust background music on a video; tasks that involve Video production; tasks that involve Motion graphics.

How do I install Background Music in Claude Code?

Run `npx skills add notivn/AIEV --skill background-music -a claude-code`. Or copy the skill folder (.claude/skills/background-music in notivn/AIEV) into .claude/skills/background-music in your project. Claude Code loads it when a task matches its description.

How do I install Background Music in Codex?

Run `npx skills add notivn/AIEV --skill background-music -a codex`. Or copy the skill folder (.claude/skills/background-music in notivn/AIEV) into .agents/skills/background-music in your project. Codex loads it when a task matches its description.

Can I use Background Music 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 notivn/AIEV --skill background-music -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/background-music, .gemini/skills/background-music, .github/skills/background-music and .opencode/skills/background-music in your project.

What does Background Music need to run?

Going by SKILL.md and its folder, Background Music needs the command-line tools its instructions call (ffmpeg).

Does Background Music 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 Background Music safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Background Music use?

Background Music is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Background Music use?

About 1.1k tokens (SKILL.md is roughly 4.3k 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 Background Music?

Skills that share tags, products or a category with Background Music: HyperFrames Video Entry Point (heygen-com/hyperframes, 60k stars), Black White Text Opener (Pluviobyte/video-production-skills, 671 stars), Super Video Maker (Bomx/super-video-maker-skill, 310 stars) and Render Offer Ad (gooseworks-ai/goose-skills, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Background Music?

notivn (a GitHub organization) maintains it in notivn/AIEV, which has 127 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 9, 2026.

Source: notivn/AIEV on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Background Music

Install Background Music

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Background Music - music bed + auto-ducking

1. Pick a track by mood

2. Generate speech ranges from the transcript

3. Volume levels

4. Declare it in meta.json

5. Verify (mandatory before final)

Mistakes to avoid

Files

Compare with similar skills

Similar skills

HyperFrames Video Entry Point

Black White Text Opener

Super Video Maker

Render Offer Ad

Remotion Video Enhancer

Remotion Best Practices

More from notivn/AIEV

Color Grading

Noti Tiktok Full Text

Skill Authoring

Noti Tiktok Vn

Noti Youtube Edit

Short Form Video

Questions about Background Music

Install Background Music

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Background Music - music bed + auto-ducking

1. Pick a track by mood

2. Generate speech ranges from the transcript

3. Volume levels

4. Declare it in meta.json

5. Verify (mandatory before final)

Mistakes to avoid

Files

Compare with similar skills

Similar skills

More from notivn/AIEV

Related

Questions about Background Music