acestep-songwriting
by @dumoedss
Music songwriting guide for ACE-Step. Provides professional knowledge on writing captions, lyrics, choosing BPM/key/duration, and structuring songs. Use this skill when users want to create, write, or plan a song before generating it with ACE-Step.
clawhub install acestep-songwritingπ About This Skill
name: acestep-songwriting description: Music songwriting guide for ACE-Step. Provides professional knowledge on writing captions, lyrics, choosing BPM/key/duration, and structuring songs. Use this skill when users want to create, write, or plan a song before generating it with ACE-Step. allowed-tools: Read
ACE-Step Songwriting Guide
Professional music creation knowledge for writing captions, lyrics, and choosing music parameters for ACE-Step.
Output Format
After using this guide, produce two things for the acestep skill:
1. Caption (-c): Style/genre/instruments/emotion description
2. Lyrics (-l): Complete structured lyrics with tags
3. Parameters: --duration, --bpm, --key, --time-signature, --language
Caption: The Most Important Input
Caption is the most important factor affecting generated music.
Supports multiple formats: simple style words, comma-separated tags, complex natural language descriptions.
Common Dimensions
| Dimension | Examples | |-----------|----------| | Style/Genre | pop, rock, jazz, electronic, hip-hop, R&B, folk, classical, lo-fi, synthwave | | Emotion/Atmosphere | melancholic, uplifting, energetic, dreamy, dark, nostalgic, euphoric, intimate | | Instruments | acoustic guitar, piano, synth pads, 808 drums, strings, brass, electric bass | | Timbre Texture | warm, bright, crisp, muddy, airy, punchy, lush, raw, polished | | Era Reference | 80s synth-pop, 90s grunge, 2010s EDM, vintage soul, modern trap | | Production Style | lo-fi, high-fidelity, live recording, studio-polished, bedroom pop | | Vocal Characteristics | female vocal, male vocal, breathy, powerful, falsetto, raspy, choir | | Speed/Rhythm | slow tempo, mid-tempo, fast-paced, groovy, driving, laid-back | | Structure Hints | building intro, catchy chorus, dramatic bridge, fade-out ending |
Caption Writing Principles
1. Specific beats vague β "sad piano ballad with female breathy vocal" > "a sad song" 2. Combine multiple dimensions β style+emotion+instruments+timbre anchors direction precisely 3. Use references well β "in the style of 80s synthwave" conveys complex aesthetic quickly 4. Texture words are useful β warm, crisp, airy, punchy influence mixing and timbre 5. Don't pursue perfection β Caption is a starting point, iterate based on results 6. Granularity determines freedom β Less detail = more model creativity; more detail = more control 7. Avoid conflicting words β "classical strings" + "hardcore metal" degrades output - Fix: Repetition reinforcement β Repeat the elements you want more - Fix: Conflict to evolution β "Start with soft strings, middle becomes metal rock, end turns to hip-hop" 8. Don't put BPM/key/tempo in Caption β Use dedicated parameters instead
Lyrics: The Temporal Script
Lyrics controls how music unfolds over time. It carries:
Structure Tags
| Category | Tag | Description |
|----------|-----|-------------|
| Basic Structure | [Intro] | Opening, establish atmosphere |
| | [Verse] / [Verse 1] | Verse, narrative progression |
| | [Pre-Chorus] | Pre-chorus, build energy |
| | [Chorus] | Chorus, emotional climax |
| | [Bridge] | Bridge, transition or elevation |
| | [Outro] | Ending, conclusion |
| Dynamic Sections | [Build] | Energy gradually rising |
| | [Drop] | Electronic music energy release |
| | [Breakdown] | Reduced instrumentation, space |
| Instrumental | [Instrumental] | Pure instrumental, no vocals |
| | [Guitar Solo] | Guitar solo |
| | [Piano Interlude] | Piano interlude |
| Special | [Fade Out] | Fade out ending |
| | [Silence] | Silence |
Combining Tags
Use - for finer control, but keep it concise:
β
[Chorus - anthemic]
β [Chorus - anthemic - stacked harmonies - high energy - powerful - epic]
Put complex style descriptions in Caption, not in tags.
Caption-Lyrics Consistency
Models are not good at resolving conflicts. Checklist:
Vocal Control Tags
| Tag | Effect |
|-----|--------|
| [raspy vocal] | Raspy, textured vocals |
| [whispered] | Whispered |
| [falsetto] | Falsetto |
| [powerful belting] | Powerful, high-pitched singing |
| [spoken word] | Rap/recitation |
| [harmonies] | Layered harmonies |
| [call and response] | Call and response |
| [ad-lib] | Improvised embellishments |
Energy and Emotion Tags
| Tag | Effect |
|-----|--------|
| [high energy] | High energy, passionate |
| [low energy] | Low energy, restrained |
| [building energy] | Increasing energy |
| [explosive] | Explosive energy |
| [melancholic] | Melancholic |
| [euphoric] | Euphoric |
| [dreamy] | Dreamy |
| [aggressive] | Aggressive |
Lyric Writing Tips
1. 6-10 syllables per line β Model aligns syllables to beats; keep similar counts for lines in same position (Β±1-2)
2. Uppercase = stronger intensity β WE ARE THE CHAMPIONS! (shouting) vs walking through the streets (normal)
3. Parentheses = background vocals β We rise together (together)
4. Extend vowels β Feeeling so aliiive (use cautiously, effects unstable)
5. Clear section separation β Blank lines between sections
Avoiding "AI-flavored" Lyrics
| Red Flag | Description | |----------|-------------| | Adjective stacking | "neon skies, electric hearts, endless dreams" β vague imagery filler | | Rhyme chaos | Inconsistent patterns or forced rhymes breaking meaning | | Blurred boundaries | Lyric content crosses structure tags | | No breathing room | Lines too long to sing in one breath | | Mixed metaphors | Water β fire β flying β listeners can't anchor |
Metaphor discipline: One core metaphor per song, explore its multiple aspects.
Music Metadata
Most of the time, let LM auto-infer. Only set manually when you have clear requirements.
| Parameter | Range | Description |
|-----------|-------|-------------|
| bpm | 30β300 | Slow 60β80, mid 90β120, fast 130β180 |
| keyscale | Key | e.g. C Major, Am. Common keys (C, G, D, Am, Em) most stable |
| timesignature | Time sig | 4/4 (most common), 3/4 (waltz), 6/8 (swing) |
| vocal_language | Language | Usually auto-detected from lyrics |
| duration | Seconds | See duration calculation below |
When to Set Manually
| Scenario | Set |
|----------|-----|
| Daily generation | Let LM auto-infer |
| Clear tempo requirement | bpm |
| Specific style (waltz) | timesignature=3/4 |
| Match other material | bpm + duration |
| Specific key color | keyscale |
Duration Calculation
Estimation Method
BPM and Duration Relationship
Rule of thumb: When in doubt, estimate longer. A song too short feels rushed.
Note: Lyrics tags (piano, powerful, whispered) are consistent with Caption (piano ballad, building to powerful chorus, intimate).