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

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

Скилл setup проверяет Python-окружение и зависимости плагина, а затем подсказывает команды установки. Нужен при первом запуске или сбое MCP-сервера.

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

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

Что делает setup

Скилл запускает проверки Python, платформы, pipx и поддержки venv. Затем он смотрит отдельное окружение ~/.bitwize-music/venv и проверяет mcp, matchering, boto3, playwright и версии пакетов из requirements.txt.

Для установки используется общее виртуальное окружение: в него ставятся зависимости из requirements.txt, после чего для document hunter устанавливается Chromium через playwright. После этого нужно перезапустить Claude Code и повторно вызвать /bitwize-music:setup. На native Windows аудио-инструменты требуют WSL2.

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

  • проверить версию Python и поддержку venv
  • найти отсутствующие зависимости плагина
  • сверить версии пакетов с requirements.txt
  • установить Chromium для document hunter
  • проверить готовность MCP-сервера

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

  • Запусти /bitwize-music:setup и проверь все компоненты.
  • Проверь только зависимости MCP через /bitwize-music:setup mcp.
  • После установки зависимостей снова выполни /bitwize-music:setup, чтобы подтвердить готовность.

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

1Через Skills CLI (Vercel)

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

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

~/.claude/skills/setup/SKILL.md

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

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

Вопросы о setup

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

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

Что делает setup?

Скилл определяет Python-окружение, проверяет виртуальное окружение плагина и ищет установленные mcp, matchering, boto3 и playwright. Он также показывает команды для установки зависимостей.

Что нужно для работы setup на Windows?

Для native Windows используется py -3 и путь ~/.bitwize-music/venv/Scripts/. Аудио-инструментам нужен WSL2.

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

SKILL.md · CC0-1.0
---
name: setup
description: Detects your Python environment and guides you through installing plugin dependencies. Use on first-time setup or when MCP server fails to start.
argument-hint: <blank for full check | "mcp" | "mastering" | "document-hunter">
model: haiku
allowed-tools:
  - Bash
---

Base directory for this skill: ${CLAUDE_PLUGIN_BASE_DIR}

## Your Task

Guide the user through installing bitwize-music plugin dependencies based on their Python environment and requested components.

---

# Setup Assistant

You help users install and verify plugin dependencies.

---

## Step 1: Detect Environment

**Run these checks in parallel:**

```bash
# Python version
python3 --version

# Check if externally managed
python3 -c "import sysconfig; print(sysconfig.get_path('purelib'))" 2>&1 | grep -q "/usr" && echo "EXTERNALLY_MANAGED" || echo "USER_MANAGED"

# Check for pipx
command -v pipx >/dev/null 2>&1 && echo "pipx: installed" || echo "pipx: not installed"

# Check for venv support
python3 -m venv --help >/dev/null 2>&1 && echo "venv: supported" || echo "venv: not supported"

# Platform
uname -s
```

---

## Step 2: Check Component Status

**IMPORTANT:** Run these checks **sequentially**, not in parallel. If one check fails, continue with the remaining checks to show complete status.

**CRITICAL:** Always check the venv, not system Python!

```bash
# Set venv path (macOS/Linux/WSL uses bin/python3; native Windows uses Scripts/python.exe)
VENV_PYTHON=~/.bitwize-music/venv/bin/python3
[ -f "$VENV_PYTHON" ] || VENV_PYTHON=~/.bitwize-music/venv/Scripts/python.exe

# Check if venv exists
if [ -f "$VENV_PYTHON" ]; then
    echo "✅ Venv exists at ~/.bitwize-music/venv"

    # Check each component in the venv
    # 2.x serves MCPServer from mcp.server.mcpserver, 1.x serves FastMCP from
    # mcp.server.fastmcp; the server takes either, so probe both (#537).
    $VENV_PYTHON -c "import mcp.server.mcpserver" 2>/dev/null || $VENV_PYTHON -c "import mcp.server.fastmcp" 2>/dev/null && echo "✅ mcp installed" || echo "❌ mcp not installed (need mcp[cli]>=1.28.1,<3)"
    $VENV_PYTHON -c "import matchering; print('✅ matchering installed')" 2>&1 || echo "❌ matchering not installed"
    $VENV_PYTHON -c "import boto3; print('✅ boto3 installed')" 2>&1 || echo "❌ boto3 not installed"
    $VENV_PYTHON -c "from playwright.sync_api import sync_playwright; print('✅ playwright installed')" 2>&1 || echo "❌ playwright not installed"

    # Check for version drift against requirements.txt
    $VENV_PYTHON -c "
import importlib.metadata, pathlib
reqs = pathlib.Path('${CLAUDE_PLUGIN_ROOT}/requirements.txt').read_text()
stale = []
for line in reqs.splitlines():
    line = line.split('#')[0].strip()
    if not line or '==' not in line:
        continue
    name, _, ver = line.partition('==')
    name = name.split('[')[0].strip()
    try:
        installed = importlib.metadata.version(name)
        if installed != ver:
            stale.append(f'  {name}: {installed} → {ver}')
    except importlib.metadata.PackageNotFoundError:
        stale.append(f'  {name}: missing (needs {ver})')
if stale:
    print('⚠️  Version drift detected:')
    print('\n'.join(stale))
else:
    print('✅ All package versions match requirements.txt')
" 2>&1
else
    echo "❌ Venv not found at ~/.bitwize-music/venv"
    echo "   Run: python3 -m venv ~/.bitwize-music/venv   # macOS/Linux/WSL"
    echo "   Or:  py -3 -m venv ~/.bitwize-music/venv      # Windows"
fi
```

All components are installed together in the venv via requirements.txt.

---

## Step 3: Show Installation Commands

**Always use the unified venv approach** — it works on all platforms and is automatically detected by the plugin.

```bash
# Create unified venv (if it doesn't exist)
python3 -m venv ~/.bitwize-music/venv                                                    # macOS/Linux/WSL
py -3 -m venv ~/.bitwize-music/venv                                                       # Windows (native)

# Install ALL plugin dependencies
~/.bitwize-music/venv/bin/pip install -r ${CLAUDE_PLUGIN_ROOT}/requirements.txt                     # macOS/Linux/WSL
~/.bitwize-music/venv/Scripts/python.exe -m pip install -r ${CLAUDE_PLUGIN_ROOT}/requirements.txt   # Windows (native)

# Set up document hunter browser
~/.bitwize-music/venv/bin/playwright install chromium                                     # macOS/Linux/WSL
~/.bitwize-music/venv/Scripts/playwright.exe install chromium                             # Windows (native)
```

**That's it!** The plugin automatically detects and uses the platform venv (`~/.bitwize-music/venv` on macOS/Linux/WSL, `%USERPROFILE%\.bitwize-music\venv` on native Windows). No configuration needed.

**Works on:**
- ✅ Linux (externally-managed Python)
- ✅ macOS
- ✅ Windows (native — Core tier, best-effort; audio tooling needs WSL2)
- ✅ Windows (WSL)
- ✅ All other systems

---

## Step 4: Installation Guide

Present a clear, simple installation guide:

1. **Environment detected**: [Python version, Platform]
2. **Missing components**: [list what needs to be installed]
3. **Installation commands**:
   ```bash
   python3 -m venv ~/.bitwize-music/venv                                                  # macOS/Linux/WSL
   ~/.bitwize-music/venv/bin/pip install -r ${CLAUDE_PLUGIN_ROOT}/requirements.txt         # macOS/Linux/WSL
   ~/.bitwize-music/venv/bin/playwright install chromium                                   # macOS/Linux/WSL

   py -3 -m venv ~/.bitwize-music/venv                                                               # Windows (native)
   ~/.bitwize-music/venv/Scripts/python.exe -m pip install -r ${CLAUDE_PLUGIN_ROOT}/requirements.txt # Windows (native)
   ~/.bitwize-music/venv/Scripts/playwright.exe install chromium                                     # Windows (native)
   ```
4. **After installation**:
   - Restart Claude Code to reload the plugin
   - MCP server should show as running in `/plugin` status
   - Run `/bitwize-music:setup` again to verify

---

## Step 5: Verify Installation (if requested)

After user reports they've installed, re-run the checks from Step 2 and confirm:

✅ **MCP server**: Ready
✅ **Audio mastering**: Ready
✅ **Cloud uploads**: Ready
✅ **Document hunter**: Ready

**Next steps**: Run `/bitwize-music:configure` to set up your workspace paths.

---

## Output Format

Use clear sections with checkboxes for status:

```markdown
## bitwize-music Setup

### Environment
- Python: 3.12.3
- System: Linux

### Component Status
- [❌] MCP server
- [❌] Audio mastering
- [❌] Cloud uploads
- [❌] Document hunter

### Installation

Run these commands to install all plugin dependencies (macOS/Linux/WSL shown; see Step 3 for the Windows native `py -3` / `Scripts\` equivalents):

```bash
# Create unified venv
python3 -m venv ~/.bitwize-music/venv

# Install ALL dependencies
~/.bitwize-music/venv/bin/pip install -r ${CLAUDE_PLUGIN_ROOT}/requirements.txt

# Set up browser
~/.bitwize-music/venv/bin/playwright install chromium
```

**After installation:**
1. Restart Claude Code
2. All components will work automatically
3. Run `/bitwize-music:setup` to verify

The plugin automatically detects `~/.bitwize-music/venv` — everything just works!
```

---

## Remember

- **Be specific** - show exact commands for their environment
- **Prioritize user install** for externally-managed Python
- **Explain what each component does** so they can decide what to install
- **Test commands work** before suggesting them
- **Clear next steps** after installation

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

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

Каталог скиллов SKILL.md →

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

setup официальный anthropics Скилл setup проверяет, какие инструменты подключены, учит ваш стиль письма по отправленной почте и сразу строит стартовый дашборд без анкеты. Нужен при первом запуске. CX Codex +1 371установок setup Alireza Rezvani Скилл setup для Claude Code. Собирает настройки эксперимента autoresearch: цель, файл, команду оценки, метрику и направление улучшения. Запускает цикл оптимизации файла. CX Codex +1 1 480установок setup aws Скилл setup для Claude Code запускает настройку подключений к AWS DevOps Agent и AWS Security Agent. Запускает настройку при недоступности MCP-инструментов и начале работы с тулкитом. CX Codex +1 1 600установок setup marketcalls Скилл setup разворачивает виртуальное окружение Python для тестирования торговых стратегий на VectorBT и OpenAlgo. Настраивает зависимости, папки и файл .env. CX Codex +1 2 100установок setup assistant-ui Скилл setup для Claude Code устанавливает и настраивает assistant-ui через CLI. Он помогает создать приложение, добавить assistant-ui в Next.js-проект или обновить установку. CX Codex +1 6 400установок setup-matt-pocock-skills Matt Pocock Скилл setup-matt-pocock-skills настраивает репозиторий для инженерных скиллов Matt Pocock: задаёт трекер задач, метки триажа и расположение доменной документации. Запустите его перед первым использованием остальных скиллов. CX Codex +1 1 052 851установок setup-pre-commit Matt Pocock Скилл setup-pre-commit настраивает pre-commit для JavaScript-репозитория: Husky запускает форматирование, проверку типов и тесты перед коммитом. CX Codex +1 489 289установок prisma-database-setup prisma Скилл prisma-database-setup — устаревшее совместимое имя скилла prisma-orm-setup для настройки Prisma и восстановления подключения к базе данных. CX Codex +1 439 300установок prisma-postgres-setup prisma Скилл prisma-postgres-setup для Claude Code подключает Prisma Postgres к проекту или создаёт временную базу без регистрации. Охватывает старт с нуля и подключение через Vercel Marketplace. CX Codex +1 425 700установок xcode-project-setup Google LLC Скилл xcode-project-setup для Claude Code, Codex, Cursor и других агентов, который добавляет Swift Package и прописывает линковку модулей в .pbxproj через нативный Swift-скрипт. CX Codex +1 141 900установок caveman-setup JuliusBrussee Скилл caveman-setup для Claude Code перенаправляет вызовы LLM в репозитории через шлюз Caveman Cloud без изменения логики приложения. Шлюз фиксирует расходы на нейросети. CX Codex +1 127 300установок

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

Весь набор →
promo-writer Скилл promo-writer генерирует тексты для продвижения альбома в соцсетях с учётом формата каждой платформы. Пригодится перед релизом, когда шаблоны promo/ нужно заполнить. CX Codex +1 259установок tutorial Скилл tutorial проводит новичка через создание музыкального альбома: от идеи и жанра до треклиста, обложки и подтверждения плана. 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установок researchers-security Скилл researchers-security для Claude Code исследует вредоносное ПО, CVE, хакерские группы и отчёты об инцидентах. Проверяет темы и материалы о кибербезопасности. CX Codex +1 255установок researchers-biographical Скилл researchers-biographical для Claude Code собирает биографические сведения о людях, связанных с темой музыкального альбома. Исследует интервью, мотивы, поворотные моменты и личные детали. CX Codex +1 254установок researchers-journalism Скилл researchers-journalism для Claude Code ищет и анализирует журналистские расследования, интервью и новостное покрытие. Находит источники для проверки фактов и контекста в музыкальных проектах. CX Codex +1 254установок album-ideas Скилл album-ideas ведёт бэклог музыкальных концепций в файле IDEAS.md. Помогает собирать наброски, задавать жанры и переводить идеи в разработку. CX Codex +1 254установок

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

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