/help

name: help
description: Shows available skills, common workflows, and quick reference for the plugin. Use when the user asks for help, what skills are available, or how to do something.
model: haiku
allowed-tools: []

bitwize-music Plugin Help

Display this help information to the user in a clear, organized format.

---

Getting Started

**New to the plugin?**

• `/bitwize-music:tutorial` - Interactive guided album creation
• `/bitwize-music:configure` - Set up configuration file
• `/bitwize-music:about` - About bitwize and this plugin

**Resume existing work:**

• `/bitwize-music:resume <album-name>` - Find an album and see status/next steps

---

Skills by Category

**Album & Track Creation**

• `/bitwize-music:album-ideas` - Track and manage album ideas
• `/bitwize-music:promote-idea` - Convert a Pending idea into a full album (one-shot)
• `/bitwize-music:new-album` - Create new album with directory structure
• `/bitwize-music:album-conceptualizer` - Album concepts and tracklist architecture
• `/bitwize-music:lyric-writer` - Write/review lyrics, fix prosody
• `/bitwize-music:lyric-refiner` - Multi-pass lyric refinement and album cohesion
• `/bitwize-music:suno-engineer` - Technical Suno prompting and genre selection
• `/bitwize-music:genre-creator` - Add new genre documentation to the library

**Research & Sources**

• `/bitwize-music:researcher` - Main research coordinator, fact-checking
• `/bitwize-music:document-hunter` - Automated document search/download
• `/bitwize-music:researchers-legal` - Court documents, indictments
• `/bitwize-music:researchers-gov` - DOJ/FBI/SEC releases
• `/bitwize-music:researchers-tech` - Project histories, changelogs
• `/bitwize-music:researchers-journalism` - Investigative articles
• `/bitwize-music:researchers-security` - Malware analysis, CVEs
• `/bitwize-music:researchers-financial` - SEC filings, market data
• `/bitwize-music:researchers-historical` - Archives, timelines
• `/bitwize-music:researchers-biographical` - Personal backgrounds
• `/bitwize-music:researchers-primary-source` - Tweets, blogs, forums
• `/bitwize-music:researchers-verifier` - Quality control, citation validation
• `/bitwize-music:verify-sources` - Human source verification gate (required before generation)

**Quality Control**

• `/bitwize-music:lyric-reviewer` - Pre-generation QC gate (14-point checklist)
• `/bitwize-music:pronunciation-specialist` - Scan for pronunciation risks
• `/bitwize-music:explicit-checker` - Verify explicit content flags
• `/bitwize-music:plagiarism-checker` - Check lyrics for phrases matching existing songs
• `/bitwize-music:voice-checker` - Detect AI-written patterns in lyrics and prose
• `/bitwize-music:pre-generation-check` - Final pre-generation checkpoint (6 gates)
• `/bitwize-music:validate-album` - Validate album structure and paths

**Production & Release**

• `/bitwize-music:album-art-director` - Visual concepts and AI art prompts
• `/bitwize-music:mix-engineer` - Per-stem audio polish before mastering
• `/bitwize-music:mastering-engineer` - Audio mastering guidance
• `/bitwize-music:promo-director` - Generate promo videos for social media
• `/bitwize-music:promo-writer` - Generate platform-specific social media copy
• `/bitwize-music:promo-reviewer` - Review and polish promo copy before release
• `/bitwize-music:cloud-uploader` - Upload promo videos to Cloudflare R2 or AWS S3
• `/bitwize-music:sheet-music-publisher` - Convert audio to sheet music
• `/bitwize-music:release-director` - Release coordination and distribution

**File Management**

• `/bitwize-music:import-track` - Move track .md files to album location
• `/bitwize-music:import-audio` - Move audio files to album location
• `/bitwize-music:import-art` - Place album art in correct locations
• `/bitwize-music:rename` - Rename an album or track (updates slugs and all paths)
• `/bitwize-music:clipboard` - Copy track lyrics/prompts to clipboard

**Workflow & Status**

• `/bitwize-music:session-start` - Run session startup procedure
• `/bitwize-music:next-step` - Get recommended next action
• `/bitwize-music:album-dashboard` - Visual album progress dashboard

**System & Maintenance**

• `/bitwize-music:configure` - Edit plugin configuration
• `/bitwize-music:setup` - Detect environment and install plugin dependencies
• `/bitwize-music:health-check` - Check venv and skill registration health
• `/bitwize-music:test` - Run automated tests
• `/bitwize-music:help` - Show this help (you are here!)
• `/bitwize-music:about` - About bitwize and the plugin

---

Common Workflows

**Creating a New Album:** 1. `/bitwize-music:new-album <name> <genre>` - Create structure (or `/bitwize-music:promote-idea "<idea title>"` if the idea lives in `IDEAS.md`) 2. Answer the 7 planning phases (concept, sonic direction, etc.) 3. Write lyrics for each track 4. Run `/bitwize-music:lyric-reviewer` before generation 5. Generate in Suno, log results 6. Polish stems with `/bitwize-music:mix-engineer`, then master with `/bitwize-music:mastering-engineer` 7. [Optional] Generate promo videos with `/bitwize-music:promo-director` 8. [Optional] Upload to cloud with `/bitwize-music:cloud-uploader` 9. Release with `/bitwize-music:release-director`

**True-Story Albums (with research):** 1. Use researcher skills to gather sources 2. All sources must be verified by human before production 3. Update track status from `❌ Pending` to `✅ Verified (DATE)` 4. Then proceed with lyric writing and generation

**Resume Existing Work:** 1. `/bitwize-music:resume <album-name>` - Get detailed status 2. Follow the recommended next steps

---

Quick Tips

• **Config file:** `~/.bitwize-music/config.yaml` (always read this for paths)
• **Pronunciation:** Use phonetic spelling for tricky words (see pronunciation guide)
• **Explicit content:** Use flag for: fuck, shit, bitch, cunt, cock, dick, pussy, etc.
• **Mastering target:** -14 LUFS, -1.0 dBTP for streaming platforms
• **Promo videos:** Generate after mastering, 15s vert