Agent skill

Music Edit To Length

by BlackBeltTechnology in BlackBeltTechnology/pi-agent-dashboard

Cut a music track to a target length on its downbeat grid with scored, click-free joins, writing <out.wav and a video-time beat grid (<outedit.json, schema music-edit/1).

MITAuto-check passed

Install Music Edit To Length

skills CLI
$ npx skills add BlackBeltTechnology/pi-agent-dashboard --skill music-edit-to-length -a claude-code

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

GitHub CLI
$ gh skill install BlackBeltTechnology/pi-agent-dashboard music-edit-to-length --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/BlackBeltTechnology/pi-agent-dashboard.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/music-production/.pi/skills/music-edit-to-length .claude/skills/music-edit-to-length && 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-edit-to-length
GitHub stars
315
Token cost
~1.2k tokens
SKILL.md length
526 words
Files
3 (incl. scripts)
Skills in repo
70
Repo updated
First seen
Licence
MIT

At a glance

Cut a music track to a target length on its downbeat grid with scored, click-free joins, writing <out.wav and a video-time beat grid (<outedit.json, schema music-edit/1).

  • Works in 8 steps: Analyse — music-analysis →… → Identify blocks — mark the sections and… → Score joins — → …
  • SKILL.md covers Procedure, Splice rules, The edit contract —… and Verification
  • Runs Python scripts from its folder; calls python and jq

What it does

Music Edit To Length is an agent skill from BlackBeltTechnology/pi-agent-dashboard. Cut a music track to a target length on its downbeat grid with scored, click-free joins, writing <out.wav and a video-time beat grid (<outedit.json, schema music-edit/1). Use on "cut the music to 90 seconds", "fit the track to the video", "shorten this song on the beat", "re-cut the music edit".

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including scripts (for example `scripts/edit_music.py` and `scripts/score_joins.py`).

The repository describes itself as: Real-time web dashboard for pi coding-agent sessions. Multi-session view, live chat mirroring, integrated terminal, diff viewer, pi-flows execution, and mobile-first remote… The licence is MIT.

Example prompts

  • “cut the music to 90 seconds”
  • “fit the track to the video”
  • “shorten this song on the beat”
  • “/music-edit-to-length”

Requirements

  • Python 3

Workflow steps

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

  1. Analyse — music-analysis → track_map.json. Read the sections, classes and
  2. Identify blocks — mark the sections and genre/energy blocks (e.g. tech-house
  3. Score joins —
  4. Render —
  5. Click check — every join reports click_ok; the script warns on stderr when a
  6. Preview — the .m4a is written next to the wav.
  7. Listen before lock — ask the user to listen to the .m4a before the picture
  8. Iterate — keep every rejected version with a _vN suffix

What it can do on your machine

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

    Ships 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • jq

    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 Edit To Length loads about 1.2k tokens when it runs. Until then it costs about 80 tokens; SKILL.md has 526 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~80
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from BlackBeltTechnology/pi-agent-dashboard at commit 7a2d171, republished under its MIT licence (© BlackBeltTechnology). 526 words, ~1,168 tokens.

Download SKILL.mdSave it as .claude/skills/music-edit-to-length/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
music-edit-to-length
description
Cut a music track to a target length on its downbeat grid with scored, click-free joins, writing <out>.wav and a video-time beat grid (<out>_edit.json, schema music-edit/1). Use on "cut the music to 90 seconds", "fit the track to the video", "shorten this song on the beat", "re-cut the music edit".

music-edit-to-length

Input: a music-map/1 from music-analysis (run it first). Output: <out>.wav, <out>_edit.json and, with --preview, <out>.m4a for listening. The edit file feeds beat-sync-video and the picture edit.

Scripts run in the quick-tier venv (.venv-music, see music-analysis step 0); PKG=<this skill dir>/../../...

Procedure

  1. Analyse — music-analysis → track_map.json. Read the sections, classes and drop candidates; confirm the drop by ear.
  2. Identify blocks — mark the sections and genre/energy blocks (e.g. tech-house groove bars 1–32, trance breakdown/build 33–65, groove again 66–105). Joins may only connect material from the same block family.
  3. Score joins —
    bash
    .venv-music/bin/python "$PKG/.pi/skills/music-edit-to-length/scripts/score_joins.py" track_map.json \
        --candidates auto --target-duration 90 --anchor-bar 66
    .venv-music/bin/python "$PKG/.pi/skills/music-edit-to-length/scripts/score_joins.py" track_map.json --from-bar 12 --to-bar 17
    A join plays through the end of bar A and continues at bar B. Per factor: chroma and timbre similarity of the outgoing bars A−1..A against B's run-up in the source (B−2..B−1 — a match means the music arrives where B expects it), level jump, section_boundary, class_change. score = 0.4·chroma + 0.4·timbre − 0.02·|jump dB| − 0.5·[groove/drop ↔ breakdown/build] + 0.1·[section boundary]. Prefer ≥ 0.75 with no class change. The score is advisory: automatic classes cannot always tell a genre boundary (a trance build and a tech-house groove both have drums and bass) — your block marking in step 2 decides.
  4. Render —
    bash
    .venv-music/bin/python "$PKG/.pi/skills/music-edit-to-length/scripts/edit_music.py" track.wav music/track_edit90 \
        1:13 17:25 25:33 66:82 102:197.0 --preview
    The map defaults to <audio stem>_map.json next to the audio; pass --map music/track_map.json when it lives elsewhere (e.g. after analyze_music.py --out-dir). Segments are 1-based start_bar:end where end is an exclusive bar, END, or seconds with a decimal point. Joins are 30 ms equal-power crossfades.
  5. Click check — every join reports click_ok; the script warns on stderr when a join's sample step exceeds 1.1× the source at the same bar. Pick another join or keep the crossfade (--no-xfade is diagnostic only).
  6. Preview — the .m4a is written next to the wav.
  7. Listen before lock — ask the user to listen to the .m4a before the picture edit is locked to downbeats_video. Do not sync video to an unapproved edit.
  8. Iterate — keep every rejected version with a _vN suffix (track_edit90_v1.wav + _v1_edit.json) and write a one-line note of the rejection reason next to it (README/AGENTS row), e.g. "v2 rejected: jumps from tech-house groove into the trance build at 0:31".
Show full SKILL.md (184 more words)Show less

Splice rules

  • Fixed drop anchor — the drop is the fixed anchor on the video timeline; cut before and after it, never move it.
  • Enter at section boundaries — enter only at a section boundary or at a repeated-block boundary (same 4/8-bar phrase position).
  • No genre boundary — never splice across a genre or energy boundary (for example from a tech-house groove into a trance build), however good the similarity numbers look.
  • Trailing silence is trimmed automatically (≥ 1 s below −50 dBFS → 50 ms + fade).

The edit contract — music-edit/1 (video time)

FieldMeaning
schema"music-edit/1"
source, audio, mapsource audio, edited wav, source map — relative to the edit file
bpm, meter, durationfrom the map; duration of the edited audio
segments[] {start_bar, end_bar | end_s, music_from, music_to, video_at}source span → video position
joins[] {video_at, source_bar, score, click_ok}one per join
downbeats_video[]the video-time downbeat grid (first entry 0.0)

A source time s inside segment i maps to video_at_i + (s − music_from_i); source times outside every segment are cut out.

Verification

  • click_ok true for every join; the .m4a approved by the user.
  • jq '.duration, (.downbeats_video | length)' <out>_edit.json matches the target.

© BlackBeltTechnology, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (scripts) in packages/music-production/.pi/skills/music-edit-to-length of BlackBeltTechnology/pi-agent-dashboard.

  • SKILL.md
  • scripts/edit_music.py
  • scripts/score_joins.py

Open the folder on GitHubat commit 7a2d171

Compare with similar skills

Music Edit To Length 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 Edit To Length compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Music Edit To Length this skillBlackBeltTechnology/pi-agent-dashboard315—~1.2kAutomated safety check: PassMIT
Music to Videoheygen-com/hyperframes60k3 repos~4.7kAutomated safety check: NotesApache-2.0
Lengththedaviddias/Front-End-Checklist74k—~764Automated safety check: PassMIT
MiniMax Music Generationbytedance/deer-flow84k—~717Automated safety check: PassMIT
Venice Audio Musicnexu-io/open-design100k—~297Automated safety check: PassApache-2.0
AI Music Albumnexu-io/open-design100k—~328Automated safety check: PassApache-2.0

Similar skills

  • Music to Video

    heygen-com/hyperframes

    Turns a music track into a beat-synced HyperFrames video such as a lyric video, slideshow or kinetic promo, with any supplied images or clips cut onto the beat grid.

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

    thedaviddias/Front-End-Checklist

    A skill your agent uses when generating URL slugs from article titles, auditing URL structures for unnecessary depth or length, or reviewing URL patterns in a CMS or router configuration.

    74k GitHub stars~764 tokensUpdated 4 days ago
    Frontend & DesignAuto-check passed
  • MiniMax Music Generation

    bytedance/deer-flow

    Generates songs, jingles or instrumental tracks as MP3 files from a style prompt and optional lyrics through the MiniMax music API.

    84k GitHub stars~717 tokensUpdated today
    Media & CreativeAuto-check passed
  • Venice Audio Music

    nexu-io/open-design

    Music generation queueing, retrieval, and completion endpoints via Venice.ai.

    100k GitHub stars~297 tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • AI Music Album

    nexu-io/open-design

    Full-lifecycle AI music album production — concept, lyric drafting, track sequencing, and export.

    100k GitHub stars~328 tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Music Generation Studio

    sickn33/agentic-awesome-skills

    Install and use the official AI Music Generator package, pinned by digest, for paid hosted work on the Beatra service.

    47k GitHub starsUsed in 1 repo~3.1k tokens
    Media & CreativeAuto-check passed

More from BlackBeltTechnology/pi-agent-dashboard

All 70 skills in this repo
  • Browser

    BlackBeltTechnology/pi-agent-dashboard

    Browser automation via the agent-browser CLI. An agent skill from BlackBeltTechnology/pi-agent-dashboard.

    316 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • CI Troubleshoot

    BlackBeltTechnology/pi-agent-dashboard

    Diagnose failed GitHub Actions runs for pi-agent-dashboard: the 11-file workflow taxonomy, affected-test selection, the release pipeline, known failure modes, and how to read gh run logs and…

    316 GitHub stars~3.5k tokensUpdated today
    Auto-check passed
  • Debug Dashboard

    BlackBeltTechnology/pi-agent-dashboard

    Diagnose problems in the running pi-agent-dashboard system: server.log, /api/health, bridge WebSocket connectivity, vitest triage, known-issue FAQ entries.

    316 GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Implement

    BlackBeltTechnology/pi-agent-dashboard

    Disciplined implementation in pi-agent-dashboard: the rebuild matrix (extension→reload, server→restart, client→build+restart, openspec-apply→full rebuild) plus the project's code discipline rules.

    316 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Pi Dashboard

    BlackBeltTechnology/pi-agent-dashboard

    Monitor and control the pi-dashboard server. An agent skill from BlackBeltTechnology/pi-agent-dashboard.

    316 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Session To Guideline

    BlackBeltTechnology/pi-agent-dashboard

    Turn a pi session into a Markdown "how-we-did-it" collaboration guideline: reads the session's JSONL transcript and synthesizes a reusable playbook of which prompts worked, what had to be steered…

    316 GitHub stars~3.2k tokensUpdated today
    Auto-check passed

Questions about Music Edit To Length

What does Music Edit To Length do?

Cut a music track to a target length on its downbeat grid with scored, click-free joins, writing <out.wav and a video-time beat grid (<outedit.json, schema music-edit/1). Music Edit To Length is an agent skill from BlackBeltTechnology/pi-agent-dashboard.json, schema music-edit/1).

How do I install Music Edit To Length in Claude Code?

Run `npx skills add BlackBeltTechnology/pi-agent-dashboard --skill music-edit-to-length -a claude-code`. Or copy the skill folder (packages/music-production/.pi/skills/music-edit-to-length in BlackBeltTechnology/pi-agent-dashboard) into .claude/skills/music-edit-to-length in your project. Claude Code loads it when a task matches its description.

How do I install Music Edit To Length in Codex?

Run `npx skills add BlackBeltTechnology/pi-agent-dashboard --skill music-edit-to-length -a codex`. Or copy the skill folder (packages/music-production/.pi/skills/music-edit-to-length in BlackBeltTechnology/pi-agent-dashboard) into .agents/skills/music-edit-to-length in your project. Codex loads it when a task matches its description.

Can I use Music Edit To Length 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 BlackBeltTechnology/pi-agent-dashboard --skill music-edit-to-length -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-edit-to-length, .gemini/skills/music-edit-to-length, .github/skills/music-edit-to-length and .opencode/skills/music-edit-to-length in your project.

What does Music Edit To Length need to run?

Going by SKILL.md and its folder, Music Edit To Length needs Python for the scripts in its folder and the command-line tools its instructions call (python and jq). Our summary lists: Python 3.

Does Music Edit To Length 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 Edit To Length 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Music Edit To Length use?

Music Edit To Length is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Music Edit To Length use?

About 1.2k tokens (SKILL.md is roughly 4.7k 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 Edit To Length?

Skills that share tags, products or a category with Music Edit To Length: Music to Video (heygen-com/hyperframes, 60k stars), Length (thedaviddias/Front-End-Checklist, 74k stars), MiniMax Music Generation (bytedance/deer-flow, 84k stars) and Venice Audio Music (nexu-io/open-design, 100k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Music Edit To Length?

BlackBeltTechnology (a GitHub organization) maintains it in BlackBeltTechnology/pi-agent-dashboard, which has 315 GitHub stars. The repository holds 70 skills in this directory. The repository was last updated on October 10, 2026.

Source: BlackBeltTechnology/pi-agent-dashboard on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.