music-intelligence

Analyze local music and sync video cuts or photo placements to beats and sections.

1.5k|218|Updated Jul 15, 2026
One-click install
npx skills add https://github.com/0xsline/OpenChatCut --skill music-intelligence
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: music-intelligence
Source: https://github.com/0xsline/OpenChatCut/tree/main/src/agent/skills/music-intelligence
Command: npx skills add https://github.com/0xsline/OpenChatCut --skill music-intelligence

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually aligning video cuts or photo placements to the rhythm of background music is tedious and imprecise. This Skill runs on-device music analysis and plans beat-, downbeat-, or section-synced edits so rhythm cuts and photo sequences land exactly on musical timing points.

Core Features & Use Cases

  • Local Music Analysis: Runs installed Beat This and CLAP models on-device to extract BPM, meter, tags, sections, and beat positions without downloading models or sending data externally.
  • Rhythm-Synced Video Cuts: Plans bounded cut points at sparse, medium, or dense density, then applies them as a single undo step via sync_cuts_to_music.
  • Beat-Synced Photo Placement: Places image assets across complete beat intervals in the BGM range, cycling image order when there are more intervals than images.
  • Use Case: A user drops a BGM track into the timeline and asks for a 卡点剪辑 (beat-cut edit). The Skill analyzes the track, proposes a cut plan summary, and after acceptance applies all splits as one undoable batch.

Quick Start

Analyze the background music in my media pool and cut the video clips on the timeline to its beats at medium density.

Frequently Asked Questions about music-intelligence

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

FAQPage Schema
How do I sync video cuts to music beats automatically?

Run music analysis on the BGM asset, then request a beat-synced edit plan at sparse, medium, or dense density. After reviewing the bounded cut summary, the cuts are applied to overlapping video clips as one undo step.

How to place photos on beat intervals in a video timeline?

Provide image asset ids in order, or let the tool use all media-pool images. Each image covers the full interval between consecutive timing points, cycling the image order when the music range has more intervals than images.

Does music analysis upload my audio to the cloud?

No. Analysis is opt-in and fully on-device using locally installed Beat This and CLAP model packs. The agent never downloads models, decodes media, or starts inference; missing packs must be installed through Settings.

What music information can I inspect from an analyzed track?

Inspection returns BPM, meter, confidence, tags, sections, and bounded point lists capped at 48 beats, 24 downbeats, 16 sections, and 12 tags. The CLAP embedding itself is never exposed; only an opaque analysisRef is used.

Why did my beat-sync edit fail with a stale analysis error?

A stale or missing analysisRef means the project or cached analysis changed after planning. Re-inspect the music, regenerate the edit plan, and confirm the new summary before applying cuts again.

What are the limits of beat-synced editing plans?

Plans are bounded to 96 cut frames and 64 overlapping video targets, or 96 clips and 64 image assets for photo placement. Locked tracks are skipped and reported, and image placement requires an empty unlocked target track.