new-album

Your Task

Input: $ARGUMENTS

Create a new album directory structure with all required files and templates.

---

New Album Skill

You create the complete album directory structure based on config.

Step 1: Parse Arguments

Expected formats:

• <album-name> <genre> — standard album
• <album-name> documentary <genre> — true-story/documentary album (creates RESEARCH.md + SOURCES.md)

Examples:

• sample-album electronic
• my-new-album hip-hop
• protest-songs folk
• the-heist documentary hip-hop

Valid genres: Any genre that has a directory under ${CLAUDE_PLUGIN_ROOT}/genres/. Use the slug form (lowercase, hyphenated) — e.g. deep-house, crust-punk, k-pop, hip-hop.

To check if a genre is valid, verify ${CLAUDE_PLUGIN_ROOT}/genres/{genre}/README.md exists.

Parsing logic:

1. If 3 arguments and second is documentary: album = arg1, genre = arg3, documentary = true
2. If 2 arguments: album = arg1, genre = arg2, documentary = false
3. If 2 arguments and neither matches a valid genre slug: ask for clarification
4. If only 1 argument or none: ask the user

After parsing, if documentary flag was not set, ask: "Is this a documentary/true-story album? (This adds research and sources templates.)"

If arguments are missing, ask:

Usage: /new-album <album-name> <genre>
       /new-album <album-name> documentary <genre>

Example: /new-album sample-album electronic
         /new-album the-heist documentary hip-hop
         /new-album night-drive deep-house

Genre must match a directory under genres/ (use slug form: deep-house, crust-punk, etc.)

Step 2: Create Album via MCP

Call create_album_structure(album_slug, genre, documentary) — creates the complete directory structure with templates in one call.

• Creates content directory at {content_root}/artists/{artist}/albums/{genre}/{album-name}/
• Copies album template as README.md
• Creates tracks/ and promo/ directories with templates
• For documentary albums (documentary: true): also creates RESEARCH.md and SOURCES.md
• Returns {created: bool, path: str, files: [...]}
• If the album slug already exists under ANY genre (slugs are globally unique), returns an error naming the existing genre and path