Skip to main content
skill CX Codex

album-dashboard — Claude Code skill for album progress

album-dashboard is a Claude Code skill that summarizes album phases, track statuses, and generation blockers, showing what remains before generation, mastering, or release.

CC0-1.0 253 installs ★ 686 updated 2026-10-22

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add bitwize-music-studio/claude-ai-music-skills --skill album-dashboard -a claude-code
Open on GitHub

What album-dashboard does

album-dashboard reports progress across nine album phases, from concept and research through mastering and release. It gives each phase a completion percentage, shows track statuses, and calls out tasks blocking generation. The report ends with a suggested next action.

The skill gets album data through bitwize-music-mcp, calling get_album_progress(album_slug), find_album(name), and list_track_files(album_slug). Its checks cover album README details, research files, lyrics, source verification, Suno links, and WAV/FLAC files. It requires the resume skill; without access to bitwize-music-mcp, it cannot retrieve the album data for the dashboard.

What it helps with

  • check completion across album phases
  • identify tracks holding up generation
  • count tracks with lyrics or Suno links
  • see what remains before mastering and release

Example prompts for the agent

  • Show me a progress dashboard for the album “Silver Lines”.
  • Find the blockers for the album night-drive.
  • Report phase completion and track statuses for “Northern Lights”.

How to install album-dashboard

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

Copy the whole skill folder; for one project use .claude/skills/album-dashboard/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about album-dashboard

How do I install album-dashboard in Claude Code?

Run npx skills add bitwize-music-studio/claude-ai-music-skills --skill album-dashboard -a claude-code. The skill file is at ~/.claude/skills/album-dashboard/SKILL.md.

What does album-dashboard do?

It reports album completion by phase, lists track statuses, and highlights tasks that block generation.

What does album-dashboard need to run?

It requires the resume skill and access to bitwize-music-mcp to retrieve album and track information.

Source text

SKILL.md · CC0-1.0
---
name: album-dashboard
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.
argument-hint: <album-name>
model: haiku
prerequisites:
  - resume
allowed-tools:
  - Read
  - Glob
  - Grep
  - bitwize-music-mcp
---

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

PROGRESS BY PHASE
─────────────────
[============================  ] 90%  Concept
[============================  ] 90%  Research
[========================      ] 75%  Source Verification
[====================          ] 63%  Lyrics Written
[================              ] 50%  Pronunciation
[============                  ] 38%  Reviewed
[========                      ] 25%  Generated
[                              ]  0%  Mastered
[                              ]  0%  Released

OVERALL: ████████░░░░░░░░ 47% complete

TRACK STATUS BREAKDOWN
──────────────────────
| # | Track | Status | Suno | Sources |
|---|-------|--------|------|---------|
| 01 | Track One | Final | link | Verified |
| 02 | Track Two | In Progress | — | Pending |
| 03 | Track Three | Not Started | — | N/A |
...

BLOCKING ITEMS
──────────────
! Track 02: Sources pending verification — blocks generation
! Track 05: No style prompt — blocks generation
! Track 07: Pronunciation table not applied — blocks generation

SUMMARY
───────
Tracks: [X complete / Y total]
Blocking: [N items]
Next action: [recommendation]
```

---

## Phase Completion Calculation

### Concept Phase
- 100% if: Album README has title AND tracklist with actual track names (not template)
- 50% if: README exists but tracklist is template placeholder
- 0% if: No README

### Research Phase (source-based albums only)
- 100% if: RESEARCH.md AND SOURCES.md both exist with content
- 50% if: Only one exists
- N/A if: Album is not source-based (no tracks have sources_verified field or all are N/A)

### Source Verification Phase
- % = (tracks with Verified or N/A) / total tracks * 100
- Skip tracks where sources_verified is N/A for the denominator

### Lyrics Phase
- % = (tracks with lyrics content) / total tracks * 100

### Generation Phase
- % = (tracks with has_suno_link=true) / total tracks * 100

### Mastering Phase
- Check `{audio_root}/artists/{artist}/albums/{genre}/{album}/` for WAV/FLAC files
- % = (audio files found) / total tracks * 100

### Release Phase
- 100% if album status is "Released", 0% otherwise

---

## Remember

1. **Visual progress bars** — Use ASCII progress bars for quick scanning
2. **Highlight blockers** — Blocking items are the most important info
3. **Include next action** — End with a clear recommendation
4. **Be accurate** — Count carefully, don't estimate
5. **Handle missing data gracefully** — If audio_root doesn't exist, mastering is 0%

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

Similar skills

All skills for Data and databases →

From the same set52

The whole set →
researchers-security The researchers-security skill investigates malware, CVEs, threat actors, and incident reports. Use it to check cybersecurity topics or verify a track before writing about it. CX Codex +1 255installs researchers-biographical researchers-biographical researches the lives, interviews, motives, and personal details of people connected to an album’s subject. Designed for research in documentary music projects. CX Codex +1 254installs researchers-journalism researchers-journalism — a skill for locating and analyzing investigative journalism, interviews, and news coverage. Use it when you need credible sources to verify facts or add context to music projects. CX Codex +1 254installs album-ideas album-ideas is a Claude Code skill that organizes music concepts before an album repository is created, tracking genres and development status in IDEAS.md. CX Codex +1 254installs researcher researcher is a skill for investigative work that finds primary sources, cross-checks facts across three or more independent sources, and builds evidence chains with quotes and citations. CX Codex +1 253installs researchers-tech The researchers-tech skill gathers facts about open source project histories, developer interviews, and technical documentation. Use it when you need to document how a technology started, who built it, and how it evolved. CX Codex +1 253installs help help is a Claude Code skill that lists bitwize-music commands and workflows; call it to find a command or check what a tool does. CX Codex +1 253installs import-art import-art distributes album artwork into audio and content folders using standard naming conventions. Useful right after generating or downloading a cover. CX Codex +1 252installs

Project sponsors

Companies that keep this analytics open