{"id":"configure","name":"configure","summary":"プラグインの設定ファイルをインタラクティブに設定または編集できます。初回セットアップ時、設定が抜けている時、またはユーザーが設定を変更したい時に使います。","body":"## Your Task\n\n**Input**: $ARGUMENTS\n\nRoute based on argument:\n- `setup` or no argument → Interactive first-time setup\n- `edit` → Edit specific settings\n- `show` → Display current configuration\n- `validate` → Check config for issues\n- `reset` → Delete config and start fresh\n\n---\n\n# Plugin Configuration Skill\n\nYou help users set up and manage their `~/.bitwize-music/config.yaml` configuration.\n\n## Config Location\n\n```\n~/.bitwize-music/config.yaml\n```\n\n## Commands\n\n### `/configure` or `/configure setup`\n\nInteractive first-time setup. Guide user through creating their config.\n\n**Steps:**\n\n1. Check if `~/.bitwize-music/config.yaml` exists\n2. If exists, ask if they want to overwrite or edit instead\n3. If creating new:\n   - Create `~/.bitwize-music/` directory if needed\n   - Ask for each required setting interactively\n   - Write the config file\n   - Validate the result\n\n**Required settings to ask:**\n1. `artist.name` - \"What's your artist/project name?\"\n2. `paths.content_root` - \"Where should albums and projects be stored? (e.g., ~/music-projects)\"\n3. `paths.audio_root` - \"Where should mastered audio files go? (e.g., ~/music-projects/audio)\"\n4. `paths.documents_root` - \"Where should research documents/PDFs go? (e.g., ~/music-projects/documents)\"\n\n**Optional settings:**\n5. `artist.genres` - \"What are your primary genres? (comma-separated, or skip)\"\n6. `urls.soundcloud` - \"SoundCloud profile URL? (or skip)\"\n\n**Step 5: Overrides Directory (Optional)**\n\nAsk:\n> You can optionally provide a path to a directory containing override files.\n> This is where you can customize workflows and skills without plugin update conflicts.\n>\n> Override files you can create:\n>   - CLAUDE.md (custom workflow instructions)\n>   - pronunciation-guide.md (artist names, character names)\n>   - explicit-words.md (custom explicit word list)\n>\n> Default: ~/music-projects/overrides\n>\n> Enter path (or press Enter to use default):\n\nIf user provides path:\n- Add to config: `paths.overrides: \"[user-path]\"`\n\nIf user presses Enter (accepts default):\n- Add to config: `paths.overrides: \"~/music-projects/overrides\"`\n- Tell user: \"Note: Directory doesn't need to exist yet. Create override files when you want to customize.\"\n\n**Step 6: Album Ideas File (Optional)**\n\nAsk:\n> You can optionally provide a path to a file for tracking album ideas.\n> This is managed by the /bitwize-music:album-ideas skill for brainstorming and planning.\n>\n> Default: ~/music-projects/IDEAS.md\n>\n> Enter path (or press Enter to use default):\n\nIf user provides path:\n- Add to config: `paths.ideas_file: \"[user-path]\"`\n\nIf user presses Enter (accepts default):\n- Add to config: `paths.ideas_file: \"~/music-projects/IDEAS.md\"`\n- Tell user: \"Note: File doesn't need to exist yet. The album-ideas skill creates it when first used.\"\n\n**Example interaction:**\n```\nLet's set up your bitwize-music configuration.\n\nWhat's your artist/project name?\n> Neon Circuits\n\nWhere should albums and projects be stored?\n(This is where your album folders, lyrics, and research will live)\n> ~/music-projects\n\nWhere should mastered audio files go?\n> ~/music-projects/audio\n\nWhere should research documents/PDFs go?\n> ~/music-projects/documents\n\nWhat are your primary genres? (comma-separated, or press Enter to skip)\n> electronic, synthwave\n\nSoundCloud profile URL? (or press Enter to skip)\n> https://soundcloud.com/neon-circuits\n\nOverrides directory path? (press Enter for default: ~/music-projects/overrides)\n> [Enter]\n\nAlbum ideas file path? (press Enter for default: ~/music-projects/IDEAS.md)\n> [Enter]\n\nCreating config at ~/.bitwize-music/config.yaml...\n\n✓ Configuration saved!\n\nYour settings:\n  Artist: Neon Circuits\n  Content: ~/music-projects\n  Audio: ~/music-projects/audio\n  Documents: ~/music-projects/documents\n  Genres: electronic, synthwave\n  SoundCloud: https://soundcloud.com/neon-circuits\n  Overrides: ~/music-projects/overrides (will be used if created)\n  Ideas File: ~/music-projects/IDEAS.md (will be created when first used)\n\nYou're ready to start creating albums!\n```\n\n### `/configure edit`\n\nEdit specific settings without recreating the whole config.\n\n**Steps:**\n1. Read existing config\n2. Show current values\n3. Ask what they want to change\n4. Update just that setting\n5. Validate and save\n\n**Example:**\n```\nCurrent configuration:\n\n  artist.name: Neon Circuits\n  paths.content_root: ~/music-projects\n  paths.audio_root: ~/music-projects/audio\n  paths.documents_root: ~/music-projects/documents\n  artist.genres: [electronic, synthwave]\n  urls.soundcloud: https://soundcloud.com/neon-circuits\n\nWhat would you like to change?\n```\n\n### `/configure show`\n\nDisplay the current configuration in a readable format.\n\n**Steps:**\n1. Read `~/.bitwize-music/config.yaml`\n2. Display all settings in a formatted table\n3. Note any missing required settings\n\n**Example output:**\n```\nbitwize-music Configuration\nLocation: ~/.bitwize-music/config.yaml\n\n┌─────────────────────┬────────────────────────────────────┐\n│ Setting             │ Value                              │\n├─────────────────────┼────────────────────────────────────┤\n│ artist.name         │ Neon Circuits                      │\n│ artist.genres       │ electronic, synthwave              │\n│ paths.content_root  │ ~/music-projects                   │\n│ paths.audio_root    │ ~/music-projects/audio             │\n│ paths.documents_root│ ~/music-projects/documents         │\n│ paths.overrides     │ ~/music-projects/overrides         │\n│ paths.ideas_file    │ ~/music-projects/IDEAS.md          │\n│ urls.soundcloud     │ https://soundcloud.com/neon-circuits│\n│ generation.service  │ suno                               │\n└─────────────────────┴────────────────────────────────────┘\n\n✓ All required settings present\n```\n\n### `/configure validate`\n\nCheck the config for issues.\n\n**Checks:**\n1. Config file exists\n2. All required fields present\n3. Paths are valid (directories exist or can be created)\n4. No syntax errors in YAML\n\n**Example output:**\n```\nValidating ~/.bitwize-music/config.yaml...\n\n✓ Config file exists\n✓ artist.name: Neon Circuits\n✓ paths.content_root: ~/music-projects (exists)\n✓ paths.audio_root: ~/music-projects/audio (exists)\n✓ paths.documents_root: ~/music-projects/documents (will be created)\n✓ paths.overrides: ~/music-projects/overrides (will be used if created)\n✓ paths.ideas_file: ~/music-projects/IDEAS.md (will be created when first used)\n✓ generation.service: suno\n\nAll checks passed!\n```\n\nOr with issues:\n```\nValidating ~/.bitwize-music/config.yaml...\n\n✓ Config file exists\n✓ artist.name: Neon Circuits\n✗ paths.content_root: not set (required)\n✓ paths.audio_root: ~/music-projects/audio\n✗ paths.documents_root: /invalid/path (directory doesn't exist)\n\n2 issues found. Run /configure edit to fix.\n```\n\n### `/configure reset`\n\nDelete config and optionally start fresh.\n\n**Steps:**\n1. Confirm user really wants to reset\n2. Back up existing config to `config.yaml.bak`\n3. Delete `~/.bitwize-music/config.yaml`\n4. Ask if they want to run setup now\n\n**Example:**\n```\n⚠️  This will delete your configuration at ~/.bitwize-music/config.yaml\n\nCurrent config will be backed up to config.yaml.bak\n\nAre you sure you want to reset? (yes/no)\n```\n\nIf yes:\n```\n✓ Backed up to ~/.bitwize-music/config.yaml.bak\n✓ Deleted ~/.bitwize-music/config.yaml\n\nConfig has been reset.\n\nWould you like to set up a new config now? (yes/no)\n```\n\n---\n\n## Config Template\n\nWhen creating a new config, use this structure:\n\n```yaml\n# bitwize-music Plugin Configuration\n# Generated by /configure\n\nartist:\n  name: \"{artist_name}\"\n  genres:\n    - \"{genre1}\"\n    - \"{genre2}\"\n\npaths:\n  content_root: \"{content_root}\"\n  audio_root: \"{audio_root}\"\n  documents_root: \"{documents_root}\"\n  overrides: \"{overrides}\"\n  ideas_file: \"{ideas_file}\"\n\nurls:\n  soundcloud: \"{soundcloud_url}\"\n\ngeneration:\n  service: suno\n```\n\n---\n\n## Edge Cases\n\n### Config exists but is invalid YAML\n- Back up the existing file: `config.yaml.bak`\n- Offer to create fresh config\n\n### Directory doesn't exist\n- Offer to create it: \"Directory ~/music-projects doesn't exist. Create it?\"\n\n### User provides relative path\n- Expand to absolute: `./projects` → `/Users/name/projects`\n- Or use `~` prefix: `~/projects`\n\n---\n\n## Remember\n\n- **Preserve exact casing** - If user says \"bitwize\", write \"bitwize\" not \"Bitwize\"\n- Always expand `~` in paths for display\n- Create directories if they don't exist (with permission)\n- Back up existing config before overwriting\n- Validate after any changes\n- Be friendly and explain what each setting does","author":"@bitwize-music-studio","ownerProfile":null,"authorContacts":null,"sourceUrl":"https://github.com/bitwize-music-studio/claude-ai-music-skills/tree/main/skills/configure","license":"CC0-1.0","category":"writing","lang":"en","tokens":2117,"stars":0,"calls30d":2,"claimed":false,"visibility":"public","origin":"crawler","version":"0.1.0","createdAt":"2026-08-22","updatedAt":"2026-08-22","files":[{"path":"SETTINGS_REFERENCE.md","size":4036,"sha256":"28b8bce17eda43fe4dad4db14d784d7c21a51f034bab5b0b55f869c042f9847c"}],"requires":{"mcp":[],"tools":["Read","Write","Bash","AskUserQuestion","Glob"]},"safety":{"flags":[],"scannedAt":"2026-08-22","hasScripts":false,"networkEndpoints":["soundcloud.com"]}}