Creates a new album with the correct directory structure and templates.

CC0-1.0Auto-check: notes

Install New Album

skills CLI
$ npx skills add bitwize-music-studio/claude-ai-music-skills --skill new-album -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install bitwize-music-studio/claude-ai-music-skills new-album --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/bitwize-music-studio/claude-ai-music-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/new-album .claude/skills/new-album && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
new-album
GitHub stars
544
Token cost
~1.6k tokens
SKILL.md length
349 words
Files
1
Skills in repo
51
Repo updated
First seen
Licence
CC0-1.0

At a glance

Creates a new album with the correct directory structure and templates.

  • Works in 3 steps: Parse Arguments → Create Album via MCP → Confirm
  • Says make a new album
  • SKILL.md covers Your Task, Step 1: Parse Arguments, Step 2: Create Album via MCP and Step 3: Confirm, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

New Album is an agent skill from bitwize-music-studio/claude-ai-music-skills. Creates a new album with the correct directory structure and templates. Use IMMEDIATELY when the user says 'make a new album' or similar, before any discussion.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Human + AI music production workflow for Suno - skills, templates, and tools. The licence is CC0-1.0.

When your agent uses it

  • Says make a new album
  • Before any discussion

Example prompts

  • “make a new album”
  • “Use the new-album skill to create a new album with the correct directory structure and templates”
  • “/new-album”

Requirements

  • Pre-approved tools (allowed-tools): Read, Bash, Write, bitwize-music-mcp

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Parse Arguments
  2. Create Album via MCP
  3. Confirm

What it can do on your machine

Read from SKILL.md and the folder at commit 58f32c2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Bash
    • Write
    • bitwize-music-mcp

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash and yaml).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

New Album loads about 1.6k tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 349 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Bash, Write, bitwize-music-mcp

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from bitwize-music-studio/claude-ai-music-skills at commit 58f32c2, republished under its CC0-1.0 licence (© bitwize-music-studio). 349 words, ~1,579 tokens.

Download SKILL.mdSave it as .claude/skills/new-album/SKILL.md (or your agent's skills folder).
name
new-album
description
Creates a new album with the correct directory structure and templates. Use IMMEDIATELY when the user says 'make a new album' or similar, before any discussion.
allowed-tools
Read, Bash, Write, bitwize-music-mcp
argument-hint
<album-name> <genre>
model
haiku

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

Note: Audio and documents directories are NOT created (those are created when needed by import-audio/import-art).

Step 3: Confirm

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.

Error Handling

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 (any genre — slugs are globally unique):

Error: Album slug '{album-name}' already exists under genre '{existing-genre}': {existing_path}

Album slugs are unique across all genres — choose a different name, or
rename the existing album with /bitwize-music:rename.

Templates not found:

Error: Templates not found. Is the plugin installed correctly?
Expected at: ${CLAUDE_PLUGIN_ROOT}/templates/

Examples

/new-album sample-album electronic

Config has:

yaml
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/

True Story Albums

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)

Common Mistakes

❌ Don't: Create directories manually

Wrong:

bash
# 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.

✅ Do: Use the specific genre slug

Any genre with a directory under genres/ is valid. Use the most specific genre that fits:

bash
/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

© bitwize-music-studio, CC0-1.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/new-album of bitwize-music-studio/claude-ai-music-skills.

Open the folder on GitHubat commit 58f32c2

Compare with similar skills

New Album next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

New Album compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
New Album this skillbitwize-music-studio/claude-ai-music-skills544—~1.6kAutomated safety check: NotesCC0-1.0
Correctcursor/plugins11k3 repos~612Automated safety check: PassNone
CorrectionNxcoreAI/EverRoom3k—~290Automated safety check: PassCustom licence
Directory Submissionscoreyhaines31/marketingskills54k2 repos~6.7kAutomated safety check: PassMIT
AI Music Albumnexu-io/open-design100k—~328Automated safety check: PassApache-2.0
Brilliant Directories AutomationComposioHQ/awesome-claude-skills77k3 repos~783Automated safety check: PassNone

Similar skills

  • Correct

    cursor/plugins

    Official

    Find the mistakes agents keep repeating in this repo and make each one impossible.

    11k GitHub starsUsed in 3 repos~612 tokens
    Auto-check passed
  • Correction

    NxcoreAI/EverRoom

    Compute Room overview corrections—citation corrections as per-claim edits and general corrections as a single proposal.

    3k GitHub stars~290 tokensUpdated 2 days ago
    Research & ScienceAuto-check passed
  • Directory Submissions

    coreyhaines31/marketingskills

    When the user wants to submit their product to startup, SaaS, AI, agent, MCP, no-code, or review directories for backlinks, domain rating, and discovery.

    54k GitHub starsUsed in 2 repos~6.7k tokens
    Marketing & SEOAuto-check passed
  • AI Music Album

    nexu-io/open-design

    Full-lifecycle AI music album production — concept, lyric drafting, track sequencing, and export.

    100k GitHub stars~328 tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Brilliant Directories Automation

    ComposioHQ/awesome-claude-skills

    Automate Brilliant Directories tasks via Rube MCP (Composio).

    77k GitHub starsUsed in 3 repos~783 tokens
    Productivity & AutomationAuto-check passed
  • SEO Directory Backlinks

    sickn33/agentic-awesome-skills

    Directory and backlink register: platform, domain, target URL, follow attribute, authority and spam scores, approval and NAP-match status.

    47k GitHub starsUsed in 1 repo~6.5k tokens
    Marketing & SEOAuto-check passed

More from bitwize-music-studio/claude-ai-music-skills

All 51 skills in this repo
  • Album Conceptualizer

    bitwize-music-studio/claude-ai-music-skills

    Designs album concepts, tracklist architecture, and thematic planning through 7 structured phases.

    544 GitHub stars~3.6k tokensUpdated 3 days ago
    Auto-check passed
  • Album Dashboard

    bitwize-music-studio/claude-ai-music-skills

    Shows a structured progress dashboard for an album with percentage complete per phase, blocking items, and status breakdown.

    544 GitHub stars~1.1k tokensUpdated 3 days ago
    Auto-check passed
  • Album Ideas

    bitwize-music-studio/claude-ai-music-skills

    Tracks and manages album ideas including brainstorming, planning, and status updates.

    544 GitHub stars~2.2k tokensUpdated 3 days ago
    Auto-check passed
  • Clipboard

    bitwize-music-studio/claude-ai-music-skills

    Copies track content (lyrics, style prompts, streaming lyrics) to the system clipboard.

    544 GitHub stars~1.4k tokensUpdated 3 days ago
    Auto-check: notes
  • Cloud Uploader

    bitwize-music-studio/claude-ai-music-skills

    Uploads promo videos and content to Cloudflare R2 or AWS S3.

    544 GitHub stars~2.1k tokensUpdated 3 days ago
    Auto-check: notes
  • Configure

    bitwize-music-studio/claude-ai-music-skills

    Sets up or edits the plugin configuration file interactively.

    544 GitHub stars~2.2k tokensUpdated 3 days ago
    Auto-check: notes

Questions about New Album

What does New Album do?

Creates a new album with the correct directory structure and templates. New Album is an agent skill from bitwize-music-studio/claude-ai-music-skills. Creates a new album with the correct directory structure and templates.

When should I use New Album?

New Album fits situations like: says make a new album; before any discussion.

How do I install New Album in Claude Code?

Run `npx skills add bitwize-music-studio/claude-ai-music-skills --skill new-album -a claude-code`. Or copy the skill folder (skills/new-album in bitwize-music-studio/claude-ai-music-skills) into .claude/skills/new-album in your project. Claude Code loads it when a task matches its description.

How do I install New Album in Codex?

Run `npx skills add bitwize-music-studio/claude-ai-music-skills --skill new-album -a codex`. Or copy the skill folder (skills/new-album in bitwize-music-studio/claude-ai-music-skills) into .agents/skills/new-album in your project. Codex loads it when a task matches its description.

Can I use New Album in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add bitwize-music-studio/claude-ai-music-skills --skill new-album -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/new-album, .gemini/skills/new-album, .github/skills/new-album and .opencode/skills/new-album in your project.

What does New Album need to run?

SKILL.md names no scripts, command-line tools or credentials: New Album is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Bash, Write, bitwize-music-mcp.

Does New Album access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is New Album safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does New Album use?

New Album is published under the CC0-1.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does New Album use?

About 1.6k tokens (SKILL.md is roughly 6.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to New Album?

Skills that share tags, products or a category with New Album: Correct (cursor/plugins, 11k stars), Correction (NxcoreAI/EverRoom, 3k stars), Directory Submissions (coreyhaines31/marketingskills, 54k stars) and AI Music Album (nexu-io/open-design, 100k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains New Album?

bitwize-music-studio (a GitHub organization) maintains it in bitwize-music-studio/claude-ai-music-skills, which has 544 GitHub stars. The repository holds 51 skills in this directory. The repository was last updated on October 7, 2026.

Source: bitwize-music-studio/claude-ai-music-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.