Skip to content

bitwize-music-studio/claude-ai-music-skills / skills/configure

configure

Verified

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.

FileKindSize
SETTINGS_REFERENCE.mdmarkdown3.9 KB
SKILL.mdskill md9.1 KB

SETTINGS_REFERENCE.md

View on GitHub
# Configure Skill - Settings Reference

Quick lookup for all configuration options. Full documentation: [${CLAUDE_PLUGIN_ROOT}/config/README.md](${CLAUDE_PLUGIN_ROOT}/config/README.md).

---

## Config File Location

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

---

## Required Settings

| Setting | Description | Example |
|---------|-------------|---------|
| `artist.name` | Your artist/project name | `"bitwize"` |
| `paths.content_root` | Albums, artists, research | `"~/music-projects"` |
| `paths.audio_root` | Mastered audio output | `"~/music-projects/audio"` |
| `paths.documents_root` | PDFs, primary sources | `"~/music-projects/documents"` |

---

## Optional Settings

### Artist Info

| Setting | Description | Example |
|---------|-------------|---------|
| `artist.genres` | Primary genres (array) | `["electronic", "hip-hop"]` |
| `artist.style` | Brief style description | `"dark industrial electronic"` |

**Tip**: `artist.style` helps Claude understand your overall vibe for consistent suggestions.

### Paths

| Setting | Description | Default |
|---------|-------------|---------|
| `paths.overrides` | Custom workflow overrides | `{content_root}/overrides` |
| `paths.ideas_file` | Album ideas tracking | `{content_root}/IDEAS.md` |

**Tip**: Override files let you customize skills without plugin update conflicts.

### Platform URLs

| Setting | Description |
|---------|-------------|
| `urls.soundcloud` | SoundCloud profile |
| `urls.spotify` | Spotify artist page |
| `urls.bandcamp` | Bandcamp page |
| `urls.youtube` | YouTube channel |
| `urls.twitter` | Twitter/X profile |

**Tip**: Used by release-director for post-release workflows.

### Generation Service

| Setting | Description | Default |
|---------|-------------|---------|
| `generation.service` | Music generation service | `suno` |

Currently only Suno is supported.

---

## Feature-Specific Settings

### Promo Videos (`promotion:`)

For `/bitwize-music:promo-director`:

| Setting | Description | Default |
|---------|-------------|---------|
| `promotion.default_style` | Visualization style | `pulse` |
| `promotion.duration` | Video duration (seconds) | `15` |
| `promotion.include_sampler` | Generate album sampler | `true` |
| `promotion.sampler_clip_duration` | Seconds per track in sampler | `12` |

**Styles**: pulse, bars, line, mirror, mountains, colorwave, neon, dual, circular

### Sheet Music (`sheet_music:`)

For `/bitwize-music:sheet-music-publisher`:

| Setting | Description | Default |
|---------|-------------|---------|
| `sheet_music.page_size` | Page size | `letter` |
| `sheet_music.section_headers` | Include [Verse] labels | `false` |

**Page sizes**: letter, 9x12, 6x9

### Cloud Storage (`cloud:`)

For `/bitwize-music:cloud-uploader`:

| Setting | Description |
|---------|-------------|
| `cloud.enabled` | Enable cloud uploads |
| `cloud.provider` | `r2` or `s3` |
| `cloud.public_read` | Make uploads public |

Provider-specific keys documented in [${CLAUDE_PLUGIN_ROOT}/reference/cloud/setup-guide.md](${CLAUDE_PLUGIN_ROOT}/reference/cloud/setup-guide.md).

---

## Quick Commands

```bash
# Show current config
/bitwize-music:configure show

# Edit a specific setting
/bitwize-music:configure edit

# Validate config for issues
/bitwize-music:configure validate

# Start fresh
/bitwize-music:configure reset
```

---

## Common Patterns

### Minimal Config

```yaml
artist:
  name: "my-artist"

paths:
  content_root: "~/music-projects"
  audio_root: "~/music-projects/audio"
  documents_root: "~/music-projects/documents"
```

### Full Config

See [${CLAUDE_PLUGIN_ROOT}/config/config.example.yaml](${CLAUDE_PLUGIN_ROOT}/config/config.example.yaml) for complete example with all options.

---

## See Also

- [SKILL.md](SKILL.md) - Full skill documentation
- [${CLAUDE_PLUGIN_ROOT}/config/README.md](${CLAUDE_PLUGIN_ROOT}/config/README.md) - Complete config reference with examples
- [${CLAUDE_PLUGIN_ROOT}/config/config.example.yaml](${CLAUDE_PLUGIN_ROOT}/config/config.example.yaml) - Example config file
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall