- name
SKILL.md
Beceri dosyası yayıncının deposunda kalır.
Kopyalanan komutu bir terminale yapıştırın. Bu SKILL.md dosyasını ilgili ajana kurar.
npx skills add bitwize-music-studio/claude-ai-music-skills --skill import-audio -a cursor -yKopyalanan komutu bir terminale yapıştırın. Bu SKILL.md dosyasını ilgili ajana kurar.
npx skills add bitwize-music-studio/claude-ai-music-skills --skill import-audio -a claude-code -yKopyalanan komutu bir terminale yapıştırın. Bu SKILL.md dosyasını ilgili ajana kurar.
npx skills add bitwize-music-studio/claude-ai-music-skills --skill import-audio -a codex -yKopyalanan komutu bir terminale yapıştırın. Bu SKILL.md dosyasını ilgili ajana kurar.
npx skills add bitwize-music-studio/claude-ai-music-skills --skill import-audio -a grok -yKopyalanan mesajı bir Grok Bot sohbetinde gönderin. Bot bu SKILL.md dosyasını GitHub'dan alır ve tüm Bot'larınızın paylaştığı becerilere ekler.
Install this skill: https://github.com/bitwize-music-studio/claude-ai-music-skills/tree/HEAD/skills/import-audioYayıncıdan
Input: $ARGUMENTS
Import audio to the correct album location based on config — from a local file, or with --from-suno straight from Suno through its MCP server.
You put audio in the correct location in the user's audio directory. Two forms:
<file-path> <album-name> [track-slug]: Steps 1–5 below.--from-suno <album-name> <track> [--stems | --version instrumental] [--browser <app>]: skip to Importing From Suno.Expected format: <file-path> <album-name> [track-slug]
The track-slug is optional — only needed for stems zip imports when the track can't be inferred from the filename.
Examples:
~/Downloads/track.wav sample-album~/Downloads/03-t-day-beach.wav sample-album~/Downloads/stems.zip sample-album 01-first-tasteIf arguments are missing, ask:
Usage: /import-audio <file-path> <album-name> [track-slug]
Examples:
/import-audio ~/Downloads/track.wav sample-album
/import-audio ~/Downloads/stems.zip sample-album 01-first-taste
resolve_path("audio", album_slug) — returns the full audio directory path{audio_root}/artists/{artist}/albums/{genre}/{album}/Example result: ~/bitwize-music/audio/artists/bitwize/albums/hip-hop/sample-album/
CRITICAL: Always use resolve_path — never construct paths manually.
Check the file extension and whether it's a stems zip:
How to identify a stems zip: The user will say "stems" or the zip contains files like 0 Lead Vocals.wav, 1 Backing Vocals.wav, etc.
mkdir -p {resolved_path}
mv "{source_file}" "{resolved_path}/{filename}"
Stems must go into per-track subfolders to prevent filename collisions (every track has 0 Lead Vocals.wav, etc.):
{resolved_path}/
01-first-taste.wav
02-sugar-high.wav
stems/
01-first-taste/
0 Lead Vocals.wav
1 Backing Vocals.wav
2 Drums.wav
...
02-sugar-high/
0 Lead Vocals.wav
1 Backing Vocals.wav
...
Workflow:
01-first-taste-stems.zip → 01-first-taste)/import-audio stems.zip sample-album 01-first-taste)mkdir -p {resolved_path}/stems/{track-slug}
unzip "{source_file}" -d "{resolved_path}/stems/{track-slug}"
update_track_field(album_slug, track_slug, "stems", "Yes")Argument format for stems: <zip-path> <album-name> [track-slug]
Report:
Moved: {source_file}
To: {resolved_path}/{filename}
For stems:
Extracted stems: {source_file}
To: {resolved_path}/stems/{track-slug}/
Files: {count} stem files extracted
Updated: {track-slug} stems → Yes
--from-suno)Pulls a track's approved take from Suno through the Suno MCP server: the WAV, and with --stems the 12 stems, with no browser and no Downloads folder. Once the account's download credits run out, a Premier account can take the WAV from Suno Studio in the browser instead (step C2).
Costs, limits and the tool notes are in ${CLAUDE_PLUGIN_ROOT}/reference/suno/mcp-api-mapping.md. In short: the first download of a song uses one Suno download credit; every later download of it, in any format, and of its stems, is free. A take that was played in the terminal with /bitwize-music:listen has already used its credit.
Call get_suno_import_plan(album_slug, track_slug).
If wav.existing is set, a file is already imported for this track. Say which file and ask before replacing it.
--version instrumental imports the track's instrumental version instead of its keeper (/bitwize-music:edit-take <album> <track> instrumental makes one). Call get_suno_import_plan(album_slug, track_slug, version: "instrumental"): clip_id is the version row marked ✓ and wav.path is versions/<track>-instrumental.wav, a folder the mastering tools never read. no_version_takes → none has been made; no_version_keeper → ask the user to mark the one to keep; version_keeper_ambiguous → ask which. Then steps B, C and E; a version has no stems, so skip D. To release an instrumental, give it a track of its own.
Run § Preflight in the reference doc. If the server is not connected, give the setup command and stop — the file form of this skill still works for a manual download.
Keep two values from account-usage: the plan (suno_account.plan.name) and download_credits_remaining. With no download credits left, go straight to step C2.
Call audio-download(id: <clip_id>, format: "wav") without confirm.
Save the link to wav.path, exactly as the plan gave it:
mkdir -p "$(dirname "{wav.path}")" \
&& curl -fsSL --max-time 600 -o "{wav.path}.part" "{url}" \
&& mv "{wav.path}.part" "{wav.path}"
Quote the URL — it contains &. Links last an hour. If curl fails, remove the .part file and report the error.
Call get_suno_import_plan again and check that wav.existing is now the new file.
On a Premier plan the WAV can come from Suno Studio, in a real browser, instead of a download credit: when the user answers studio to the credit question in step C, and when no download credits are left. Suno's downloads FAQ says work downloads from Studio "without limitation", and one measured download spent no credit. That is Suno's word and one test, not a guarantee: say so. Spending the credit stays the default answer.
Check the plan. Studio comes with Premier only. If the plan isn't a Premier plan, say that Studio needs Premier, when the downloads reset (renews_on from account-usage), and that more downloads can be bought on suno.com. Stop.
Offer it when the credits have run out (after studio at the credit question, go straight to step 3): "You're out of Suno downloads. I can open the keeper in Suno Studio in your browser, and you download the WAV there. Suno says Studio downloads aren't limited." Stop unless the answer is yes.
Call audio-retrieve(id: <clip_id>) and keep title and metadata.duration. It is free.
Call open_in_studio(album_slug, track_slug, plan: <the plan name>), adding browser: <app> when the user gave --browser <app> (an app name or a path to one), and version as in step A. Pass on its note, if any. If browser comes back null, give the user url to open by hand. A refusal names the reason; report it and stop.
Tell the user next: in Studio's editor, select the song's whole waveform, then click Download .WAV.
Call find_studio_download(since: <opened_at>, title: <title>, expected_seconds: <duration>, wait_seconds: 120).
On yes, copy the file to wav.path from step A. The audio folder may be a network share, so copy, check, then remove:
--stems only)account-usage. If stems.exists is true, also say the stems folder already exists and will be overwritten. Stop unless the answer is yes.audio-stems-create(id: <clip_id>, mode: "twelve", idempotency_key: "{album_slug}/{track_slug}/stems/{UTC timestamp}"). Keep the id in the answer (stemgrp_...).audio-stems-retrieve(id: <clip_id>, group_id: <that id>) about every 20 seconds until status is no longer pending — usually one to two minutes. partial means some stems failed: say which, and carry on with the rest.take: 1, and say that take 2 exists. Never mix the two takes — they are separate renderings and do not sum together.audio-download(id: <the stem's audio_id>, format: "wav"). It answers ok once the song itself has been downloaded (step C did that). Handle processing and rate_limited as in step C. If it answers requires_credit, ask once — that one credit covers the song and every stem.stems.files[<the stem's name>], the same way as the WAV. The plan maps Suno's part names (vocals, backing_vocals, drums, ... fx) to the file names the mix tools expect.workspace, file the stems in it so they do not pile up in My Songs: workspaces-update-clips(id: <workspace.id>, add: [every stem's audio_id, both takes]) — 24 ids, under that tool's limit of 50. Check skipped. Filing is free.update_track_field(album_slug, track_slug, "stems", "Yes").Import all 12 files, including parts the song does not have: Suno returns those as near-silent stems, and /bitwize-music:mix-engineer skips them on its own.
Without a workspace the split leaves 24 stem songs loose in the user's Suno library. Mention it once.
Imported from Suno: [NN] [Title]
WAV: {wav.path}
Stems: {stems.dir} (12 files, take 1) — 24 stem songs filed in workspace "{workspace.name}"
Spent: 1 download credit, 50 song credits
Next: /bitwize-music:mix-engineer [album]
Leave out the lines that do not apply. After step C2, the Spent line reads Spent: no download credit (downloaded in Suno Studio).
Source file doesn't exist:
Error: File not found: {source_file}
Config file missing:
Error: Config not found at ~/.bitwize-music/config.yaml
Run /configure to set up.
File already exists at destination:
Warning: File already exists at destination.
Overwrite? (The original was not moved)
Suno allows downloading in both WAV and MP3 formats (WAV on Pro/Premier, web only). Always prefer WAV for mastering quality.
Downloads are metered since 2026-09-03. Free accounts get 7 lifetime trial downloads (personal use only — never releasable); Pro 20 a month; Premier 60 a month; the count resets on the billing date and does not roll over. One song is one download whatever the format, and its stems are included — download the WAV first, then pull stems later at no extra cost; re-downloading the same song is free. Premier accounts can also download from Suno Studio: Suno's downloads FAQ says Studio work downloads "without limitation", and one measured download spent no credit and arrived as a 16-bit, 48 kHz stereo WAV, the same format as a WAV from audio-download. Step C2 uses it once the credits run out. Commercial rights attach only to a permitted download made on a paid plan.
If the user provides an MP3 file:
Note: This is an MP3 file. For best mastering results, download the WAV
version from Suno instead. MP3 compression removes audio data that can't
be recovered during mastering.
If WAV isn't available, this MP3 will work but mastering quality may be limited.
Supported formats: WAV (preferred), MP3, FLAC, OGG, M4A
/import-audio ~/Downloads/03-t-day-beach.wav sample-album
Config has:
paths:
audio_root: ~/bitwize-music/audio
artist:
name: bitwize
Result:
Moved: ~/Downloads/03-t-day-beach.wav
To: ~/bitwize-music/audio/artists/bitwize/albums/hip-hop/sample-album/03-t-day-beach.wav
/import-audio --from-suno sample-album 03 --stems
Result:
Imported from Suno: 03 T-Day Beach
WAV: ~/bitwize-music/audio/artists/bitwize/albums/hip-hop/sample-album/03-t-day-beach.wav
Stems: ~/bitwize-music/audio/artists/bitwize/albums/hip-hop/sample-album/stems/03-t-day-beach/ (12 files, take 1)
Spent: 50 song credits
Next: /bitwize-music:mix-engineer sample-album
/import-audio ~/Downloads/stems.zip sample-album 01-first-taste
Result:
Extracted stems: ~/Downloads/stems.zip
To: ~/bitwize-music/audio/artists/bitwize/albums/hip-hop/sample-album/stems/01-first-taste/
Files: 5 stem files extracted
Updated: 01-first-taste stems → Yes
Wrong:
cat ~/.bitwize-music/config.yaml
mv file.wav ~/music-projects/audio/artists/bitwize/albums/electronic/sample-album/
Right:
# Use MCP to resolve the correct path
resolve_path("audio", album_slug) → returns full path with artist folder
Why it matters: resolve_path reads config, resolves variables, and includes the artist folder automatically. No manual config parsing or path construction needed.
Path comparison:
{content_root}/artists/{artist}/albums/{genre}/{album}/ (markdown, lyrics){audio_root}/artists/{artist}/albums/{genre}/{album}/ (WAV files, stems){documents_root}/artists/{artist}/albums/{genre}/{album}/ (PDFs, research)Use resolve_path with the appropriate path_type ("content", "audio", "documents") to get the right path.
Moves audio files to the correct album location with proper path structure, or pulls an approved take's WAV and stems straight from Suno. Use when the user has downloaded WAV files from Suno or other
---name: import-audiodescription: Moves audio files to the correct album location with proper path structure, or pulls an approved take's WAV…---# skills/import-audio/SKILL.mdGenel bakış
Moves audio files to the correct album location with proper path structure, or pulls an approved take's WAV and stems straight from Suno. Use when the user has downloaded WAV files from Suno or other sources that need to be organized, or wants to import the keeper, or its instrumental version, after approving a take.
SSS
skills/import-audio/SKILL.md dosyasını yayıncıdan indirin veya yolu kopyalayıp depoyu açın. PlugMCP beceriyi listeler, dosyayı barındırmaz.
Yayıncı bunu şurada tutuyor: https://github.com/bitwize-music-studio/claude-ai-music-skills.
Claude, Cursor, Codex ve Grok Build, yayıncının deposundan eklediğiniz bir SKILL.md dosyasını okuyabilir. Grok Bot, becerinin GitHub klasör bağlantısını bir sohbette gönderdiğinizde onu kurar.
mkdir -p "$(dirname "{wav.path}")" \
&& cp "{file}" "{wav.path}.part" \
&& mv "{wav.path}.part" "{wav.path}" \
&& cmp -s "{file}" "{wav.path}" \
&& rm "{file}"
If a step fails, leave the download where it is and report the error.
Carry on with step C.3. Skip --stems: a Studio download doesn't count as the song's download, so its stems wait until a download credit is free (one credit then covers the song and every stem). Studio's multitrack export names its files its own way, not as the mix tools expect.