help

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