bitwize-music-studio/claude-ai-music-skills / skills/help
help
VerifiedShows 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.2 KB |
| SKILL_GLOSSARY.md | markdown | 4.9 KB |
SKILL.md
View on GitHub---
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:generate` - Generate a track through Suno's MCP server (gates, cost, two takes, logging)
- `/bitwize-music:listen` - Play takes or local audio in the terminal, or open the song page in the browser
- `/bitwize-music:check-take` - Check takes against the track file with Suno's listening agent (free, advisory)
- `/bitwize-music:edit-take` - Fix one thing in a take and keep the rest of its audio, or make an instrumental version (10 Suno credits)
- `/bitwize-music:extend-take` - Carry a take on from a point in its audio and join the result (10 Suno credits)
- `/bitwize-music:sound-effects` - Make a sound effect, a one-shot or a loop for an album (2 Suno credits)
- `/bitwize-music:lyric-video` - Make a lyric video for a track through Suno, with the words burned in (free when measured)
- `/bitwize-music:music-video` - Make a music video for a track through Suno: storyboard, keyframes, a free animatic, then paid clips
- `/bitwize-music:suno-voice` - Put one of your saved Suno Voices on a track or an album, list them, or get the link to make one (free)
- `/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; makes the cover through Codex or Suno when `artwork.generator` is `codex` or `suno`
- `/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; on request, a clip generated by Suno (paid, in Visuals credits)
- `/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
- `/bitwize-music:release-kit` - The DistroKid and SoundCloud upload sheet: every field with a copy button, plus checks (free; never touches either site)
**File Management**
- `/bitwize-music:import-track` - Move track .md files to album location
- `/bitwize-music:import-audio` - Move audio files to album location, or pull the keeper from Suno (`--from-suno`)
- `/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_PLUGIN_ROOT}/reference/plugin-rules.md` - The workflow rules every session gets
- **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
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |