К основному содержанию
скилл CX Codex

tutorial — скилл для Claude Code: что делает и как установить

Скилл tutorial проводит новичка через создание музыкального альбома: от идеи и жанра до треклиста, обложки и подтверждения плана.

CC0-1.0 259 установок ★ 686 обновлён 2026-10-22

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add bitwize-music-studio/claude-ai-music-skills --skill tutorial -a claude-code
Открыть на GitHub

Что делает tutorial

Скилл ведёт интерактивный процесс создания альбома в семь этапов. Он задаёт по одному вопросу, помогает определить артиста, жанр, концепцию, звучание, треклист и визуальную идею, а затем собирает план для записи.

Режим new-album начинает работу, resume проверяет незавершённые альбомы и предлагает следующий шаг, а help объясняет команды. Скилл использует Read, Write, Edit, Glob, Grep, Bash, AskUserQuestion и bitwize-music-mcp, а также связывает пользователя со скиллами /suno-engineer, /album-art-director и /lyric-writer.

Перед созданием файлов нужно загрузить конфигурацию и определить content_root; без этого альбомная структура не создаётся. После первого этапа он создаёт папку альбома, а после подтверждения плана обновляет README и добавляет файлы треков.

Какие задачи решает

  • спланировать новый музыкальный альбом по этапам
  • сформировать концепцию и эмоциональное ядро
  • собрать треклист с описанием каждой песни
  • возобновить работу над незавершённым альбомом
  • подготовить README и файлы треков

Примеры запросов агенту

  • Запусти /tutorial new-album и проведи меня через создание альбома по одному вопросу за раз.
  • Выполни /tutorial resume и покажи, какие альбомы ещё не завершены и что делать дальше.
  • Объясни режимы работы через /tutorial help.

Как установить tutorial

1Через Skills CLI (Vercel)

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

2Вручную: положить файлы

~/.claude/skills/tutorial/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/tutorial/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о tutorial

Как установить tutorial в Claude Code?

Выполните npx skills add bitwize-music-studio/claude-ai-music-skills --skill tutorial -a claude-code, затем проверьте файл ~/.claude/skills/tutorial/SKILL.md.

Что делает скилл tutorial?

Он пошагово помогает спланировать альбом, задавая по одному вопросу. Также он умеет продолжать незавершённую работу и объяснять доступные режимы.

Что нужно настроить до создания альбома?

Сначала скилл загружает конфигурацию через get_config() и получает content_root. Только после этого он создаёт папки и файлы проекта.

Исходный текст

SKILL.md · CC0-1.0
---
name: tutorial
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.
argument-hint: <new-album | resume | help>
model: sonnet
effort: low
allowed-tools:
  - Read
  - Write
  - Edit
  - Glob
  - Grep
  - Bash
  - AskUserQuestion
  - bitwize-music-mcp
---

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

1. "Album Name" (~/music-projects/artists/you/albums/hip-hop/album-name/)
   Status: In Progress
   Tracks: 3/8 complete
   → Next: Write lyrics for track 04
   → Run: /lyric-writer ~/music-projects/artists/you/albums/hip-hop/album-name/tracks/04-track.md

2. "Other Album" (~/music-projects/artists/you/albums/folk/other-album/)
   Status: Research Complete
   Tracks: 0/6 started
   Sources: 4/6 verified
   → Next: Verify remaining sources, then start writing
```

### `/tutorial help`

Explain what the tutorial does.

**Response:**
```
The tutorial helps you create albums interactively.

Commands:
  /tutorial new-album  - Start creating a new album (guided, step-by-step)
  /tutorial resume     - Check your in-progress work and get next steps
  /tutorial help       - Show this message

The guided process walks you through:
  1. Foundation - Artist, genre, album type
  2. Concept - Story, theme, emotional core
  3. Sonic Direction - Sound, influences, mood
  4. Structure - Tracklist, track concepts
  5. Album Art - Visual concept (generated later)
  6. Practical Details - Title, research needs, explicit content
  7. Confirmation - Review plan, get your go-ahead

At each step, I'll ask one question at a time and explain why it matters.
```

---

## The 7 Planning Phases

See [phases.md](phases.md) for the complete reference.

### How to Guide Each Phase

**Phase 1: Foundation**
- Start here. These answers determine everything else.
- Create album directory AFTER getting: artist, genre, album name
- If new artist, pause to create artist profile first

**Phase 2: Concept Deep Dive**
- Dig into the "why" - what makes this story worth telling?
- For documentary/true-story: flag that research will be needed
- Help them articulate the emotional core

**Phase 3: Sonic Direction**
- This is where `/suno-engineer` expertise helps
- Reference artists/albums are useful anchors
- Don't get too detailed yet - broad strokes

**Phase 4: Structure Planning**
- Work titles are fine - they'll evolve
- Get 1-2 sentences per track concept
- Identify the "heart" of the album (usually tracks 5-7)

**Phase 5: Album Art**
- Just the concept now, generation happens later
- `/album-art-director` can help refine this
- Keep it brief - visual mood, key imagery

**Phase 6: Practical Details**
- Confirm titles (but flexible is OK)
- Explicit content? (affects distributor flags)
- Research needs? (creates RESEARCH.md, SOURCES.md)

**Phase 7: Confirmation**
- Present the complete plan
- Get explicit "ready to start writing" confirmation
- Document everything in album README

---

## Creating Files During Tutorial

**Before creating any files**, ensure config is loaded and `{content_root}` is resolved.

**After Phase 1 is complete** (you know artist, genre, album name):

1. Create directory:
   ```bash
   mkdir -p {content_root}/artists/[artist]/albums/[genre]/[album-name]/tracks
   ```

2. Create album README from template (read `${CLAUDE_PLUGIN_ROOT}/templates/album.md` first)

3. Tell user: "I've created the album folder at `{content_root}/artists/...`. We'll fill in the details as we go."

**After Phase 7 confirmation:**

1. Update album README with all planning details
2. Create track files from template
3. If true-story album: create RESEARCH.md and SOURCES.md

---

## Linking to Skills

At appropriate points, tell users about relevant skills:

| When | Suggest |
|------|---------|
| Discussing sound/genre | "We can get deeper into this with `/suno-engineer` later" |
| Planning visual concept | "When ready, `/album-art-director` will help create the prompt" |
| True-story album | "For research, `/researcher` coordinates specialized skills" |
| Starting lyrics | "Use `/lyric-writer` for each track" |
| Before generation | "Run `/lyric-reviewer` to QA check before Suno" |

---

## Tone & Style

- **Conversational** - Not a form to fill out, a conversation
- **One thing at a time** - Never list all questions at once
- **Explain why** - "This matters because..."
- **Affirm progress** - "Got it. That gives us a solid foundation."
- **Be honest** - If an idea needs work, say so constructively
- **Link ahead** - "Next we'll talk about the sound..."

---

## Example Interaction

**User:** `/tutorial new-album`

**You:**
```
[calls get_config()]

Config loaded:
  content_root: ~/music-projects
  audio_root: ~/Music/mastered

Let's create an album together.

First, the basics: Who's the artist?
- An existing artist you've already set up?
- Or someone new we need to create first?

(If existing, tell me the name. If new, we'll create them first.)
```

**If config is missing:**
```
Before we start, let's set up your configuration.

Option 1 - Interactive setup:
  Run /configure

Option 2 - Manual setup:
  mkdir -p ~/.bitwize-music
  cp config/config.example.yaml ~/.bitwize-music/config.yaml
  # Then edit the file with your settings

Let me know when you're ready!
```

**User:** "It's for my artist Alex Techno"

**You:**
```
Alex Techno - got it. Let me check if they're set up...

[reads artists/alex-techno/README.md]

Found them. Nice electronic artist profile.

What genre/style for this album?
- Staying in their electronic wheelhouse?
- Trying something different?

(This determines which folder the album lives in: electronic, hip-hop, etc.)
```

**User:** "Electronic, but darker and more industrial"

**You:**
```
Dark industrial electronic - that's a strong direction.

Now: What type of album is this?

- **Documentary** - Real events/people told through music
- **Narrative** - A fictional story arc across tracks
- **Thematic** - United by theme (not plot)
- **Character Study** - Deep dive into one person
- **Collection** - Standalone songs, loose connection
- **Original Soundtrack (OST)** - Music for a fictional property's world, scenes, and key moments (games, films, shows)

Which fits your vision?
```

*(Continue through all 7 phases this way)*

---

## Resume Example

**User:** `/tutorial resume`

**You:**
```
[calls get_config(), list_albums(status_filter="In Progress")]

Config loaded: content_root = ~/music-projects

Let me check what you have in progress...

Found 1 album in progress:

"Dark Machines" (~/music-projects/artists/alex-techno/albums/electronic/dark-machines/)
  Status: In Progress
  Tracks: 5/10 written
    - 01-boot-sequence: Final
    - 02-assembly-line: Final
    - 03-malfunction: Final
    - 04-override: In Progress (lyrics incomplete)
    - 05-shutdown: Not Started
    - 06-10: Not Started

Looks like you were working on track 04 "Override".

Want to continue there? Run:
  /lyric-writer ~/music-projects/artists/alex-techno/albums/electronic/dark-machines/tracks/04-override.md
```

---

## Remember

- **Preserve exact casing** - If user says "bitwize", use "bitwize" not "Bitwize"
- The README tutorial is comprehensive but static
- You make it interactive and context-aware
- Meet users where they are - new album or mid-project
- One question at a time, explain as you go
- Create files at the right moments, not too early

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

Похожие скиллы

Каталог скиллов SKILL.md →
developer-tutorial Samuel Berthe Скилл developer-tutorial для Claude Code пишет или аудирует обучающие туториалы по продукту: читатель шаг за шагом собирает работающий проект и осваивает навык. CX Codex +1 13 500установок comment-code-generate-a-tutorial официальный github Скилл comment-code-generate-a-tutorial приводит Python-скрипт в порядок, поясняет его комментариями и создаёт учебный README.md. Подходит, когда код нужно подготовить для новичков. CX Codex +1 8 900установок tutorial-docs existential-birds Скилл tutorial-docs для Claude Code задаёт структуру обучающих руководств по методологии Diataxis. Агент подключает его при написании вводных уроков и пошаговых руководств для новичков. CX Codex +1 273установок tutorial-creation vivy-yi Скилл tutorial-creation для создания пошаговых обучающих материалов на Xiaohongshu. Помогает структурировать контент так, чтобы подписчики поняли и смогли применить знания. CX Codex +1 178установок re0-tutorial LilMGenius Скилл re0-tutorial для Claude Code проводит разработчика по трём уровням упражнений с проверкой самостоятельной работы. CX Codex +1 129установок tutorial-design NickCrew Скилл tutorial-design помогает проектировать пошаговые туториалы, воркшопы и практические руководства с контрольными точками и разбором частых ошибок. CX Codex +1 102установок

Из того же набора52

Весь набор →
clipboard Скилл clipboard копирует тексты песен, промпты стилей и метаданные музыкальных треков в системный буфер обмена для быстрой вставки в Suno. CX Codex +1 261установок researchers-legal Скилл researchers-legal для Claude Code исследует судебные документы по уголовным и гражданским делам и собирает факты с цитатами. Разбирает темы, связанные с судебными процессами. CX Codex +1 261установок promo-director Скилл promo-director создаёт вертикальные видео 15 секунд для Instagram, TikTok и Twitter из готового трека. Берёт обложку альбома, выбирает самый энергичный фрагмент и накладывает визуализацию волны звука. CX Codex +1 259установок promo-writer Скилл promo-writer генерирует тексты для продвижения альбома в соцсетях с учётом формата каждой платформы. Пригодится перед релизом, когда шаблоны promo/ нужно заполнить. CX Codex +1 259установок import-audio Скилл import-audio для Claude Code переносит аудиофайлы в папку альбома и раскладывает stems по трекам. Обрабатывает WAV, MP3 и другие поддерживаемые форматы. CX Codex +1 257установок document-hunter Скилл document-hunter ищет и скачивает первичные публичные документы, судебные иски и правительственные отчёты через автоматизацию браузера Playwright. CX Codex +1 256установок setup Скилл setup проверяет Python-окружение и зависимости плагина, а затем подсказывает команды установки. Нужен при первом запуске или сбое MCP-сервера. CX Codex +1 255установок researchers-security Скилл researchers-security для Claude Code исследует вредоносное ПО, CVE, хакерские группы и отчёты об инцидентах. Проверяет темы и материалы о кибербезопасности. CX Codex +1 255установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой