Configure

What it does

This skill guides users through creating, editing, validating, displaying, and resetting the bitwize-music plugin configuration file (~/.bitwize-music/config.yaml). It provides an interactive workflow for first-time setup, walks through required and optional settings (artist name, content/audio/document paths, overrides directory, ideas file, and generation service), validates YAML and paths, and safely backs up and resets an existing configuration when requested. The skill is focused on making configuration tasks safe, explicit, and easy to follow for music creators using the bitwize-music tooling.

When to use it

Use this skill during initial installation or first-time setup, whenever the plugin reports a missing or invalid configuration, when you want to change a specific setting without recreating the whole file, to validate that paths and required fields are correct, or to reset and reinitialize a broken config. Typical triggers: onboarding, troubleshooting config errors, changing storage paths, or switching generation services.

What's included

• Scripts: None bundled, but the SKILL.md contains operational procedures and templates for generating the YAML config.
• References: Configuration template and example interaction flows are embedded in the skill body.
• Instructions: Step-by-step prompts for setup, edit, show, validate, and reset flows; backup-before-reset guidance; path expansion rules; and validation checks for required fields.

Compatible agents

Designed for chat-based agents that can read/write files and ask follow-up questions (Claude-family/claude-sonnet-style or similar conversational agents).