Skip to content
setup logo

Setup Assistant

setup

Detects your Python environment and guides you through installing plugin dependencies. Use on first-time setup or when MCP server fails to start.

SKILL.md

Full skill instructions

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:

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

# Set venv path
VENV_PYTHON=~/​.bitwize-music/​venv/​bin/​python3

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

    # Check each component in the venv
    $VENV_PYTHON -c "import mcp; print('✅ mcp installed')" 2>&1 || echo "❌ mcp not installed"
    $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"
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.

# Create unified venv (if it doesn't exist)
python3 -m venv ~/​.bitwize-music/​venv

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

# Set up document hunter browser
~/​.bitwize-music/​venv/​bin/​playwright install chromium

That's it! The plugin automatically detects and uses ~/​.bitwize-music/​venv. No configuration needed.

Works on:

  • ✅ Linux (externally-managed Python)
  • ✅ macOS
  • ✅ 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:
    python3 -m venv ~/​.bitwize-music/​venv
    ~/​.bitwize-music/​venv/​bin/​pip install -r ${CLAUDE_PLUGIN_ROOT}/​requirements.txt
    ~/​.bitwize-music/​venv/​bin/​playwright install chromium
    
  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:

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

```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

More skills from bitwize-music-studio

album-art-director logo
bitwize-music-studio/claude-ai-music-skills

album-art-director

Creates visual concepts for album artwork and generates AI art prompts. Use during planning for concept discussion, or after all tracks are Final for actual artwork generation.

531 0
View
test logo
bitwize-music-studio/claude-ai-music-skills

test

Runs automated tests to validate plugin integrity across 14 categories. Use before creating PRs, after making changes to skills or templates, or to verify plugin health.

531 0
View
resume logo
bitwize-music-studio/claude-ai-music-skills

resume

Finds an album by name and shows detailed status with next steps. Use when the user mentions an album name or wants to continue previous work.

531 0
View
import-art logo
bitwize-music-studio/claude-ai-music-skills

import-art

Places album art files in the correct audio and content directory locations. Use when the user has generated or downloaded album artwork that needs to be saved.

531 0
View
promo-director logo
bitwize-music-studio/claude-ai-music-skills

promo-director

Generates 15-second vertical promo videos for social media from mastered audio. Use after mastering is complete and before release, when the user wants social media content.

531 0
View
researchers-journalism logo
bitwize-music-studio/claude-ai-music-skills

researchers-journalism

Researches investigative articles, interviews, and news coverage. Use when research needs journalistic sources for cross-referencing or additional context.

531 0
View
promo-reviewer logo
bitwize-music-studio/claude-ai-music-skills

promo-reviewer

Reviews and iterates on social media copy in album promo/ files. Use after populating promo templates and before release to polish platform-specific posts.

531 0
View
next-step logo
bitwize-music-studio/claude-ai-music-skills

next-step

Analyzes album state and recommends the optimal next action. Use when the user asks "what should I do next?" or "what's left to do?

531 0
View
researcher logo
bitwize-music-studio/claude-ai-music-skills

researcher

Conducts investigative-grade research with primary source analysis, cross-verification, and trial-level depth. Use when an album needs factual research, source material, or verification of claims.

531 0
View
researchers-biographical logo
bitwize-music-studio/claude-ai-music-skills

researchers-biographical

Researches personal backgrounds, interviews, motivations, and humanizing details. Use when research needs biographical context about people involved in the album's subject.

531 0
View
new-album logo
bitwize-music-studio/claude-ai-music-skills

new-album

Creates a new album with the correct directory structure and templates. Use IMMEDIATELY when the user says 'make a new album' or similar, before any discussion.

531 0
View
validate-album logo
bitwize-music-studio/claude-ai-music-skills

validate-album

Validates album directory structure, file locations, and content integrity. Use before release or whenever the user wants to check an album's structural health.

531 0
View

Popular AI tools

Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View