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 vertical (9:16) for social media
- **Track status flow:** Not Started → In Progress → Generated → Final
- **Album status flow:** Concept → In Progress → Complete → Released

---

### Key Documentation

- **CLAUDE.md** - Main workflow instructions
- **README.md** - Project overview
- `${CLAUDE_PLUGIN_ROOT}/reference/suno/` - Suno guides (best practices, model catalog), pronunciation, tips
- `${CLAUDE_PLUGIN_ROOT}/reference/workflows/` - Detailed workflow procedures
- `${CLAUDE_PLUGIN_ROOT}/reference/mastering/` - Audio mastering documentation
- `${CLAUDE_PLUGIN_ROOT}/templates/` - Templates for new content
- `${CLAUDE_PLUGIN_ROOT}/skills/[skill-name]/SKILL.md` - Individual skill documentation

---

### Getting Help

- Use this skill anytime: `/bitwize-music:help`
- For tutorial: `/bitwize-music:tutorial`
- For status: `/bitwize-music:resume <album-name>`
- Ask Claude: "What should I do next?" for guidance