music-matcher

Analyze videos into mood segments, match music via MCP, and compose synchronized final videos.

2|1|Updated Apr 18, 2026
One-click install
npx skills add https://github.com/littlewwwhite/AgentOS-TS --skill music-matcher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: music-matcher
Source: https://github.com/littlewwwhite/AgentOS-TS/tree/main/.claude/skills/music-matcher
Command: npx skills add https://github.com/littlewwwhite/AgentOS-TS --skill music-matcher

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires google-genai, python-dotenv, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Music-matcher automates the end-to-end workflow for mood-based video scoring: analyzing videos to identify segments, selecting matching music via MCP, and synthesizing the final video with audio.

Core Features & Use Cases

  • Automated mood-based music matching for individual videos or batches.
  • Deterministic output with reproducible results and resuming from partial runs.
  • Phase-based workflow including Gemini analysis, MCP matching, and FFmpeg-based composition, with single-video and batch modes.

Quick Start

Run the music-matcher workflow to analyze a video, perform MCP matching, and output a composed video with music.

Frequently Asked Questions about music-matcher

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

FAQPage Schema
How do I automatically match background music to video mood?

AI-assisted music matching analyzes videos to extract mood-based segments, then uses the MCP protocol to select the best music for each segment before composing a final video with synchronized audio.

How does AI video scoring work with Gemini and FFmpeg?

AI video scoring works with Gemini and FFmpeg by using Gemini to analyze and extract mood-based segments from the video, MCP to match music to those segments, and FFmpeg to synthesize the final composed video with synchronized audio.

Can I batch process multiple videos for automated music matching?

Yes, you can batch process multiple videos for automated music matching. The workflow supports batch processing and provides incremental outputs, allowing you to resume from partial runs for deterministic and reproducible results.

Do I need google-genai and python-dotenv to run AI-assisted video production?

Yes, you need google-genai and python-dotenv dependencies to run this AI-assisted video production workflow, as they facilitate the Gemini-based video analysis phase and environment configuration required for mood-based music matching.

What is the best way to synchronize audio with video segments using MCP?

The best way to synchronize audio with video segments using MCP is through a phase-based workflow that extracts mood-based video segments, matches music via MCP, and uses FFmpeg to compose a final video with perfectly synchronized audio.

Why does my batch video music matching not resume after interruption?

Batch video music matching should resume after interruption because the workflow supports resuming from partial runs with deterministic output, ensuring reproducible results across large video processing batches without losing progress.