К основному содержанию
скилл CX Codex

new-album — скилл для Claude Code: что делает и как установить

Скилл new-album разворачивает каталоги и шаблоны нового музыкального альбома по заданному жанру через вызов инструмента MCP.

CC0-1.0 252 установок ★ 686 обновлён 2026-10-22

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add bitwize-music-studio/claude-ai-music-skills --skill new-album -a claude-code
Открыть на GitHub

Что делает new-album

Скилл принимает название релиза и жанр, проверяя наличие соответствующего каталога внутри genres/. Для документальных альбомов или историй на реальных событиях поддерживается флаг documentary, который добавляет шаблоны RESEARCH.md и SOURCES.md.

Вся файловая структура формируется за один шаг через инструмент bitwize-music-mcp. В директории артиста создаются README.md с описанием релиза, папка tracks/ для треков и каталог promo/ под материалы для соцсетей.

Без файла конфигурации ~/.bitwize-music/config.yaml скилл выдаёт ошибку и останавливает работу. Имя альбома не должно дублироваться в других жанрах: если такой слаг уже существует в проекте, утилита откажется создавать новую запись.

Какие задачи решает

  • создать структуру папок и шаблоны для нового альбома
  • добавить файлы исследования источников для документального релиза
  • проверить корректность жанра по каталогу системы
  • исключить повторение слагов релизов между жанрами

Примеры запросов агенту

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

Как установить new-album

1Через Skills CLI (Vercel)

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

2Вручную: положить файлы

~/.claude/skills/new-album/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/new-album/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о new-album

Как установить new-album в Claude Code?

Выполните команду npx skills add bitwize-music-studio/claude-ai-music-skills --skill new-album -a claude-code.

Что делает скилл new-album?

Он обращается к инструменту MCP и разворачивает дерево папок релиза с шаблоном README.md, каталогом треков и промо-шаблонами.

Что нужно подготовить перед запуском?

Требуется настроенный файл ~/.bitwize-music/config.yaml и доступ к инструменту bitwize-music-mcp.

Исходный текст

SKILL.md · CC0-1.0
---
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.
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 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 · bitwize-music-studio/claude-ai-music-skills

Похожие скиллы

Все скиллы по теме «Заметки, задачи и проекты» →
ai-music-album nexu-io Скилл ai-music-album для Claude Code ведёт цикл создания музыкального альбома: от концепта и текстов до треклиста и экспорта. Включает работу над инди-релизами и брендовыми саундтреками. CX Codex +1 2 900установок album-cover-generation eachlabs Скилл album-cover-generation рисует обложки для альбомов, синглов и EP через each::sense: задаёте звучание и палитру, получаете картинку в нужном размере. CX Codex +1 220установок openspec-new-change openspec Скилл openspec-new-change для Claude Code создаёт новые изменения через рабочий процесс OpenSpec. Формирует каталог изменения, проверяет статус артефактов и показывает инструкции для первого шага. CX Codex +1 3 800установок brainstorm-ideas-new phuryn Скилл brainstorm-ideas-new генерирует идеи фич для нового продукта с позиций менеджера, дизайнера и инженера. Пригодится на этапе раннего дискавери и проверки гипотез стартапа. CX Codex +1 3 600установок identify-assumptions-new phuryn Скилл identify-assumptions-new для Claude Code анализирует предположения о новой продуктовой идее по 8 категориям рисков и выдаёт таблицу с оценкой уверенности и тестами. CX Codex +1 3 100установок gsd-new-project open-gsd Скилл gsd-new-project для Claude Code инициализирует новый проект через сбор контекста и создаёт файл .planning/PROJECT.md. CX Codex +1 589установок

Из того же набора52

Весь набор →
researcher Скилл researcher для Claude Code собирает первоисточники, проверяет факты по трём и более независимым источникам и строит цепочки доказательств. Даёт фактологию с цитатами и ссылками. CX Codex +1 253установок researchers-tech Скилл researchers-tech для Claude Code собирает сведения об истории открытых проектов, интервью разработчиков и технической документации. Находит факты о происхождении, авторах и эволюции технологий. CX Codex +1 253установок help Скилл help для Claude Code показывает каталог команд, рабочих процессов и быстрые советы; вызывай его, чтобы найти команду или узнать назначение инструмента. CX Codex +1 253установок import-art Скилл import-art копирует обложку музыкального альбома сразу в две папки проекта с нужными именами файлов. Помогает при подготовке релизов. CX Codex +1 252установок researchers-gov Скилл researchers-gov ищет и структурирует официальные релизы ведомств США (DOJ, FBI, SEC, CISA) для документальных музыкальных треков. Выделяет цитаты, хронологию и ключевые цифры. CX Codex +1 252установок session-start Скилл session-start для Claude Code запускает проверку окружения в начале сессии и загружает конфигурацию и состояние проекта. Восстанавливает рабочий контекст. CX Codex +1 251установок explicit-checker Скилл explicit-checker проверяет тексты песен на ненормативную лексику и сверяет флаг Explicit перед генерацией в Suno или отправкой дистрибьюторам. CX Codex +1 251установок promo-reviewer Скилл promo-reviewer проверяет тексты для соцсетей в promo/ альбома и помогает отредактировать их перед релизом. Подходит для финальной вычитки постов по платформам. CX Codex +1 250установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой