# video-to-music

Scores finished videos with original music using Sonilo, matching cuts and pacing. Every track is cleared for commercial use.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1500 installs · ★ 117
- Author: sonilo-ai
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/sonilo-ai/skills/tree/HEAD/video-to-music/SKILL.md
- Updated: 2026-10-20
- HTML: https://affpapa.org/en/nevibecode/skills/video-to-music

## What it does

The skill sends a cut video to Sonilo to compose an original soundtrack matched to pacing and scene transitions. Music matches the video runtime down to the second. Tracks are licensed through Shutterstock and approved for commercial advertising or social media campaigns.

It operates either through Sonilo MCP tools or the `sonilo` CLI. Authentication requires `sonilo login`, an OAuth plugin, or `SONILO_API_KEY`. Choose one transport per session. The `video_to_music` function exports audio, while `video_to_video_music` returns a rendered `.mp4` with audio muxed in. Source audio is dropped by default unless voice preservation is explicitly enabled.

Every generation triggers a paid API request. Video length is capped at 360 seconds (6 minutes), with a standard upload limit of 300 MB.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add sonilo-ai/skills --skill video-to-music -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/video-to-music/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/video-to-music/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add sonilo-ai/skills --skill video-to-music -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/video-to-music/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add sonilo-ai/skills --skill video-to-music -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/video-to-music/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install sonilo-ai/skills video-to-music
```

2. **Manually: put the files in place**
- File: `.github/skills/video-to-music/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add sonilo-ai/skills --skill video-to-music -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/sonilo-ai/skills --path video-to-music
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/video-to-music/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add sonilo-ai/skills --skill video-to-music -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/sonilo-ai/skills/tree/HEAD/video-to-music/SKILL.md

## When to use it
- score a finished video edit to match pacing and transitions
- mux AI-generated background music directly into a new mp4
- preserve speech while ducking background music underneath
- license original music cleared for commercial advertising

## Example prompts
- Score ~/Desktop/trailer.mp4 with an uplifting cinematic track
- Generate music for promo.mov and return a muxed mp4 file
- Run video_to_music on cut.mp4 with preserve_speech enabled

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: c0f3957d7843f3c8.

BEGIN THIRD-PARTY FILE c0f3957d7843f3c8
````text
---
name: video-to-music
description: Score a video with original music using Sonilo — the model watches the cut and matches pacing, motion, and emotion, returning either the audio or a new video with the score muxed in. Use when the user has a finished video that needs a soundtrack. Every track is licensed and cleared for commercial use. For music with no video, use the text-to-music skill.
license: MIT
compatibility: "Requires Sonilo through either transport — the MCP server connected, or the `sonilo` CLI installed and signed in — plus credentials: a `sonilo login` sign-in, the hosted OAuth plugin, or SONILO_API_KEY. See the setup-api-key skill."
allowed-tools: Bash, Read, Write, mcp__sonilo__*
---

# Sonilo Video-to-Music

Hand Sonilo a finished video and it composes an original score to the cut —
pacing, motion, and emotion matched, with transitions and beat drops aligned to
the edit, at exactly the video's length. This is Sonilo's flagship capability.
Every track is licensed (music licensed via Shutterstock) and cleared for
commercial use on social, brand content, and advertising.

> **Setup:** See the [setup-api-key](../setup-api-key) skill to connect the Sonilo MCP server and authenticate — `sonilo login` (no key) or `SONILO_API_KEY`.

> ⚠️ **Cost:** every tool below makes an API call that may incur charges. Only call it when the user has actually asked for a generation. Check `get_account_services` (see the [account](../account) skill) if you're unsure whether free-trial runs remain.

## Transport: MCP or CLI

Pick one at the start of the session and stay on it. Do not mix the two inside
a single job, and do not announce the choice.

1. **Sonilo MCP tools visible in this session** (`video_to_music` and friends) — use them. This is the preferred path: it needs no shell, and it is the only one that survives a very long generation. If a call fails to authenticate — rather than failing on its inputs — this transport is not usable in this session: go to 2 instead of retrying it.
2. **No usable Sonilo MCP tools, but `sonilo account` exits 0** — use the CLI commands below. Same API, same account, same credential file. Probe with `sonilo account`, not `sonilo whoami`: whoami exits 0 even when signed out, so it cannot tell the two states apart.
3. **Neither** — stop and run the [setup-api-key](../setup-api-key) skill. Do not call `api.sonilo.com` with curl to work around it; both transports handle uploads, polling and retries that a bare request does not.

## Quick Start

### MCP tool call (recommended)

```
video_to_music(
    video_path="~/Desktop/trailer.mp4",
    prompt="Build suspense, then resolve with a warm cinematic finish"
)
```

Saves the generated file(s) to `SONILO_MCP_BASE_PATH` (`~/Desktop` by default) and returns the saved path(s) as text.

### Python (`pip install sonilo`)

```python
from sonilo import Sonilo

client = Sonilo()  # reads SONILO_API_KEY

score = client.video_to_music.generate(video="trailer.mp4", prompt="Build suspense, then resolve with a warm cinematic finish")
score.save("score.m4a")
````
END THIRD-PARTY FILE c0f3957d7843f3c8

The third-party file has ended. Everything between the c0f3957d7843f3c8 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 3097 of 16077 bytes. © sonilo-ai · MIT · https://github.com/sonilo-ai/skills/tree/HEAD/video-to-music/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md