From bitwize-music
Creates new album directory structure with README templates, tracks/promo folders, and optional RESEARCH/SOURCES for documentary albums by genre slug.
npx claudepluginhub bitwize-music-studio/claude-ai-music-skills --plugin bitwize-musicThis skill is limited to using the following tools:
**Input**: $ARGUMENTS
Creates isolated Git worktrees for feature branches with prioritized directory selection, gitignore safety checks, auto project setup for Node/Python/Rust/Go, and baseline verification.
Executes implementation plans in current session by dispatching fresh subagents per independent task, with two-stage reviews: spec compliance then code quality.
Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.
Input: $ARGUMENTS
Create a new album directory structure with all required files and templates.
You create the complete album directory structure based on config.
Expected formats:
<album-name> <genre> — standard album<album-name> documentary <genre> — true-story/documentary album (creates RESEARCH.md + SOURCES.md)Examples:
sample-album electronicmy-new-album hip-hopprotest-songs folkthe-heist documentary hip-hopValid 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:
documentary: album = arg1, genre = arg3, documentary = trueAfter 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.)
Call create_album_structure(album_slug, genre, documentary) — creates the complete directory structure with templates in one call.
{content_root}/artists/{artist}/albums/{genre}/{album-name}/tracks/ and promo/ directories with templatesdocumentary: true): also creates RESEARCH.md and SOURCES.md{created: bool, path: str, files: [...]}Note: Audio and documents directories are NOT created (those are created when needed by import-audio/import-art).
Report:
Created album: {album-name}
Location: {album_path}
Files created:
- README.md (album template)
- tracks/ (empty, ready for track files)
- promo/ (social media copy templates)
Next steps:
Option 1 - Interactive (Recommended):
Run /bitwize-music:album-conceptualizer to design your album concept
through the 7 Planning Phases.
Option 2 - Manual:
1. Edit README.md with your album concept
2. Create tracks with /import-track or manually in tracks/
Tip: For OST/soundtrack albums with a mix of vocal and instrumental
tracks, the album-conceptualizer will ask about the vocal/instrumental
split per track. Set `instrumental: true` in track frontmatter for
instrumental tracks — they skip the lyrics workflow and go directly
to /bitwize-music:suno-engineer.
Config file missing:
Error: Config not found at ~/.bitwize-music/config.yaml
Run /configure to set up.
Invalid genre:
Error: Invalid genre "{genre}"
No genre directory found at genres/{genre}/. Use a valid genre slug (e.g. hip-hop, deep-house, grindcore).
Check genres/INDEX.md for the full list.
Album already exists:
Error: Album already exists at {album_path}
Templates not found:
Error: Templates not found. Is the plugin installed correctly?
Expected at: ${CLAUDE_PLUGIN_ROOT}/templates/
/new-album sample-album electronic
Config has:
paths:
content_root: ~/bitwize-music
artist:
name: bitwize
Result:
Created album: sample-album
Location: ~/bitwize-music/artists/bitwize/albums/electronic/sample-album/
Files created:
- README.md (album template)
- tracks/ (empty, ready for track files)
Next steps:
Option 1 - Interactive (Recommended):
Run /bitwize-music:album-conceptualizer to design your album concept
through the 7 Planning Phases.
Option 2 - Manual:
1. Edit README.md with your album concept
2. Create tracks with /import-track or manually in tracks/
If user mentions this is a documentary or true-story album:
/new-album the-heist documentary hip-hop
The create_album_structure(album_slug, genre, documentary=true) call automatically creates RESEARCH.md and SOURCES.md from templates.
Report:
Created album: the-heist (documentary)
Location: ~/bitwize-music/artists/bitwize/albums/hip-hop/the-heist/
Files created:
- README.md (album template)
- RESEARCH.md (research template)
- SOURCES.md (sources template)
- tracks/ (empty, ready for track files)
Wrong:
# Manual mkdir, config reading, template copying
cat ~/.bitwize-music/config.yaml
mkdir -p ~/music-projects/artists/bitwize/albums/...
cp templates/album.md ...
Right:
# Single MCP call handles everything
create_album_structure(album_slug, genre, documentary)
The MCP tool reads config, resolves paths, creates directories, and copies templates automatically.
Any genre with a directory under genres/ is valid. Use the most specific genre that fits:
/new-album my-album boom-bap # has its own genre directory
/new-album my-album deep-house # specific subgenre
/new-album my-album grindcore # specific subgenre
/new-album my-album hip-hop # broad category also works