Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add bitwize-music-studio/claude-ai-music-skills --skill rename -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/rename/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/rename/

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

Similar skills

All skills for Automation and no-code: n8n, Zapier, Make →

From the same set52

The whole set →
voice-checker The voice-checker skill scans song lyrics and prose for seven hallmarks of machine-generated text: stacked abstractions, over-explained metaphors, clichéd phrases, missing specifics, perfect grammar instead of natural speech. CX Codex +1 250installs import-track import-track moves track markdown files from Downloads or other locations into the correct album directory structure. Use it when track files are scattered and need to be organized by your project layout. CX Codex +1 250installs researchers-verifier researchers-verifier is a Claude Code skill that checks research sources, quotes, and claims before a person reviews the work. It produces a report of issues and warnings. CX Codex +1 249installs verify-sources verify-sources guides human review of track citations before Suno music generation. It extracts source links, awaits manual confirmation, and dates track records. CX Codex +1 249installs about The about skill displays the bitwize-music plugin version and creator details. Trigger it when you need to verify plugin capabilities or check which version is installed. CX Codex +1 248installs genre-creator The genre-creator skill builds documentation for a music genre and updates the library index and mastering presets. Use it when adding a genre to bitwize-music. CX Codex +1 248installs validate-album validate-album is a Claude Code skill that checks album directories, audio file paths, and track metadata before release. CX Codex +1 248installs researchers-financial researchers-financial is a Claude Code skill that researches financial records and market data for music projects about companies, financial crime, or market events. It gathers sources and marks claims for human review. CX Codex +1 248installs

Project sponsors

Companies that keep this analytics open