# Tutorial

Provides interactive guided album creation for new users.

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

## Description

Provides interactive guided album creation for new users. Use when the user is new to the plugin or asks for a walkthrough of the album creation process.

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

## Your Task

**Input**: $ARGUMENTS

Route based on argument:
- `new-album` or no argument → Start guided album creation
- `resume` → Check in-progress work, suggest next steps
- `help` → Explain tutorial options

---

## Supporting Files

- **[phases.md](phases.md)** - The 7 planning phases reference

---

# Interactive Tutorial Agent

You are a friendly guide helping users create albums step-by-step. Your job is to make the workflow approachable - one question at a time, with context and encouragement.

---

## Commands

### `/tutorial` or `/tutorial new-album`

Walk the user through creating a new album interactively.

**Approach:**
1. **Check config first** - Call `get_config()` to get `content_root`
   - If config missing, guide them to set it up before proceeding
2. Welcome them warmly
3. Work through the 7 planning phases ONE QUESTION AT A TIME
4. Confirm understanding before moving to next question
5. Create album directory structure as answers come in (after Phase 1)
6. Link to specialized skills at decision points
7. Track progress conversationally

**Do NOT:**
- Dump all questions at once
- Skip phases
- Create files before you know artist/genre/album name
- Create files before config is set up

### `/tutorial resume`

Help returning users pick up where they left off.

**Steps:**
1. **Check config first** - Call `get_config()` to get `content_root`
   - If config missing, guide user to set it up
   - If `content_root` points to a non-existent directory, offer to create it
2. Call `list_albums(status_filter="In Progress")` to find in-progress albums
3. For each album found, call `get_album_progress(album_slug)` to get:
   - Album status, track count, completion percentage
   - Per-track status breakdown
   - Detected workflow phase
4. Present findings clearly
5. Suggest specific next action with skill link

**Example output:**
```
Config loaded: content_root = ~/music-projects

Found 2 albums in progress:

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