rename
The rename skill updates album or track metadata and file paths within a music studio repository, including slugs, display titles, and mirrored directories for content, audio, and documents. Use this when a user needs to change an album or track name while maintaining consistent naming across the system's directory structure and metadata files.
git clone --depth 1 https://github.com/bitwize-music-studio/claude-ai-music-skills /tmp/rename && cp -r /tmp/rename/skills/rename ~/.claude/skills/renameSKILL.md
## Your Task **Input**: $ARGUMENTS Rename an album or track using the MCP rename tools. --- # Rename Skill You rename albums or tracks, updating slugs, display titles, and all mirrored directory paths (content, audio, documents). ## Step 1: Parse Arguments Expected format: `<type> <current-name> <new-name>` Examples: - `album old-album-name new-album-name` - `track my-album 01-old-track 01-new-track` If arguments are missing or unclear, show usage: ``` Usage: /rename album <current-slug> <new-slug> /rename track <album-slug> <current-track-slug> <new-track-slug> Examples: /rename album my-old-album my-new-album /rename track my-album 01-old-name 01-new-name ``` ## Step 2: Verify Config via MCP Call `get_config()` to verify configuration is loaded. The MCP rename tools resolve paths internally, but config must be valid. ## Step 3: Confirm with User Before renaming, confirm the action: **For albums:** ``` Rename album 'old-name' -> 'new-name'? This will: - Move content directory - Move audio directory (if exists) - Move documents directory (if exists) - Update README.md title - Update state cache ``` **For tracks:** ``` Rename track 'old-name' -> 'new-name' in album 'album-name'? This will: - Rename track file - Update title in metadata table - Update state cache Note: Audio files are NOT renamed (they have Suno-generated names). ``` Wait for user confirmation before proceeding. ## Step 4: Invoke MCP Tool **For albums:** Use the `rename_album` MCP tool with: - `old_slug`: Current album slug - `new_slug`: New album slug - `new_title`: (optional) Custom display title **For tracks:** Use the `rename_track` MCP tool with: - `album_slug`: Album containing the track - `old_track_slug`: Current track slug - `new_track_slug`: New track slug - `new_title`: (optional) Custom display title ## Step 5: Report Results **Success:** ``` Renamed album 'old-name' -> 'new-name' Content directory: moved Audio directory: moved (or: no audio directory found) Documents directory: moved (or: no documents directory found) Tracks updated: N ``` **For tracks:** ``` Renamed track 'old-name' -> 'new-name' in album 'album-name' Old path: /path/to/old-file.md New path: /path/to/new-file.md Title updated to: "New Name" ``` ## Error Handling **Album/track not found:** ``` Error: Album 'name' not found. Available albums: album-1, album-2, album-3 ``` **New name already exists:** ``` Error: Album 'new-name' already exists. Choose a different name. ``` **Partial failure (album rename):** ``` Warning: Content directory renamed successfully, but: - Audio directory rename failed: [error] - Documents directory rename failed: [error] The content directory has been moved. Use rebuild_state to refresh the cache, then manually move any remaining directories. ```
Provides information about the bitwize-music plugin, its version, and its creator. Use when the user asks about the plugin, its purpose, version, or capabilities.
Creates visual concepts for album artwork and generates AI art prompts. Use during planning for concept discussion, or after all tracks are Final for actual artwork generation.
Designs album concepts, tracklist architecture, and thematic planning through 7 structured phases. Use when planning a new album or reworking an existing album concept.
Shows a structured progress dashboard for an album with percentage complete per phase, blocking items, and status breakdown. Use for a quick visual overview of album progress.
Tracks and manages album ideas including brainstorming, planning, and status updates. Use when the user wants to add, review, or organize their album idea backlog.
Copies track content (lyrics, style prompts, streaming lyrics) to the system clipboard. Use when the user needs to paste lyrics or style prompts into Suno or other external tools.
Uploads promo videos and content to Cloudflare R2 or AWS S3. Use when the user wants to host promo content for social media or distribution.
Sets up or edits the plugin configuration file interactively. Use on first-time setup, when config is missing, or when the user wants to change settings.