Moves audio files to the correct album location with proper path structure.

CC0-1.0Auto-check: notes

Install Import Audio

skills CLI
$ npx skills add bitwize-music-studio/claude-ai-music-skills --skill import-audio -a claude-code

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

GitHub CLI
$ gh skill install bitwize-music-studio/claude-ai-music-skills import-audio --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/bitwize-music-studio/claude-ai-music-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/import-audio .claude/skills/import-audio && 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
import-audio
GitHub stars
540
Token cost
~1.7k tokens
SKILL.md length
534 words
Files
1
Skills in repo
51
Repo updated
First seen
Licence
CC0-1.0

At a glance

Moves audio files to the correct album location with proper path structure.

  • Works in 5 steps: Parse Arguments → Resolve Audio Path via MCP → Detect File Type → …
  • The user has downloaded WAV files from Suno
  • SKILL.md covers Your Task, Step 1: Parse Arguments, Step 2: Resolve Audio Path via… and Step 3: Detect File Type, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Import Audio is an agent skill from bitwize-music-studio/claude-ai-music-skills. Moves audio files to the correct album location with proper path structure. Use when the user has downloaded WAV files from Suno or other sources that need to be organized.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with Suno. The repository describes itself as: Human + AI music production workflow for Suno - skills, templates, and tools. The licence is CC0-1.0.

When your agent uses it

  • The user has downloaded WAV files from Suno
  • Other sources that need to be organized

Example prompts

  • “Use the import-audio skill to move audio files to the correct album location with proper path structure”
  • “/import-audio”

Requirements

  • Pre-approved tools (allowed-tools): Read, Bash, bitwize-music-mcp

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Parse Arguments
  2. Resolve Audio Path via MCP
  3. Detect File Type
  4. Create Directory and Move File
  5. Confirm

What it can do on your machine

Read from SKILL.md and the folder at commit 58f32c2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Bash
    • bitwize-music-mcp

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash and yaml).

    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

Import Audio loads about 1.7k tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 534 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Bash, bitwize-music-mcp

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 bitwize-music-studio/claude-ai-music-skills at commit 58f32c2, republished under its CC0-1.0 licence (© bitwize-music-studio). 534 words, ~1,666 tokens.

Download SKILL.mdSave it as .claude/skills/import-audio/SKILL.md (or your agent's skills folder).
name
import-audio
description
Moves audio files to the correct album location with proper path structure. Use when the user has downloaded WAV files from Suno or other sources that need to be organized.
allowed-tools
Read, Bash, bitwize-music-mcp
argument-hint
<file-path> <album-name> [track-slug]
model
haiku

Your Task

Input: $ARGUMENTS

Import an audio file (WAV, MP3, etc.) to the correct album location based on config.


Import Audio Skill

You move audio files to the correct location in the user's audio directory.

Step 1: Parse Arguments

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-taste

If 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

Step 2: Resolve Audio Path via MCP

  1. Call resolve_path("audio", album_slug) — returns the full audio directory path
  2. The resolved path uses the mirrored structure: {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.

Step 3: Detect File Type

Check the file extension and whether it's a stems zip:

File TypeAction
.wav, .mp3, .flac, .ogg, .m4aMove to album audio dir (Step 4)
.zip (stems)Extract to per-track stems subfolder (Step 4b)

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.

Step 4: Create Directory and Move File

bash
mkdir -p {resolved_path}
mv "{source_file}" "{resolved_path}/{filename}"

Step 4b: Import Stems Zip

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:

  1. Determine the track slug from one of:
    • The zip filename if it matches a track pattern (e.g., 01-first-taste-stems.zip → 01-first-taste)
    • The user specifying which track (e.g., /import-audio stems.zip sample-album 01-first-taste)
    • If neither: Ask the user which track the stems belong to
  2. Extract into the per-track subfolder:
    bash
    mkdir -p {resolved_path}/stems/{track-slug}
    unzip "{source_file}" -d "{resolved_path}/stems/{track-slug}"
  3. Update track metadata: Call update_track_field(album_slug, track_slug, "stems", "Yes")

Argument format for stems: <zip-path> <album-name> [track-slug]

Step 5: Confirm

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

Error Handling

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)

Show full SKILL.md (245 more words)Show less

MP3 Files

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's Suno Studio exports are uncapped and arrive as 32-bit float / 48 kHz WAV — the practical route for a full album in one month. Commercial rights attach only to a permitted download made on a paid plan.

If the user provides an MP3 file:

  1. Accept the MP3 and import it normally (same path logic)
  2. Warn the user:
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.
  1. Import the file to the same destination path as WAV files

Supported formats: WAV (preferred), MP3, FLAC, OGG, M4A


Examples

/import-audio ~/Downloads/03-t-day-beach.wav sample-album

Config has:

yaml
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
Stems import example
/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

Common Mistakes

❌ Don't: Manually read config and construct paths

Wrong:

bash
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.

❌ Don't: Mix up content_root and audio_root

Path comparison:

  • Content: {content_root}/artists/{artist}/albums/{genre}/{album}/ (markdown, lyrics)
  • Audio: {audio_root}/artists/{artist}/albums/{genre}/{album}/ (WAV files, stems)
  • Documents: {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.

© bitwize-music-studio, CC0-1.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 skills/import-audio of bitwize-music-studio/claude-ai-music-skills.

Open the folder on GitHubat commit 58f32c2

Compare with similar skills

Import Audio 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.

Import Audio compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Import Audio this skillbitwize-music-studio/claude-ai-music-skills540—~1.7kAutomated safety check: NotesCC0-1.0
AI Media GeneratorHao0321/ai-media-generator258—~5.6kAutomated safety check: PassMIT
Mira Historysandeco/mira-animator218—~4kAutomated safety check: PassCustom licence
AI Music And Soundsocial-media-skills/skills128—~1.9kAutomated safety check: PassMIT
Prismer Songwriting And AI MusicPrismer-AI/PrismerCloud1.6k6 repos~2.9kAutomated safety check: PassMIT
Extensiondaiki-beppu/youtube-automation169—~520Automated safety check: PassCustom licence

Similar skills

  • AI Media Generator

    Hao0321/ai-media-generator

    為使用者產生高品質的 AI 生圖、生影片、生音樂提示詞,並在需要時透過瀏覽器自動化實際送到目標平台。涵蓋 OiiOii、Kling 3.0/O-series、Seedance 2.0/2.5、Suno v5.5、Seedream 5.0/4.0、Vidu Q3、Midjourney V8.1、Flux 1.1 Pro / Kontext、Runway Gen-4.5 /…

    258 GitHub stars~5.6k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed
  • Mira History

    sandeco/mira-animator

    Transforma o texto de uma história (normalmente infantil) numa animação narrada no Mira: cenas com câmera e clima, atores em SVG, narração, música e QR para o celular.

    218 GitHub stars~4k tokensUpdated 25 days ago
    Documents & OfficeAuto-check passed
  • AI Music And Sound

    social-media-skills/skills

    The AI music + sound-design skill for social -- original/licensed audio beds and sound design for Reels/TikToks/Shorts/videos.

    128 GitHub stars~1.9k tokensUpdated 8 days ago
    Media & CreativeAuto-check passed
  • Prismer Songwriting And AI Music

    Prismer-AI/PrismerCloud

    Songwriting craft and Suno AI music prompts. An agent skill from Prismer-AI/PrismerCloud.

    1.6k GitHub starsUsed in 6 repos~2.9k tokens
    Media & CreativeAuto-check passed
  • Extension

    daiki-beppu/youtube-automation

    A skill your agent uses when Chrome 拡張(suno-helper / distrokid-helper / community-helper)の導入・更新、または拡張向け collection server の起動・停止を行うとき。「拡張入れて」「extension 更新」「サーバー起動」で発動。排他的な --install / --update /…

    169 GitHub stars~520 tokensUpdated 2 days ago
    Auto-check passed
  • Music

    daiki-beppu/youtube-automation

    A skill your agent uses when 音楽制作を状態判定付きで一括実行または一段だけ実行するとき。Suno UI 投入用の Style / プロンプト生成は --prompt、Suno ボーカル曲の歌詞生成は --lyric、musicengine に応じた音源生成は --generate、Suno 音源の一括 DL とマスター化は --master…

    169 GitHub stars~1.4k tokensUpdated 2 days ago
    Auto-check passed

More from bitwize-music-studio/claude-ai-music-skills

All 51 skills in this repo
  • Album Conceptualizer

    bitwize-music-studio/claude-ai-music-skills

    Designs album concepts, tracklist architecture, and thematic planning through 7 structured phases.

    540 GitHub stars~3.6k tokensUpdated 2 days ago
    Auto-check passed
  • Album Dashboard

    bitwize-music-studio/claude-ai-music-skills

    Shows a structured progress dashboard for an album with percentage complete per phase, blocking items, and status breakdown.

    540 GitHub stars~1.1k tokensUpdated 2 days ago
    Auto-check passed
  • Album Ideas

    bitwize-music-studio/claude-ai-music-skills

    Tracks and manages album ideas including brainstorming, planning, and status updates.

    540 GitHub stars~2.2k tokensUpdated 2 days ago
    Auto-check passed
  • Clipboard

    bitwize-music-studio/claude-ai-music-skills

    Copies track content (lyrics, style prompts, streaming lyrics) to the system clipboard.

    540 GitHub stars~1.4k tokensUpdated 2 days ago
    Auto-check: notes
  • Cloud Uploader

    bitwize-music-studio/claude-ai-music-skills

    Uploads promo videos and content to Cloudflare R2 or AWS S3.

    540 GitHub stars~2.1k tokensUpdated 2 days ago
    Auto-check: notes
  • Configure

    bitwize-music-studio/claude-ai-music-skills

    Sets up or edits the plugin configuration file interactively.

    540 GitHub stars~2.2k tokensUpdated 2 days ago
    Auto-check: notes

Works with

Questions about Import Audio

What does Import Audio do?

Moves audio files to the correct album location with proper path structure. Import Audio is an agent skill from bitwize-music-studio/claude-ai-music-skills. Moves audio files to the correct album location with proper path structure.

When should I use Import Audio?

Import Audio fits situations like: the user has downloaded WAV files from Suno; other sources that need to be organized.

How do I install Import Audio in Claude Code?

Run `npx skills add bitwize-music-studio/claude-ai-music-skills --skill import-audio -a claude-code`. Or copy the skill folder (skills/import-audio in bitwize-music-studio/claude-ai-music-skills) into .claude/skills/import-audio in your project. Claude Code loads it when a task matches its description.

How do I install Import Audio in Codex?

Run `npx skills add bitwize-music-studio/claude-ai-music-skills --skill import-audio -a codex`. Or copy the skill folder (skills/import-audio in bitwize-music-studio/claude-ai-music-skills) into .agents/skills/import-audio in your project. Codex loads it when a task matches its description.

Can I use Import Audio 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 bitwize-music-studio/claude-ai-music-skills --skill import-audio -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/import-audio, .gemini/skills/import-audio, .github/skills/import-audio and .opencode/skills/import-audio in your project.

What does Import Audio need to run?

SKILL.md names no scripts, command-line tools or credentials: Import Audio is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Bash, bitwize-music-mcp.

Does Import Audio 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 Import Audio safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Import Audio use?

Import Audio is published under the CC0-1.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Import Audio use?

About 1.7k tokens (SKILL.md is roughly 6.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 Import Audio?

Skills that share tags, products or a category with Import Audio: AI Media Generator (Hao0321/ai-media-generator, 258 stars), Mira History (sandeco/mira-animator, 218 stars), AI Music And Sound (social-media-skills/skills, 128 stars) and Prismer Songwriting And AI Music (Prismer-AI/PrismerCloud, 1.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Import Audio?

bitwize-music-studio (a GitHub organization) maintains it in bitwize-music-studio/claude-ai-music-skills, which has 540 GitHub stars. The repository holds 51 skills in this directory. The repository was last updated on October 7, 2026.

Source: bitwize-music-studio/claude-ai-music-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.