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

CC0-1.0Auto-check: notes

Install Validate Album

skills CLI
$ npx skills add bitwize-music-studio/claude-ai-music-skills --skill validate-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 validate-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/validate-album .claude/skills/validate-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
validate-album
GitHub stars
544
Token cost
~2k tokens
SKILL.md length
601 words
Files
1
Skills in repo
51
Repo updated
First seen
Licence
CC0-1.0

At a glance

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

  • Works in 3 steps: Load Config & Find Album → Run Validations → Summary
  • Wants to check an albums structural health
  • SKILL.md covers Your Task, Step 1: Load Config & Find Album, Step 3: Run Validations and Validation Categories, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Validate Album is an agent skill from bitwize-music-studio/claude-ai-music-skills. Validates album directory structure, file locations, and content integrity. Use before release or whenever the user wants to check an album's structural health.

Its SKILL.md is about 2k 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

  • Wants to check an albums structural health

Example prompts

  • “Use the validate-album skill to validate album directory structure, file locations, and content integrity”
  • “/validate-album”

Requirements

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

Workflow steps

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

  1. Load Config & Find Album
  2. Run Validations
  3. Summary

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
    • Glob
    • Grep
    • 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.

    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

Validate Album loads about 2k tokens when it runs. Until then it costs about 44 tokens; SKILL.md has 601 words of instructions outside code blocks.

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

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, Glob, Grep, 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). 601 words, ~1,961 tokens.

Download SKILL.mdSave it as .claude/skills/validate-album/SKILL.md (or your agent's skills folder).
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.
allowed-tools
Read, Bash, Glob, Grep, bitwize-music-mcp
argument-hint
<album-name>
model
haiku
context
fork

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
──────
CheckPassFail
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
───────────────
CheckHowPassFail
Album dir existstest -d {album_path}[PASS] Album directory: {path}[FAIL] Album directory missing
README.md existstest -f {album_path}/README.md[PASS] README.md exists[FAIL] README.md missing
tracks/ dir existstest -d {album_path}/tracks[PASS] tracks/ directory exists[FAIL] tracks/ directory missing
Track files existls {album_path}/tracks/*.md[PASS] {N} track files found[WARN] No track files found

For documentary albums (check README.md for type):

CheckHowPassFail
RESEARCH.md existstest -f {album_path}/RESEARCH.md[PASS] RESEARCH.md exists[WARN] RESEARCH.md missing (documentary album)
SOURCES.md existstest -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}/

CheckHowPassFail
Audio dir exists (correct path)test -d {audio_root}/artists/{artist}/albums/{genre}/{album}[PASS] Audio directory: {path}See below
Audio dir in wrong locationtest -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}/
CheckHowPassSkip
WAV files presentls {audio_path}/*.wav[PASS] {N} WAV files found[SKIP] No audio files yet
mastered/ existstest -d {audio_path}/mastered[PASS] mastered/ directory exists[SKIP] Not mastered yet
Show full SKILL.md (207 more words)Show less
ALBUM ART
ALBUM ART
─────────
CheckHowPassSkip
Art in audio foldertest -f {audio_path}/album.png[PASS] album.png in audio folder[SKIP] No album art yet
Art in content foldertest -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. 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/validate-album of bitwize-music-studio/claude-ai-music-skills.

Open the folder on GitHubat commit 58f32c2

Compare with similar skills

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

Validate Album compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Validate Album this skillbitwize-music-studio/claude-ai-music-skills544—~2kAutomated safety check: NotesCC0-1.0
Validate Integrationsimstudioai/sim30k—~8.7kAutomated safety check: PassApache-2.0
Validating Backup Integrity For Recoverymukul975/Anthropic-Cybersecurity-Skills34k—~1.9kAutomated safety check: PassApache-2.0
Validating Database Integrityjeremylongshore/tons-of-skills-marketplace2.8k—~1.9kAutomated safety check: PassMIT
Form Validationthedaviddias/Front-End-Checklist74k—~633Automated safety check: PassMIT
Integration Testingthedaviddias/Front-End-Checklist74k—~514Automated safety check: PassMIT

Similar skills

  • Validate Integration

    simstudioai/sim

    Validate an existing Sim integration (tools, block, registry, and resolved-secret/model-input boundaries) against the service's API docs and Sim execution conventions

    30k GitHub stars~8.7k tokensUpdated today
    DevelopmentAuto-check passed
  • Validating Backup Integrity For Recovery

    mukul975/Anthropic-Cybersecurity-Skills

    Validates backup integrity through cryptographic hash verification, automated restore testing, corruption detection, and recoverability checks to confirm backups are reliable for disaster recovery…

    34k GitHub stars~1.9k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check passed
  • Validating Database Integrity

    jeremylongshore/tons-of-skills-marketplace

    Process use when you need to ensure database integrity through comprehensive data validation.

    2.8k GitHub stars~1.9k tokensUpdated yesterday
    Data & AnalyticsAuto-check passed
  • Form Validation

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing templates, rendered HTML, or shared components related to Validate forms accessibly.

    74k GitHub stars~633 tokensUpdated 4 days ago
    Frontend & DesignAuto-check passed
  • Integration Testing

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing CI coverage, automated checks, or test strategy related to Write integration tests for key workflows.

    74k GitHub stars~514 tokensUpdated 4 days ago
    Testing & QAAuto-check passed
  • API Integration

    sickn33/agentic-awesome-skills

    Designs event-driven architectures, webhook systems, API chaining flows, ETL pipelines, and integration patterns between services.

    47k GitHub starsUsed in 1 repo~1.3k tokens
    Backend & APIsAuto-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 Validate Album

What does Validate Album do?

Validates album directory structure, file locations, and content integrity. Validate Album is an agent skill from bitwize-music-studio/claude-ai-music-skills. Validates album directory structure, file locations, and content integrity.

When should I use Validate Album?

Validate Album fits situations like: wants to check an albums structural health.

How do I install Validate Album in Claude Code?

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

How do I install Validate Album in Codex?

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

Can I use Validate 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 validate-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/validate-album, .gemini/skills/validate-album, .github/skills/validate-album and .opencode/skills/validate-album in your project.

What does Validate Album need to run?

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

Does Validate 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 Validate 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 Validate Album use?

Validate 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 Validate Album use?

About 2k tokens (SKILL.md is roughly 7.8k 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 Validate Album?

Skills that share tags, products or a category with Validate Album: Validate Integration (simstudioai/sim, 30k stars), Validating Backup Integrity For Recovery (mukul975/Anthropic-Cybersecurity-Skills, 34k stars), Validating Database Integrity (jeremylongshore/tons-of-skills-marketplace, 2.8k stars) and Form Validation (thedaviddias/Front-End-Checklist, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Validate 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.