new-album
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.
Install / Use
npx skills add bitwize-music-studio/claude-ai-music-skills --skill new-albumInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
OtherSupported Platforms
Our assessment of new-album
new-album scores 90/100 on our quality scale, 109th of 328 Other skills we index (top 34%).
Its SKILL.md is 6.2 KB long, well organised into 13 sections with 14 code examples: a thorough specification that gives an agent plenty to work with.
It has 512 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so new-album is actively maintained.
- Our last check on 2026-10-30 found the source still online.
- It is released under the CC0-1.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-05. Automated pattern scan on 2026-10-05. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
new-album compared with similar skills
All 4 of these similar skills score higher than new-album; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| new-album (this skill)by bitwize-music-studio | 90 | 512 | 56d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 113.0k | 10d ago | CLAUDE.md |
| hyperframesby heygen-com | 100 | 86.4k | today | CLAUDE.md |
| rufloby ruvnet | 100 | 82.0k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 80.1k | today | CLAUDE.md |
Frequently asked questions
- How do I install new-album?
- Run
npx skills add bitwize-music-studio/claude-ai-music-skills --skill new-album. The install tabs above show the steps for each supported agent. - Which AI agents does new-album work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is new-album safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is CC0-1.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is new-album still maintained?
- The repository was last updated about 2 months ago, so new-album is actively maintained.
Skill content
View source on GitHubname: 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. argument-hint: <album-name> <genre> model: haiku allowed-tools:
- Read
- Bash
- Write
- bitwize-music-mcp
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 electronicmy-new-album hip-hopprotest-songs folkthe-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:
- If 3 arguments and second is
documentary: album = arg1, genre = arg3, documentary = true - If 2 arguments: album = arg1, genre = arg2, documentary = false
- If 2 arguments and neither matches a valid genre slug: ask for clarification
- 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/andpromo/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:
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:
# 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:
/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
Related Skills
Agent-Reach
113.0kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
hyperframes
86.4kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
ruflo
82.0k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
80.1kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
