Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Design & UI

claude-music-compose

Songwriting guide for ACE-Step music generation. Helps craft captions (style descriptions), lyrics with structure tags, and choose optimal BPM/key/duration/time signature.

AgriciDaniel · Static checks on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add AgriciDaniel/claude-music --skill claude-music-compose

About this skill


name: claude-music-compose description: > Songwriting guide for ACE-Step music generation. Helps craft captions (style descriptions), lyrics with structure tags, and choose optimal BPM/key/duration/time signature. when_to_use: > Use when user says "compose", "write lyrics", "songwriting", "plan a song", "caption help", or needs guidance before generating music. model: opus context: fork agent: music-composer allowed-tools:

  • Read

claude-music-compose — Songwriting Assistant

This is a READ-ONLY reference skill. Claude uses this knowledge to help craft optimal inputs for /music generate.

Execution

This sub-skill runs in a forked context (context: fork) and delegates the actual composition planning to the music-composer agent (skills/claude-music/agents/music-composer.md). The agent returns structured JSON ready to hand to music_engine.sh generate.

The reference material below is what the agent reads when it plans. It is also what you read when the user wants to learn the conventions rather than auto-compose.

Output Format

After composing, produce these for the generate command:

  1. Caption (-c): Style/genre/instruments/emotion (max 512 chars)
  2. Lyrics (-l): Structured lyrics with tags (max 4096 chars)
  3. Parameters: --duration, --bpm, --key, --time-sig, --language

Caption Crafting

Formula: Genre + mood + instruments + vocal style + production quality

Dimensions

DimensionExamples
Genrepop, rock, jazz, electronic, hip-hop, R&B, folk, classical, lo-fi, synthwave
Moodmelancholic, uplifting, energetic, dreamy, dark, nostalgic, euphoric, intimate
Instrumentsacoustic guitar, piano, synth pads, 808 drums, strings, brass, electric bass
Timbrewarm, bright, crisp, airy, punchy, lush, raw, polished
Era80s synth-pop, 90s grunge, 2010s EDM, vintage soul, modern trap
Productionlo-fi, high-fidelity, live recording, studio-polished, bedroom pop
Vocalsfemale vocal, male vocal, breathy, powerful, falsetto, raspy, choir
Rhythmslow tempo, mid-tempo, fast-paced, groovy, driving, laid-back

Principles

  1. Specific beats vague — "sad piano ballad, female breathy vocal" > "a sad song"
  2. Combine 3-5 dimensions — anchors the direction precisely
  3. Don't put BPM/key in caption — use dedicated parameters instead
  4. Avoid conflicting genres — "ambient metal" confuses the model
  5. Repetition reinforces — repeat elements you want emphasized
  6. Less detail = more creativity — let the model surprise you

Lyrics Structure

Tags

TagPurpose
[Verse] / [Verse 1]Narrative sections
[Chorus]Emotional climax, hook
[Pre-Chorus]Build energy before chorus
[Bridge]Transition or elevation
[Intro]Opening atmosphere
[Outro]Ending/conclusion
[Drop]Electronic energy release
[Breakdown]Reduced instrumentation
[Instrumental]No vocals section
[Guitar Solo]Specific instrument solo
[Fade Out]Fade ending

Density Rules

  • ~2-3 words per second of audio
  • 30s track: 60-90 words
  • 60s track: 120-180 words
  • 120s track: 240-360 words
  • Keep lines 4-8 words for vocal clarity
  • Simple, singable phrasing works best

Tips

  • Match lyrics emotion to caption mood
  • Avoid tongue twisters and complex vocabulary
  • Use line breaks between phrases
  • Chorus should be the most memorable/catchy section
  • Bridge should contrast with verse/chorus

Parameter Selection

BPM by Genre

GenreBPM RangeSweet Spot
Ballad60-8070
Lo-fi70-9080
R&B80-10090
Pop100-130120
Rock110-140125
House120-130125
Hip-hop80-11595
EDM128-150140
DnB160-180174
Trap130-170140

Duration Guide

Song TypeDurationNotes
Jingle/Short15-30sTikTok, ad music
Standard60-120sMost songs
Full song180-300sComplete arrangement
Extended300-600sAmbient, DJ sets

For detailed reference: load references/prompt-guide.md and references/music-theory.md