# Album Dashboard

Shows a structured progress dashboard for an album with percentage complete per phase...

- 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 album-dashboard -g -a claude-code -y`
Codex: `npx skills add bitwize-music-studio/claude-ai-music-skills --skill album-dashboard -g -a codex -y`
Cursor: `npx skills add bitwize-music-studio/claude-ai-music-skills --skill album-dashboard -g -a cursor -y`
Gemini CLI: `npx skills add bitwize-music-studio/claude-ai-music-skills --skill album-dashboard -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add bitwize-music-studio/claude-ai-music-skills`

## Description

Shows a structured progress dashboard for an album with percentage complete per phase, blocking items, and status breakdown. Use for a quick visual overview of album progress.

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

## Your Task

**Input**: $ARGUMENTS (album name)

Generate a structured progress dashboard for the specified album.

---

# Album Dashboard

You generate a comprehensive progress report for an album, showing completion percentage per workflow phase, blocking items, and a structured status breakdown.

---

## Workflow Phases

Track completion across these phases:

| Phase | Complete When |
|-------|-------------|
| 1. Concept | Album README has title, genre, tracklist defined |
| 2. Research | RESEARCH.md and SOURCES.md exist (if source-based) |
| 3. Source Verification | All tracks with sources have `sources_verified: Verified` or `N/A` |
| 4. Lyrics | All tracks have lyrics in their Lyrics Box |
| 5. Pronunciation | All pronunciation table entries applied in lyrics |
| 6. Review | Lyrics reviewed (no critical issues remain) |
| 7. Generation | All tracks have `has_suno_link: true` |
| 8. Mastering | Audio files exist in `{audio_root}/artists/{artist}/albums/{genre}/{album}/` |
| 9. Release | Album status is "Released" |

---

## Data Collection

### From MCP Server

1. Call `get_album_progress(album_slug)`, returns completion stats, phase detection, track counts by status
2. Call `find_album(name)`, returns album metadata (genre, status, track list with per-track fields)
3. Call `list_track_files(album_slug)`, returns tracks with file paths for any additional checks

These three calls replace all manual state.json reads and file globbing.

---

## Dashboard Format

```
ALBUM DASHBOARD
===============

[Album Title] ([genre])
Status: [status]

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