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

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

Скилл validate-album проверяет каталоги музыкального альбома, пути к аудиофайлам и поля треков перед релизом. Скилл опирается на утилиты MCP-сервера bitwize-music-mcp.

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

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

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

Скилл запускает аудит папок альбома через инструменты Read, Bash, Glob, Grep и bitwize-music-mcp. На первом шаге он считывает конфигурацию через get_config() и находит альбом с помощью find_album. Если конфигурационный файл ~/.bitwize-music/config.yaml отсутствует, агент останавливает работу и просит запустить /configure.

Проверка идёт по четырём категориям: общая структура папок альбома, размещение аудиофайлов по шаблону {audio_root}/artists/{artist}/albums/{genre}/{album}/, наличие обложек и наполнение markdown-файлов каждого трека. В треках проверяются секции Suno Style Box, Suno Lyrics Box, статус генерации и согласованность флага инструментала между frontmatter и таблицей деталей.

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

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

  • найти пропущенные markdown-файлы треков и README альбома
  • выявить аудиофайлы и папки WAV, положенные мимо каталога артиста
  • проверить наличие секций и ссылок Suno в описаниях треков
  • сформировать готовые команды перемещения файлов для исправления путей

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

  • Проверь структуру альбома sample-album перед релизом
  • Запусти валидацию каталога альбома electronic-odyssey
  • Проверь целостность треков и файлов для альбома synth-wave

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

1Через Skills CLI (Vercel)

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

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

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

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

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

Вопросы о validate-album

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

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

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

Он проверяет директории музыкального альбома, структуру markdown-файлов треков, метаданные генерации Suno и выдаёт команды для исправления путей аудиофайлов.

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

В системе должен существовать файл ~/.bitwize-music/config.yaml с путями к библиотеке и именем артиста, а также подключён MCP-сервер bitwize-music-mcp.

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

SKILL.md · CC0-1.0
---
name: validate-album
description: Validates album directory structure, file locations, and content integrity. Use before release or whenever the user wants to check an album's structural health.
argument-hint: <album-name>
model: haiku
context: fork
allowed-tools:
  - Read
  - Bash
  - Glob
  - Grep
  - bitwize-music-mcp
---

# Album Validator Agent

## Your Task

**Input**: $ARGUMENTS (album name, e.g., `sample-album`)

Validate that an album has all required files in the correct locations, catching path issues and missing content before they become problems.

---

## Step 1: Load Config & Find Album

1. Call `get_config()` — returns paths (`content_root`, `audio_root`, `documents_root`) and `artist.name`
   - If config missing, STOP and report:
     ```
     [FAIL] Config file missing: ~/.bitwize-music/config.yaml
            Run /configure to set up the plugin.
     ```

2. Call `find_album(album_name)` — fuzzy match by name, slug, or partial
   - If not found, STOP and report (MCP returns available albums):
     ```
     [FAIL] Album not found: {album-name}
     ```

3. Optionally call `validate_album_structure(album_slug)` — runs structural validation checks and returns `{passed, failed, warnings, skipped, issues[], checks[]}`. This MCP tool handles directory structure, required files, audio placement, and track content checks in one call.

**Note**: The MCP `validate_album_structure` tool performs many of the checks below automatically. You can use its results directly or run the manual checks for more detailed reporting.

---

## Step 3: Run Validations

### Initialize Counters
- `passed = 0`
- `failed = 0`
- `warnings = 0`
- `skipped = 0`
- `issues = []` (list of fix commands)

### Output Header
```
═══════════════════════════════════════════════════════════
ALBUM VALIDATION: {album-name}
═══════════════════════════════════════════════════════════
```

---

## Validation Categories

### CONFIG
```
CONFIG
──────
```

| Check | Pass | Fail |
|-------|------|------|
| Config file exists | `[PASS] Config file exists` | `[FAIL] Config file missing` |
| content_root defined | `[PASS] content_root: {value}` | `[FAIL] content_root not defined` |
| audio_root defined | `[PASS] audio_root: {value}` | `[FAIL] audio_root not defined` |
| artist defined | `[PASS] artist: {value}` | `[FAIL] artist.name not defined` |

### ALBUM STRUCTURE
```
ALBUM STRUCTURE
───────────────
```

| Check | How | Pass | Fail |
|-------|-----|------|------|
| Album dir exists | `test -d {album_path}` | `[PASS] Album directory: {path}` | `[FAIL] Album directory missing` |
| README.md exists | `test -f {album_path}/README.md` | `[PASS] README.md exists` | `[FAIL] README.md missing` |
| tracks/ dir exists | `test -d {album_path}/tracks` | `[PASS] tracks/ directory exists` | `[FAIL] tracks/ directory missing` |
| Track files exist | `ls {album_path}/tracks/*.md` | `[PASS] {N} track files found` | `[WARN] No track files found` |

**For documentary albums** (check README.md for type):
| Check | How | Pass | Fail |
|-------|-----|------|------|
| RESEARCH.md exists | `test -f {album_path}/RESEARCH.md` | `[PASS] RESEARCH.md exists` | `[WARN] RESEARCH.md missing (documentary album)` |
| SOURCES.md exists | `test -f {album_path}/SOURCES.md` | `[PASS] SOURCES.md exists` | `[WARN] SOURCES.md missing (documentary album)` |

### AUDIO FILES
```
AUDIO FILES
───────────
```

Expected path: `{audio_root}/artists/{artist}/albums/{genre}/{album}/`

| Check | How | Pass | Fail |
|-------|-----|------|------|
| Audio dir exists (correct path) | `test -d {audio_root}/artists/{artist}/albums/{genre}/{album}` | `[PASS] Audio directory: {path}` | See below |
| Audio dir in wrong location | `test -d {audio_root}/{album}` | N/A | `[FAIL] Audio in wrong location (missing artist folder)` |

**If audio in wrong location**, add to issues:
```
→ Expected: {audio_root}/artists/{artist}/albums/{genre}/{album}/
→ Found at: {audio_root}/{album}/ (WRONG - missing artist folder)
→ Fix: mv {audio_root}/{album}/ {audio_root}/artists/{artist}/albums/{genre}/{album}/
```

| Check | How | Pass | Skip |
|-------|-----|------|------|
| WAV files present | `ls {audio_path}/*.wav` | `[PASS] {N} WAV files found` | `[SKIP] No audio files yet` |
| mastered/ exists | `test -d {audio_path}/mastered` | `[PASS] mastered/ directory exists` | `[SKIP] Not mastered yet` |

### ALBUM ART
```
ALBUM ART
─────────
```

| Check | How | Pass | Skip |
|-------|-----|------|------|
| Art in audio folder | `test -f {audio_path}/album.png` | `[PASS] album.png in audio folder` | `[SKIP] No album art yet` |
| Art in content folder | `test -f {album_path}/album-art.*` | `[PASS] album-art in content folder` | `[SKIP] No album art yet` |

### TRACKS
```
TRACKS
──────
```

For each track file in `{album_path}/tracks/*.md`:

1. Read the file
2. Check for required fields:
   - Status field exists
   - Suno Style Box exists (has `## Suno Inputs` section)
   - Suno Lyrics Box exists
   - If Status is `Generated` or `Final`: Suno Link present
   - If documentary: Sources Verified status
3. Check instrumental field sync:
   - Read frontmatter `instrumental` field (true/false/missing)
   - Read Track Details table `**Instrumental**` row (Yes/No/missing)
   - If both present and they disagree → `[WARN] {filename} - Instrumental field mismatch: frontmatter={value}, table={value}`
   - If only one is set → `[WARN] {filename} - Instrumental field missing from {frontmatter|table} (set in {other})`

Output per track:
- `[PASS] {filename} - Status: {status}, Suno Link: {present/missing}`
- `[WARN] {filename} - Status: {status}, missing {what}`
- `[FAIL] {filename} - No Status field`

---

## Step 4: Summary

```
═══════════════════════════════════════════════════════════
SUMMARY: {passed} passed, {failed} failed, {warnings} warning(s), {skipped} skipped
═══════════════════════════════════════════════════════════
```

If any issues:
```
ISSUES TO FIX:
1. {issue description}
   {fix command}
2. ...
```

---

## Example Output

```
═══════════════════════════════════════════════════════════
ALBUM VALIDATION: sample-album
═══════════════════════════════════════════════════════════

CONFIG
──────
[PASS] Config file exists
[PASS] content_root: ~/bitwize-music
[PASS] audio_root: ~/bitwize-music/audio
[PASS] artist: bitwize

ALBUM STRUCTURE
───────────────
[PASS] Album directory: ~/bitwize-music/artists/bitwize/albums/electronic/sample-album/
[PASS] README.md exists
[PASS] tracks/ directory exists
[PASS] 5 track files found

AUDIO FILES
───────────
[FAIL] Audio directory in wrong location
       → Expected: ~/bitwize-music/audio/artists/bitwize/albums/electronic/sample-album/
       → Found at: ~/bitwize-music/audio/sample-album/
       → Fix: mv ~/bitwize-music/audio/sample-album/ ~/bitwize-music/audio/artists/bitwize/albums/electronic/sample-album/

ALBUM ART
─────────
[SKIP] No album art yet

TRACKS
──────
[PASS] 01-intro.md - Status: Final, Suno Link: present
[PASS] 02-track.md - Status: Final, Suno Link: present
[WARN] 03-t-day-beach.md - Status: Generated, Suno Link: missing

═══════════════════════════════════════════════════════════
SUMMARY: 8 passed, 1 failed, 1 warning, 1 skipped
═══════════════════════════════════════════════════════════

ISSUES TO FIX:
1. Move audio folder to include artist:
   mv ~/bitwize-music/audio/sample-album/ ~/bitwize-music/audio/artists/bitwize/albums/electronic/sample-album/
```

---

## Important Notes

1. **Use MCP tools first** - `get_config()`, `find_album()`, `validate_album_structure()` before manual checks
2. **Check both correct AND wrong locations** - Catch misplaced files
3. **Provide actionable fixes** - Include exact commands to fix issues
4. **Use appropriate status** - PASS/FAIL/WARN/SKIP based on severity
5. **Count everything** - Report totals in summary

© bitwize-music-studio · CC0-1.0 · bitwize-music-studio/claude-ai-music-skills

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

Все скиллы по теме «Заметки, задачи и проекты» →
suno-music acedatacloud Скилл suno-music для Claude Code создаёт песни, инструментальную музыку и тексты через Suno. Подключается, когда пользователь просит сгенерировать музыку или песню. CX Codex +1 287установок ai-music-album nexu-io Скилл ai-music-album для Claude Code ведёт цикл создания музыкального альбома: от концепта и текстов до треклиста и экспорта. Включает работу над инди-релизами и брендовыми саундтреками. CX Codex +1 2 900установок suno social-media-skills Ведёт брифы и тексты для Suno, следит за структурой трека и правами при создании музыки для бренда или видео. CX Codex +1 1 200установок style-specification a5c-ai Скилл style-specification собирает подробную спецификацию музыкального стиля — жанр, BPM, инструменты, вокал, референсы — и сжимает её в промпт для Suno или Udio. CX Codex +1 1установок music-generation michaelboeding Скилл music-generation превращает просьбу вроде «сделай lo-fi бит» в готовый аудиофайл: выбирает провайдера, собирает промпт и запускает скрипт. CX Codex +1 1установок Suno by Ace Data Cloud AceDataCloud MCP-сервер Suno by Ace Data Cloud подключает Suno к ИИ-клиенту: генерация песен и текстов, каверы, стемы и управление задачами прямо из чата. CX Codex +1 ★ 76звёзд репо

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

Весь набор →
verify-sources Скилл verify-sources проверяет ссылки и источники для треков музыкального альбома перед генерацией в Suno. Скилл запрашивает ручное подтверждение и проставляет дату проверки в файлах. CX Codex +1 249установок rename Скилл rename переименовывает музыкальные альбомы и треки в каталоге, обновляя слаги, метаданные и зеркальные папки контента. Помогает навести порядок в архиве проектов. CX Codex +1 249установок about Скилл about выводит версию плагина bitwize-music и сведения о его создателе. Используй, когда нужно уточнить возможности плагина или проверить установленную версию. CX Codex +1 248установок genre-creator Скилл genre-creator для Claude Code создаёт документацию нового музыкального жанра и добавляет его в индекс и пресеты мастеринга. Расширяет библиотеку bitwize-music. CX Codex +1 248установок researchers-financial Скилл researchers-financial для Claude Code исследует финансовые документы и рыночные данные для музыкальных проектов о компаниях, финансовых преступлениях и событиях рынка. Он собирает источники и отмечает факты для проверки человеком. CX Codex +1 248установок next-step Скилл next-step определяет текущий статус музыкального альбома и подсказывает один следующий шаг с нужной командой. CX Codex +1 247установок configure Скилл configure для Claude Code интерактивно создаёт и редактирует ~/.bitwize-music/config.yaml для музыкальных плагинов bitwize-music. CX Codex +1 247установок cloud-uploader Скилл cloud-uploader загружает проморолики и сэмплер альбома в Cloudflare R2 или AWS S3. Используйте его после подготовки видео, когда файлы нужно разместить в облаке. CX Codex +1 247установок

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

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