bitwize-music

Bitwize Music Plugin — Hermes Agent

AI music generation workflow for Suno. This plugin provides 53 skills that turn a conversation into a full album production pipeline — from concept development to release.

[!NOTE] This is a Hermes plugin port of the claude-ai-music-skills project. Original license: CC0 (Public Domain).

---

Documentation

• USER_GUIDE.md: Complete step-by-step workflow guide detailing how to use all 53 skills to design, write, QC, generate, and master an album.
• HERMES_AGENT_INSTALL.md: Standard installation guide for Hermes Agent.

Install (Hermes Agent)

This plugin integrates with Hermes Agent by Nous Research using Markdown Skills and an MCP Server.

1. Link the Skills

Hermes Agent auto-discovers skills in ~/.hermes/skills/. Symlink the skills from this repository to your Hermes directory:

mkdir -p ~/.hermes/skills/music
# Run from the root of this repository
ln -sf "$(pwd)/skills/"* ~/.hermes/skills/music/

2. Set Up Python Environment & Dependencies

The MCP server requires Python dependencies. Create a virtual environment and install dependencies using uv (recommended):

# Create unified venv
uv venv ~/.bitwize-music/venv

# Install dependencies
uv pip install --python ~/.bitwize-music/venv -r requirements.txt

# Install Playwright browser for document-hunter (optional)
~/.bitwize-music/venv/bin/playwright install chromium

3. Configure the MCP Server

Add the MCP server to Hermes Agent using the CLI:

hermes mcp add bitwize-music-mcp \
  --command ~/.bitwize-music/venv/bin/python \
  --args "$(pwd)/servers/bitwize-music-server/run.py"

(Type Y to enable all enquired tools when prompted)

4. First-Time Configuration

Copy the example configuration to the tools directory:

cp config/config.example.yaml ~/.bitwize-music/config.yaml

Edit ~/.bitwize-music/config.yaml to configure your artist name and workspace directories.

---

Skills (53)

Skills are automatically activated by the AI agent based on context. Each skill contains domain expertise for a specific part of the music production workflow.

Album & Track Creation

Skill	Description
album-ideas	Track and manage album ideas
promote-idea	Convert a Pending idea into a full album
new-album	Create new album with directory structure
album-conceptualizer	Album concepts and tracklist architecture
lyric-writer	Write/review lyrics with professional prosody and rhyme craft
suno-engineer	Technical Suno V5/V5.5 prompting and genre selection

Research & Sources

Skill	Description
researcher	Main research coordinator, fact-checking
document-hunter	Automated document search/download
researchers-legal	Court documents, indictments
researchers-gov	DOJ/FBI/SEC releases
researchers-tech	Project histories, changelogs
researchers-journalism	Investigative articles
researchers-security	Malware analysis, CVEs
researchers-financial	SEC filings, market data
researchers-historical	Archives, timelines
researchers-biographical	Personal backgrounds
researchers-primary-source	Tweets, blogs, forums
researchers-verifier	Quality control, citation validation

Quality Control

Skill	Description
lyric-reviewer	Pre-generation QC gate (14-point checklist)
lyric-refiner	Post-writing multi-pass refinement
pronunciation-specialist	Scan for pronunciation risks
explicit-checker	Verify explicit content flags
plagiarism-checker	Check lyrics for phrases matching existing songs
voice-checker	Detect AI-written patterns in lyrics and prose
pre-generation-check	Final pre-generation checkpoint (6 gates)
validate-album	Validate album structure and paths

Production & Release

Skill	Description
album-art-director	Visual concepts and AI art prompts
mix-engineer	Audio polishing, fixing Suno artifacts
mastering-engineer	Audio mastering guidance
promo-director	Generate promo videos for social media
promo-writer	Platform-specific social media copy
promo-reviewer	Review and quality-check promo content
cloud-uploader	Upload promo videos to Cloudflare R2 or AWS S3
sheet-music-publisher	Convert audio to sheet music
release-director	Release coordination and distribution