AI agent skill · by @bitwize-music-studio

Help

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.

Archived 2026-10-23 · Source updated 2026-10-07 · License: CC0-1.0. Check the original repository for the latest version.

SKILL.md instructions

## 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