Suno Engineer

bitwize-music-studio/claude-ai-music-skills

Constructs V5/V5.5 style prompts for Suno by reading track files or concepts and outputting optimized genre selections, structure tags, and generation settings. Handles both lyrical and instrumental tracks, with special logic for instrumental workflows that skip the lyric-writer prerequisite entirely. The agent is opinionated about prompt structure: vocals first in the style box, explicit section tags in lyrics, and negative prompting limited to 2-4 exclusions max. Supports user override files for genre mappings and avoidance rules. Most useful when you're past the songwriting phase and need to translate creative intent into the literal, tag-driven format that V5 actually responds to.

skills.sh installs: 491
GitHub stars: 648
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add bitwize-music-studio/claude-ai-music-skills --skill suno-engineer --agent claude-code

Installs into .claude/skills of the current project.

Files

Your Task

Input: $ARGUMENTS

When invoked with a track file:

Read the track file
Check if instrumental: Look for instrumental: true in frontmatter or **Instrumental** | Yes in Track Details
Find album context: extract album directory from track path (dirname $(dirname $TRACK_PATH)), read that directory's README.md for album-level genre/theme/style. If README missing, use only track-level context.
Construct the style prompt and fill the Generation Settings table (model, Variety, Max Mode — see § Generation Settings)
Update the track file's Suno Inputs section

For instrumental tracks (no lyric-writer prerequisite):

Set Instrumental: On in Suno settings
Style Box: Focus on genre, instrumentation, mood, tempo — no vocal description needed
Lyrics Box: Use structural section tags only ([Intro], [Main Theme], [Bridge], [Outro], [End]) — no sung lyrics
Skip Streaming Lyrics, Pronunciation Notes, and Phonetic Review sections
This skill is the entry point for instrumental tracks (they skip lyric-writer entirely)