/install song
Role
Create songs through a structured process. Gather musical preferences, generate lyrics, suggest harmony, prepare prompts for AI generators (Suno, Udio). Learn what works for each user.
Key flow: Discovery → Structure → Lyrics → Harmony → Polish → Generate
Storage
~/songs/
├── drafting/ # Active song drafts
│ └── {song-name}/
│ ├── current.md # ALWAYS read this first
│ ├── versions/ # v001.md, v002.md, ...
│ ├── notes.md # Ideas, inspiration, fragments
│ └── prompts.md # AI generator prompts tried
├── released/ # Finished songs
│ └── {song-name}/
│ ├── final.md # Final lyrics + chords
│ └── meta.md # Genre, key, BPM, notes
└── preferences.md # User style preferences
Version rule: Never edit in place. Copy to versions/, increment, edit copy, update current.md.
Quick Reference
| Topic | File |
|---|---|
| Songwriting phases | phases.md |
| Lyric writing techniques | lyrics.md |
| Chord progressions by mood | harmony.md |
| AI generator prompts | prompts.md |
| Song structure patterns | structure.md |
Process Summary
- Discovery — Genre, mood, theme, inspiration. Load user's previous preferences if stored.
- Structure — Choose form (verse-chorus-bridge, AABA, etc.). Define section lengths.
- Lyrics — Draft section by section. Check rhyme, meter, emotional arc. See
lyrics.md. - Harmony — Suggest progressions matching mood/genre. See
harmony.md. - Polish — Review singability, hook strength, flow. Iterate with user.
- Generate — Prepare AI music prompts with metatags. See
prompts.md.
Learning User Preferences
Track in ~/songs/preferences.md:
- Genres they gravitate toward
- Rhyme strictness (tight vs. loose)
- Vocabulary style (poetic vs. conversational)
- Themes that resonate
- Progressions they've liked
- What NOT to suggest (overused clichés, etc.)
Update after each song based on their feedback.
Boundaries
- Focus on pre-production: Lyrics, structure, harmony, prompts
- Not a music theory course: Explain enough to be useful, not exhaustive
- User's voice matters: Suggest alternatives, don't dictate
- Never claim the song is "finished" — always offer iteration
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install song - After installation, invoke the skill by name or use
/song - Provide required inputs per the skill's parameter spec and get structured output
What is Song?
Write original songs with guided lyric development, chord progressions, melody contours, and AI music generator prompts for composers at any level. It is an AI Agent Skill for Claude Code / OpenClaw, with 750 downloads so far.
How do I install Song?
Run "/install song" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Song free?
Yes, Song is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Song support?
Song is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Song?
It is built and maintained by Iván (@ivangdavila); the current version is v1.0.0.