Album Dashboard

Dashboard di progresso per fase per un album musicale: percentuali, blocchi, prossima azione

di bitwize-music-studio · bitwize-music-studio/claude-ai-music-skills

Richiede configurazione ★ 8.0/10

Album Dashboard — Dashboard di progresso per fase per un album musicale: percentuali, blocchi, prossima azione

Cosa fa

Renderizza una dashboard di progresso a nove fasi per un album nello spazio di lavoro bitwize-music — concept, ricerca, verifica della fonte, testi, pronuncia, revisione, generazione, mastering, rilascio — con barre di progresso ASCII, una tabella di stato per traccia e un elenco di elementi bloccanti. Estrae lo stato dell'album e delle tracce dal server MCP bitwize-music del plugin (get_album_progress, find_album, list_track_files) e riempie le fasi rimanenti dai file su disco. Si attiva quando si chiede a che punto è un album, cosa lo sta bloccando o una panoramica dello stato di ogni traccia.

Rapporto di test

Ho costruito uno spazio di lavoro mock (album "Neon Ledger", 6 tracce, 2 WAV masterizzati, RESEARCH.md ma non SOURCES.md, una traccia con voci di pronuncia non applicate) sotto una HOME temporanea con ~/.bitwize-music/config.yaml, quindi ho eseguito l'indexer del plugin e ho chiamato direttamente in Python i tre handler MCP da cui dipende la skill: get_album_progress ha restituito {"phase":"Source Verification","track_count":6,"tracks_completed":2,"completion_percentage":33.3,"sources_pending":3}, e find_album/list_track_files hanno restituito lo stato per traccia, has_suno_link e sources_verified. L'artefatto baseline ha riportato quella singola cifra del 33.3% più una tabella delle tracce e un passaggio successivo di una riga; l'artefatto della skill ha riportato nove percentuali di fase e ha rilevato tre cose che la baseline non ha mai cercato — le voci di pronuncia della traccia 04 (SWIFT, Nauru) presenti nella tabella ma assenti dalla Lyrics Box, le tracce 05/06 con testo segnaposto nella Lyrics Box, e il SOURCES.md mancante (ricerca al 50%) — più Mastered 33% derivato dal conteggio dei file audio e Source Verification 40% escludendo la traccia N/A dal denominatore. I documenti perdono un punto perché SKILL.md afferma che le tre chiamate MCP "replace all manual state.json reads and file globbing", cosa che i payload JSON osservati smentiscono (testi, pronuncia, file audio e RESEARCH/SOURCES necessitano ancora di letture di file), e la fase di revisione non ha una fonte di dati definita. Installazione verificata clonando in una HOME temporanea pulita — SKILL.md si posiziona in ~/.claude/skills/album-dashboard/SKILL.md; nessun curl|sh, base64 o pattern di esfiltrazione di segreti nella skill. Trigger 5/5: si attiverebbe su "show me the progress dashboard for the neon-ledger album", "how far along is my album — give me a per-phase breakdown of what's blocking", "what's blocking the Neon Ledger release, I want a status overview of every track"; non si attiverebbe su "add a progress bar component to my React dashboard page" o "write lyrics for track 3 of Neon Ledger".

Testato il: 2026-07-21 · Claude Code 2.x (agent harness)

Installazione

git clone --depth 1 https://github.com/bitwize-music-studio/claude-ai-music-skills.git /tmp/album-dashboard-src
mkdir -p ~/.claude/skills
cp -R /tmp/album-dashboard-src/skills/album-dashboard ~/.claude/skills/album-dashboard
# The skill body calls MCP tools (get_album_progress, find_album, list_track_files) that only exist
# when the whole bitwize-music plugin is installed. For a working setup use the plugin route:
#   /plugin marketplace add bitwize-music-studio/claude-ai-music-skills
#   /plugin install bitwize-music@bitwize-music
#   /bitwize-music:setup       # Python 3.11+ deps for the MCP server (mcp[cli], pyyaml)
#   /bitwize-music:configure   # writes ~/.bitwize-music/config.yaml (artist name, content_root, audio_root)
# Then run: /bitwize-music:album-dashboard <album-name>
# Requires an album workspace at {content_root}/artists/{artist}/albums/{genre}/{album}/ with
# README.md + tracks/*.md; with no workspace the dashboard has nothing to read.

Comandi e prompt di esempio

  • /album-dashboardDashboard di progresso per fase per un album musicale: percentuali, blocchi, prossima azione

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • Show my album progress dashboard
  • What percentage of the album is complete
  • List the blocking items on my album project