bitwize-music-studio/claude-ai-music-skills / skills/configure
configure
VerifiedSets 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.
| File | Kind | Size |
|---|---|---|
| SETTINGS_REFERENCE.md | markdown | 3.9 KB |
| SKILL.md | skill md | 9.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
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |