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

configure · bitwize-music-studio — скилл для Claude Code: что делает и как установить

Скилл configure для Claude Code интерактивно создаёт и редактирует ~/.bitwize-music/config.yaml для музыкальных плагинов bitwize-music.

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

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

Что делает configure

Скилл создаёт и редактирует рабочий конфигурационный файл ~/.bitwize-music/config.yaml. При первом запуске он последовательно запрашивает имя артиста, каталоги для контента, готового аудио и документов, а также опциональные жанры, профиль SoundCloud и пути переопределений.

Внутри скилл использует инструменты Read, Write, AskUserQuestion и Bash. Он умеет выводить текущие параметры командой show, точечно менять отдельные поля через edit, стирать профиль через reset или проверять синтаксис YAML и доступность путей через validate. Без указания обязательных путей к контенту и аудио валидация завершится с ошибкой.

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

  • создать файл ~/.bitwize-music/config.yaml в режиме диалога
  • изменить отдельные параметры профиля без ручной правки YAML
  • проверить корректность путей и синтаксис конфигурации командой validate
  • сбросить текущие настройки проекта и запустить настройку заново

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

  • /configure setup
  • /configure show
  • /configure validate

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

1Через Skills CLI (Vercel)

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

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

~/.claude/skills/configure/SKILL.md

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

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

Вопросы о configure

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

Выполните в терминале команду npx skills add bitwize-music-studio/claude-ai-music-skills --skill configure -a claude-code.

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

Он ведёт пошаговый диалог в терминале, собирает пути к каталогам и данные артиста, а затем записывает их в ~/.bitwize-music/config.yaml.

Какие параметры обязательны при настройке?

Скилл требует указать имя артиста artist.name и три базовые директории: paths.content_root, paths.audio_root и paths.documents_root.

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

SKILL.md · CC0-1.0
---
name: configure
description: Sets up or edits the plugin configuration file interactively. Use on first-time setup, when config is missing, or when the user wants to change settings.
argument-hint: "[setup | edit | show | validate | reset]"
model: sonnet
effort: low
allowed-tools:
  - Read
  - Write
  - Bash
  - AskUserQuestion
  - Glob
---

## Your Task

**Input**: $ARGUMENTS

Route based on argument:
- `setup` or no argument → Interactive first-time setup
- `edit` → Edit specific settings
- `show` → Display current configuration
- `validate` → Check config for issues
- `reset` → Delete config and start fresh

---

# Plugin Configuration Skill

You help users set up and manage their `~/.bitwize-music/config.yaml` configuration.

## Config Location

```
~/.bitwize-music/config.yaml
```

## Commands

### `/configure` or `/configure setup`

Interactive first-time setup. Guide user through creating their config.

**Steps:**

1. Check if `~/.bitwize-music/config.yaml` exists
2. If exists, ask if they want to overwrite or edit instead
3. If creating new:
   - Create `~/.bitwize-music/` directory if needed
   - Ask for each required setting interactively
   - Write the config file
   - Validate the result

**Required settings to ask:**
1. `artist.name` - "What's your artist/project name?"
2. `paths.content_root` - "Where should albums and projects be stored? (e.g., ~/music-projects)"
3. `paths.audio_root` - "Where should mastered audio files go? (e.g., ~/music-projects/audio)"
4. `paths.documents_root` - "Where should research documents/PDFs go? (e.g., ~/music-projects/documents)"

**Optional settings:**
5. `artist.genres` - "What are your primary genres? (comma-separated, or skip)"
6. `urls.soundcloud` - "SoundCloud profile URL? (or skip)"

**Step 5: Overrides Directory (Optional)**

Ask:
> You can optionally provide a path to a directory containing override files.
> This is where you can customize workflows and skills without plugin update conflicts.
>
> Override files you can create:
>   - CLAUDE.md (custom workflow instructions)
>   - pronunciation-guide.md (artist names, character names)
>   - explicit-words.md (custom explicit word list)
>
> Default: ~/music-projects/overrides
>
> Enter path (or press Enter to use default):

If user provides path:
- Add to config: `paths.overrides: "[user-path]"`

If user presses Enter (accepts default):
- Add to config: `paths.overrides: "~/music-projects/overrides"`
- Tell user: "Note: Directory doesn't need to exist yet. Create override files when you want to customize."

**Step 6: Album Ideas File (Optional)**

Ask:
> You can optionally provide a path to a file for tracking album ideas.
> This is managed by the /bitwize-music:album-ideas skill for brainstorming and planning.
>
> Default: ~/music-projects/IDEAS.md
>
> Enter path (or press Enter to use default):

If user provides path:
- Add to config: `paths.ideas_file: "[user-path]"`

If user presses Enter (accepts default):
- Add to config: `paths.ideas_file: "~/music-projects/IDEAS.md"`
- Tell user: "Note: File doesn't need to exist yet. The album-ideas skill creates it when first used."

**Example interaction:**
```
Let's set up your bitwize-music configuration.

What's your artist/project name?
> Neon Circuits

Where should albums and projects be stored?
(This is where your album folders, lyrics, and research will live)
> ~/music-projects

Where should mastered audio files go?
> ~/music-projects/audio

Where should research documents/PDFs go?
> ~/music-projects/documents

What are your primary genres? (comma-separated, or press Enter to skip)
> electronic, synthwave

SoundCloud profile URL? (or press Enter to skip)
> https://soundcloud.com/neon-circuits

Overrides directory path? (press Enter for default: ~/music-projects/overrides)
> [Enter]

Album ideas file path? (press Enter for default: ~/music-projects/IDEAS.md)
> [Enter]

Creating config at ~/.bitwize-music/config.yaml...

✓ Configuration saved!

Your settings:
  Artist: Neon Circuits
  Content: ~/music-projects
  Audio: ~/music-projects/audio
  Documents: ~/music-projects/documents
  Genres: electronic, synthwave
  SoundCloud: https://soundcloud.com/neon-circuits
  Overrides: ~/music-projects/overrides (will be used if created)
  Ideas File: ~/music-projects/IDEAS.md (will be created when first used)

You're ready to start creating albums!
```

### `/configure edit`

Edit specific settings without recreating the whole config.

**Steps:**
1. Read existing config
2. Show current values
3. Ask what they want to change
4. Update just that setting
5. Validate and save

**Example:**
```
Current configuration:

  artist.name: Neon Circuits
  paths.content_root: ~/music-projects
  paths.audio_root: ~/music-projects/audio
  paths.documents_root: ~/music-projects/documents
  artist.genres: [electronic, synthwave]
  urls.soundcloud: https://soundcloud.com/neon-circuits

What would you like to change?
```

### `/configure show`

Display the current configuration in a readable format.

**Steps:**
1. Read `~/.bitwize-music/config.yaml`
2. Display all settings in a formatted table
3. Note any missing required settings

**Example output:**
```
bitwize-music Configuration
Location: ~/.bitwize-music/config.yaml

┌─────────────────────┬────────────────────────────────────┐
│ Setting             │ Value                              │
├─────────────────────┼────────────────────────────────────┤
│ artist.name         │ Neon Circuits                      │
│ artist.genres       │ electronic, synthwave              │
│ paths.content_root  │ ~/music-projects                   │
│ paths.audio_root    │ ~/music-projects/audio             │
│ paths.documents_root│ ~/music-projects/documents         │
│ paths.overrides     │ ~/music-projects/overrides         │
│ paths.ideas_file    │ ~/music-projects/IDEAS.md          │
│ urls.soundcloud     │ https://soundcloud.com/neon-circuits│
│ generation.service  │ suno                               │
└─────────────────────┴────────────────────────────────────┘

✓ All required settings present
```

### `/configure validate`

Check the config for issues.

**Checks:**
1. Config file exists
2. All required fields present
3. Paths are valid (directories exist or can be created)
4. No syntax errors in YAML

**Example output:**
```
Validating ~/.bitwize-music/config.yaml...

✓ Config file exists
✓ artist.name: Neon Circuits
✓ paths.content_root: ~/music-projects (exists)
✓ paths.audio_root: ~/music-projects/audio (exists)
✓ paths.documents_root: ~/music-projects/documents (will be created)
✓ paths.overrides: ~/music-projects/overrides (will be used if created)
✓ paths.ideas_file: ~/music-projects/IDEAS.md (will be created when first used)
✓ generation.service: suno

All checks passed!
```

Or with issues:
```
Validating ~/.bitwize-music/config.yaml...

✓ Config file exists
✓ artist.name: Neon Circuits
✗ paths.content_root: not set (required)
✓ paths.audio_root: ~/music-projects/audio
✗ paths.documents_root: /invalid/path (directory doesn't exist)

2 issues found. Run /configure edit to fix.
```

### `/configure reset`

Delete config and optionally start fresh.

**Steps:**
1. Confirm user really wants to reset
2. Back up existing config to `config.yaml.bak`
3. Delete `~/.bitwize-music/config.yaml`
4. Ask if they want to run setup now

**Example:**
```
⚠️  This will delete your configuration at ~/.bitwize-music/config.yaml

Current config will be backed up to config.yaml.bak

Are you sure you want to reset? (yes/no)
```

If yes:
```
✓ Backed up to ~/.bitwize-music/config.yaml.bak
✓ Deleted ~/.bitwize-music/config.yaml

Config has been reset.

Would you like to set up a new config now? (yes/no)
```

---

## Config Template

When creating a new config, use this structure:

```yaml
# bitwize-music Plugin Configuration
# Generated by /configure

artist:
  name: "{artist_name}"
  genres:
    - "{genre1}"
    - "{genre2}"

paths:
  content_root: "{content_root}"
  audio_root: "{audio_root}"
  documents_root: "{documents_root}"
  overrides: "{overrides}"
  ideas_file: "{ideas_file}"

urls:
  soundcloud: "{soundcloud_url}"

generation:
  service: suno
```

---

## Edge Cases

### Config exists but is invalid YAML
- Back up the existing file: `config.yaml.bak`
- Offer to create fresh config

### Directory doesn't exist
- Offer to create it: "Directory ~/music-projects doesn't exist. Create it?"

### User provides relative path
- Expand to absolute: `./projects` → `/Users/name/projects`
- Or use `~` prefix: `~/projects`

---

## Remember

- **Preserve exact casing** - If user says "bitwize", write "bitwize" not "Bitwize"
- Always expand `~` in paths for display
- Create directories if they don't exist (with permission)
- Back up existing config before overwriting
- Validate after any changes
- Be friendly and explain what each setting does

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

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

Сначала — configure от других авторов.

configure официальный anthropics Скилл configure для Claude Code сохраняет токен Telegram-бота и проверяет политику доступа. Настраивает канал и контролирует подключения. CX Codex +1 3 861установок configure официальный anthropics Скилл configure для Claude Code проверяет подключение iMessage и настраивает список разрешённых контактов — фиксирует недоступность чата и ограничивает доступ к переписке. CX Codex +1 3 861установок configure официальный anthropics Скилл configure настраивает подключение Claude Code к Discord, сохраняет токен бота и помогает выстроить белый список доступа. CX Codex +1 3 861установок configure OrchestKit Интерактивный мастер для настройки OrchestKit: подключение MCP-серверов, права хуков, горячие клавиши, пресеты. Запускается при первой установке плагина и по команде /orchestkit:configure. CX Codex +1 196установок configure Rich627 Скилл configure настраивает подключение WhatsApp-канала к агенту через связку устройств Baileys или официальный Cloud API прямо в терминале. CX Codex +1 ★ 127звёзд репо codometer-configure organizzolini Скилл codometer-configure помогает писать и менять codometer.config.ts: задавать лимиты, входы, исключения и форматы отчёта для Codometer. CX Codex +1 363установок openspec-bootstrap sammcj Скилл openspec-bootstrap настраивает OpenSpec в репозитории: создаёт схему, конфигурацию и проверяет их. Нужен при первом запуске или изменении openspec/config.yaml. CX Codex +1 ★ 173звёзд репо grepai-config-reference yoanbernabeu Скилл grepai-config-reference описывает все параметры файла .grepai/config.yaml — эмбеддер, хранилище, чанкинг, трассировку вызовов и правила игнорирования. CX Codex +1 727установок config calesthio Разбирает, как ManimGL читает custom_config.yml: каталоги, камера, окно предпросмотра, стили. Агент правит нужные ключи в конфиге. CX Codex +1 ★ 78 316звёзд репо confdiff-mcp esperanza-volkov MCP-сервер confdiff-mcp сравнивает конфиги JSON, YAML, TOML, INI, .env и XML по данным, а не по тексту. Агент видит только настоящие изменения, а секреты остаются скрытыми. CX Codex +1 ★ 41звёзд репо ce-setup EveryInc Скилл ce-setup для Claude Code проверяет инструменты и конфигурацию Compound Engineering в репозитории, создаёт пакеты и обновляет документацию по коду. Запускается при настройке окружения или в CI. CX Codex +1 3 600установок

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

Весь набор →
genre-creator Скилл genre-creator для Claude Code создаёт документацию нового музыкального жанра и добавляет его в индекс и пресеты мастеринга. Расширяет библиотеку bitwize-music. CX Codex +1 248установок validate-album Скилл validate-album проверяет каталоги музыкального альбома, пути к аудиофайлам и поля треков перед релизом. Скилл опирается на утилиты MCP-сервера bitwize-music-mcp. CX Codex +1 248установок researchers-financial Скилл researchers-financial для Claude Code исследует финансовые документы и рыночные данные для музыкальных проектов о компаниях, финансовых преступлениях и событиях рынка. Он собирает источники и отмечает факты для проверки человеком. CX Codex +1 248установок next-step Скилл next-step определяет текущий статус музыкального альбома и подсказывает один следующий шаг с нужной командой. CX Codex +1 247установок cloud-uploader Скилл cloud-uploader загружает проморолики и сэмплер альбома в Cloudflare R2 или AWS S3. Используйте его после подготовки видео, когда файлы нужно разместить в облаке. CX Codex +1 247установок resume Скилл resume для Claude Code находит альбом по названию и показывает его статус и следующий конкретный шаг. Показывает, на каком этапе находится незавершённый альбом. CX Codex +1 246установок researchers-primary-source Скилл researchers-primary-source для Claude Code собирает высказывания субъекта из твитов, блогов, форумов и чатов. Ищет прямые цитаты и первичные источники вместо пересказов. CX Codex +1 246установок promote-idea Скилл promote-idea для Claude Code переводит идею альбома из IDEAS.md в рабочий проект одной командой. Меняет статус идеи на In Progress. CX Codex +1 188установок

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

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