# Rename

> Renames an album or track, updating slugs, titles, and all mirrored paths. Use when the user wants to rename an album or track.

- **Type:** Skill
- **Install:** `agentstack add skill-bitwize-music-studio-claude-ai-music-skills-rename`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [bitwize-music-studio](https://agentstack.voostack.com/s/bitwize-music-studio)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** CC0-1.0
- **Upstream author:** [bitwize-music-studio](https://github.com/bitwize-music-studio)
- **Source:** https://github.com/bitwize-music-studio/claude-ai-music-skills/tree/main/skills/rename
- **Website:** https://www.bitwizemusic.com

## Install

```sh
agentstack add skill-bitwize-music-studio-claude-ai-music-skills-rename
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

## 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: `  `

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  
  /rename track   

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

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [bitwize-music-studio](https://github.com/bitwize-music-studio)
- **Source:** [bitwize-music-studio/claude-ai-music-skills](https://github.com/bitwize-music-studio/claude-ai-music-skills)
- **License:** CC0-1.0
- **Homepage:** https://www.bitwizemusic.com

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-bitwize-music-studio-claude-ai-music-skills-rename
- Seller: https://agentstack.voostack.com/s/bitwize-music-studio
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.