# Validate Album

Validates album directory structure, file locations, and content integrity.

- Repository: https://github.com/bitwize-music-studio/claude-ai-music-skills (615 stars)
- Category: Engineering
- License: CC0-1.0
- Last updated: 2026-10-28
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add bitwize-music-studio/claude-ai-music-skills --skill validate-album -g -a claude-code -y`
Codex: `npx skills add bitwize-music-studio/claude-ai-music-skills --skill validate-album -g -a codex -y`
Cursor: `npx skills add bitwize-music-studio/claude-ai-music-skills --skill validate-album -g -a cursor -y`
Gemini CLI: `npx skills add bitwize-music-studio/claude-ai-music-skills --skill validate-album -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add bitwize-music-studio/claude-ai-music-skills`

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

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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
──────
```

The rest: https://github.com/bitwize-music-studio/claude-ai-music-skills/blob/HEAD/skills/validate-album/SKILL.md