rename — Claude Code skill: what it does, how to install
Renames music albums and tracks while synchronizing slugs, folder structures, and metadata. Handy for organizing studio catalog assets.
CC0-1.0 249 installs ★ 686 updated 2026-10-22
npx skills add bitwize-music-studio/claude-ai-music-skills --skill rename -a claude-codeWhat rename does
This skill manages renaming tasks across your music library. Renaming an album moves related directories for content, audio, and documents, edits the header in README.md, and updates state cache records. For single tracks, it adjusts the markdown note filename and table entries.
Execution relies entirely on bitwize-music-mcp. The skill runs get_config() to check the setup, shows an exact list of planned file operations, and asks for confirmation before altering anything on disk.
The workflow halts immediately without the bitwize-music-mcp tools configured. Individual track audio files are intentionally excluded from renaming to keep their generated Suno filenames intact.
What it helps with
- move album folders across content, audio, and documents
- update release titles in README.md and refresh state cache
- rename track markdown files and update metadata tables
Example prompts for the agent
- /rename album my-old-album my-new-album
- /rename track my-album 01-old-track 01-new-track
- Rename album ambient-session to ambient-volume-one
How to install rename
1Skills CLI (Vercel)
npx skills add bitwize-music-studio/claude-ai-music-skills --skill rename -a claude-code2Manually: put the files in place
~/.claude/skills/rename/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/rename/
1Skills CLI (Vercel)
npx skills add bitwize-music-studio/claude-ai-music-skills --skill rename -a codex2Manually: put the files in place
.agents/skills/rename/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add bitwize-music-studio/claude-ai-music-skills --skill rename -a cursor2Manually: put the files in place
.cursor/skills/rename/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install bitwize-music-studio/claude-ai-music-skills skills/rename2Manually: put the files in place
.github/skills/rename/SKILL.md1Skills CLI (Vercel)
npx skills add bitwize-music-studio/claude-ai-music-skills --skill rename -a gemini-cli2Platform CLI
gemini skills install https://github.com/bitwize-music-studio/claude-ai-music-skills --path skills/renameManually: put the files in place
.devin/skills/rename/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add bitwize-music-studio/claude-ai-music-skills --skill rename -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about rename
How to install rename in Claude Code?
Run npx skills add bitwize-music-studio/claude-ai-music-skills --skill rename -a claude-code in your terminal.
What does the rename skill do?
It renames albums and tracks, moving mirror directories and refreshing metadata caches after prompting for confirmation.
Does rename touch actual audio files?
No. Audio files keep their original Suno-generated names; the skill moves directory trees and modifies metadata documents.
Source text
SKILL.md · CC0-1.0
--- name: rename description: Renames an album or track, updating slugs, titles, and all mirrored paths. Use when the user wants to rename an album or track. argument-hint: <album|track> <current-name> <new-name> model: haiku allowed-tools: - Read - Bash - bitwize-music-mcp --- ## 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. ```
© bitwize-music-studio · CC0-1.0 · bitwize-music-studio/claude-ai-music-skills