Agent skill

Music Intelligence

by 0xsline in 0xsline/OpenChatCut

Run or inspect local music analysis and plan or apply beat-, downbeat-, or section-synced video cuts or photo placements.

AGPL-3.0Auto-check passedMedia & Creative

Install Music Intelligence

skills CLI
$ npx skills add 0xsline/OpenChatCut --skill music-intelligence -a claude-code

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

GitHub CLI
$ gh skill install 0xsline/OpenChatCut music-intelligence --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/0xsline/OpenChatCut.git skills-src && mkdir -p .claude/skills && cp -r skills-src/src/agent/skills/music-intelligence .claude/skills/music-intelligence && 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/

Facts

Skill name
music-intelligence
GitHub stars
2.2k
Token cost
~1.1k tokens
SKILL.md length
623 words
Files
1
Skills in repo
31
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Run or inspect local music analysis and plan or apply beat-, downbeat-, or section-synced video cuts or photo placements.

  • Works in 6 steps: Call analyze_music when the user asks to… → Call inspect_music when only the… → Before cutting video, call… → …
  • Musical structure
  • SKILL.md covers Preconditions, Inspect, Plan and Photo placement, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Music Intelligence is an agent skill from 0xsline/OpenChatCut. 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.

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. The repository describes itself as: Open-source, local-first conversational AI video editor with a professional multi-track timeline, Agent Skills, MCP integration, and Remotion rendering. The licence is AGPL-3.0.

When your agent uses it

  • Musical structure
  • Instrument questions

Example prompts

  • “/music-intelligence”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  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…
  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…
  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…
  5. If required model packs are missing, report the returned install guidance (Settings path + missing pack names), then ask whether to…
  6. Never request, return, quote, summarize, or place the CLAP embedding in model context. Use tags, sections, confidence, and the opaque…

What it can do on your machine

Read from SKILL.md and the folder at commit 2e6f4a2. 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

    No scripts in the folder and no shell commands in SKILL.md.

    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

Music Intelligence loads about 1.1k tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 623 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~61
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 0xsline/OpenChatCut at commit 2e6f4a2, republished under its AGPL-3.0 licence (© 0xsline). 623 words, ~1,137 tokens.

Download SKILL.mdSave it as .claude/skills/music-intelligence/SKILL.md (or your agent's skills folder).
name
music-intelligence
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.
user-invocable
false

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

  • Identify the BGM by itemId, assetId, or an unambiguous name. Prefer the timeline item when the user intends to edit, because returned points are then mapped to timeline frames through the clip trim and playback rate.
  • inspect_music returns BPM, meter, confidence, tags, sections, counts, and bounded point lists. Lists are capped at 48 beats, 24 downbeats, 16 sections, and 12 tags; use a narrower range when truncated is true.
  • Treat analysisRef as opaque. It binds later planning and execution to the exact cached analysis without exposing the 512-value CLAP embedding.
Show full SKILL.md (280 more words)Show less

Plan

  • timing:auto chooses section → downbeat → beat for sparse edits, downbeat → beat → section for medium edits, and beat → downbeat → section for dense edits.
  • Density samples every fourth, second, or first candidate for sparse, medium, or dense respectively.
  • Plans are bounded to 96 cut frames and 64 overlapping video targets. Report the returned summary and any cap or locked-target warning before applying.
  • A plan targets video clips that overlap the selected BGM range. It must never include or mutate the BGM item itself.

Photo placement

  • music_image_plan uses explicitly listed image asset ids in their given order, or all image assets in media-pool order when omitted. It cycles that order when the music range has more beat intervals than images.
  • Each placement covers the complete interval from one selected timing point to the next, including the BGM range boundaries, so images are not appended with their source duration or placed at a uniform default length.
  • Image placement is bounded to 96 clips and 64 image assets. sync_images_to_music requires an unlocked, empty target video track for the requested range; choose another track instead of overwriting existing content.

Apply and recover

  • Pass the same itemId, timing, density, range, target ids, and analysisRef to sync_cuts_to_music. Execution recomputes the plan from current state; do not replay an old list of frames.
  • A missing or stale ref means the project or analysis changed. Call inspect_music, then music_edit_plan or music_image_plan, and ask for acceptance again.
  • Locked video tracks are skipped and reported. Never unlock a track implicitly.
  • Successful splits are submitted as one EditorCommands.batch, so the whole rhythm edit is one undo step.
  • Successful photo placements are submitted as one EditorCommands.batch, so the whole sequence is one undo step.

© 0xsline, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in src/agent/skills/music-intelligence of 0xsline/OpenChatCut.

Open the folder on GitHubat commit 2e6f4a2

Compare with similar skills

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

Music Intelligence compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Music Intelligence this skill0xsline/OpenChatCut2.2k—~1.1kAutomated safety check: PassAGPL-3.0
HyperFrames Animationheygen-com/hyperframes60k3 repos~2.1kAutomated safety check: PassApache-2.0
Stitch to Remotion Walkthrough Videosgoogle-labs-code/stitch-skills8.5k6 repos~3.2kAutomated safety check: NotesApache-2.0
Faceless Explainer Videoheygen-com/hyperframes60k3 repos~7.7kAutomated safety check: NotesApache-2.0
Video Understandcalesthio/OpenMontage66k—~841Automated safety check: PassAGPL-3.0
Video ShotcraftVincentwei1021/video-shotcraft11k—~2.6kAutomated safety check: PassApache-2.0

Similar skills

  • HyperFrames Animation

    heygen-com/hyperframes

    Collects motion rules, scene blueprints, transitions and runtime adapters for HyperFrames video compositions, with GSAP as the default animation runtime.

    60k GitHub starsUsed in 3 repos~2.1k tokens
    Media & CreativeAuto-check passed
  • Stitch to Remotion Walkthrough Videos

    google-labs-code/stitch-skills

    Official

    Builds walkthrough videos from Stitch design projects using Remotion, with transitions, zoom effects and text overlays on each screen.

    8.5k GitHub starsUsed in 6 repos~3.2k tokens
    Media & CreativeAuto-check: notes
  • Faceless Explainer Video

    heygen-com/hyperframes

    Turns an article, notes or a topic brief into an explainer video whose visuals are invented per scene, built frame by frame in HyperFrames with no footage.

    60k GitHub starsUsed in 3 repos~7.7k tokens
    Media & CreativeAuto-check: notes
  • Video Understand

    calesthio/OpenMontage

    Understand video content locally using ffmpeg frame extraction and Whisper transcription.

    66k GitHub stars~841 tokensUpdated 7 days ago
    Media & CreativeAuto-check passed
  • Video Shotcraft

    Vincentwei1021/video-shotcraft

    Makes cinematic product videos with Remotion from shot recipe cards, a ready template, real page screenshots, camera moves and sound design, or builds a single animated shot.

    11k GitHub stars~2.6k tokensUpdated 5 days ago
    Media & CreativeAuto-check passed
  • Figma to HyperFrames

    heygen-com/hyperframes

    Imports Figma assets, brand tokens, components and motion into a HyperFrames video composition, using the Figma REST API with a connector or native export for shaders.

    60k GitHub starsUsed in 3 repos~4.5k tokens
    Media & CreativeAuto-check: notes

More from 0xsline/OpenChatCut

All 31 skills in this repo
  • OpenChatCut Video Editing

    0xsline/OpenChatCut

    Connects an MCP-capable agent to the local OpenChatCut video editor to inspect and edit projects through draft edit sessions, with manual approval by default.

    2.2k GitHub starsUsed in 1 repo~655 tokens
    Auto-check passed
  • Video Shader Generator

    0xsline/OpenChatCut

    Generates WebGL shaders for video effects, transitions, masks and color grades in the OpenChatCut editor, trying built-in catalog effects such as zoom before making anything new.

    2.2k GitHub starsUsed in 1 repo~3.2k tokens
    Auto-check passed
  • AI Image Generation

    0xsline/OpenChatCut

    Generates still images through the submit_image tool, choosing among Fal.ai, gpt-image-2, nano-banana, MiniMax image-01 and Grok Imagine by configured keys.

    2.2k GitHub stars~1.3k tokensUpdated 3 days ago
    Auto-check passed
  • Livestream to Clips

    0xsline/OpenChatCut

    Cuts a livestream recording into evidence-backed, platform-ready clips by combining transcript, visual, audio and genre-specific signals.

    2.2k GitHub stars~2.7k tokensUpdated 3 days ago
    Auto-check passed
  • Music Generation

    0xsline/OpenChatCut

    Generates instrumentals, songs, soundtracks and covers through Mureka, MiniMax, Atlas Cloud or Sonilo using the `submit_music` tool.

    2.2k GitHub stars~1.1k tokensUpdated 3 days ago
    Auto-check passed
  • AI Video Generation

    0xsline/OpenChatCut

    Submits AI video generation jobs to Fal.ai, Seedance, Kling, MiniMax Hailuo, xAI Grok Imagine or OFox for text-to-video, image-to-video, transitions and clip extension.

    2.2k GitHub stars~4.3k tokensUpdated 3 days ago
    Auto-check passed

Questions about Music Intelligence

What does Music Intelligence do?

Run or inspect local music analysis and plan or apply beat-, downbeat-, or section-synced video cuts or photo placements. Music Intelligence is an agent skill from 0xsline/OpenChatCut. Run or inspect local music analysis and plan or apply beat-, downbeat-, or section-synced video cuts or photo placements.

When should I use Music Intelligence?

Music Intelligence fits situations like: musical structure; instrument questions.

How do I install Music Intelligence in Claude Code?

Run `npx skills add 0xsline/OpenChatCut --skill music-intelligence -a claude-code`. Or copy the skill folder (src/agent/skills/music-intelligence in 0xsline/OpenChatCut) into .claude/skills/music-intelligence in your project. Claude Code loads it when a task matches its description.

How do I install Music Intelligence in Codex?

Run `npx skills add 0xsline/OpenChatCut --skill music-intelligence -a codex`. Or copy the skill folder (src/agent/skills/music-intelligence in 0xsline/OpenChatCut) into .agents/skills/music-intelligence in your project. Codex loads it when a task matches its description.

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

What does Music Intelligence need to run?

SKILL.md names no scripts, command-line tools or credentials: Music Intelligence is instructions for the agent only.

Does Music Intelligence 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 Music Intelligence 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 Music Intelligence use?

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

How many tokens does Music Intelligence use?

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

Skills that share tags, products or a category with Music Intelligence: HyperFrames Animation (heygen-com/hyperframes, 60k stars), Stitch to Remotion Walkthrough Videos (google-labs-code/stitch-skills, 8.5k stars), Faceless Explainer Video (heygen-com/hyperframes, 60k stars) and Video Understand (calesthio/OpenMontage, 66k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Music Intelligence?

0xsline (a GitHub user) maintains it in 0xsline/OpenChatCut, which has 2,235 GitHub stars. The repository holds 31 skills in this directory. The repository was last updated on October 7, 2026.

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