Skills

Tutorial

Provides interactive guided album creation for new users.

Install

npx skills add bitwize-music-studio/claude-ai-music-skills --skill tutorial -g -a claude-code -y
Category
Engineering
Updated
7d ago
License
CC0-1.0
Context cost
Mediumabout 2,246 tokens
Runs scripts
No, instructions only

What it does

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.

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 - 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:
Read the whole SKILL.md on GitHub

More in Engineering