# Music Intelligence

Run or inspect local music analysis and plan or apply beat-, downbeat-, or...

- Repository: https://github.com/0xsline/OpenChatCut (2832 stars)
- Category: Media
- License: AGPL-3.0
- Last updated: 2026-10-21
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add 0xsline/OpenChatCut --skill music-intelligence -g -a claude-code -y`
Codex: `npx skills add 0xsline/OpenChatCut --skill music-intelligence -g -a codex -y`
Cursor: `npx skills add 0xsline/OpenChatCut --skill music-intelligence -g -a cursor -y`
Gemini CLI: `npx skills add 0xsline/OpenChatCut --skill music-intelligence -g -a gemini-cli -y`

## Description

Run or inspect local music analysis and plan or apply beat-, downbeat-, or section-synced video cuts or photo placements. Use for BGM beat edits, rhythm cuts, 卡点剪辑, musical structure, BPM, mood, genre, or instrument questions.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Music Intelligence

1. Call `analyze_music` when the user asks to analyze music or no cache exists. It runs the installed local Beat This + CLAP models, waits for completion, and never downloads models; use `force:true` only for an explicit reanalysis request.
2. Call `inspect_music` when only the existing cache is needed.
3. Before cutting video, call `music_edit_plan` and show its bounded cut/target summary. Before placing photos, call `music_image_plan` and show its bounded placement summary. Prefer `timing:auto`; choose sparse, medium, or dense from the requested pace.
4. Only after the plan is accepted, call `sync_cuts_to_music` or `sync_images_to_music` with the returned `analysisRef`. Each tool recomputes the plan, rejects stale analysis, and applies its changes as one undo step.
5. If required model packs are missing, report the returned install guidance (Settings path + missing pack names), then ask whether to proceed with a `detect_beats` fallback for pure beat timing (BPM + beat frames only, no CLAP tags/sections/energy), or wait until the user installs the packs and retry `analyze_music` after installation.
6. Never request, return, quote, summarize, or place the CLAP embedding in model context. Use tags, sections, confidence, and the opaque `analysisRef` only.

## Preconditions

- Analysis is opt-in and on-device. The media-pool asset must already have a cache for its current `sourceRevision`.
- `rhythm-lite` supplies Beat This rhythm data; `music-semantics-lite` supplies CLAP tags and the private similarity vector.
- An Agent call must never install a pack, download a model, decode media, or start inference. Direct the user to Settings and the media-card analysis action when the cache is unavailable.

## Inspect

The rest: https://github.com/0xsline/OpenChatCut/blob/HEAD/src/agent/skills/music-intelligence/SKILL.md