← Back to Skills Marketplace
ivangdavila

Song

by Iván · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
750
Downloads
3
Stars
3
Active Installs
1
Versions
Install in OpenClaw
/install song
Description
Write original songs with guided lyric development, chord progressions, melody contours, and AI music generator prompts for composers at any level.
README (SKILL.md)

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

  1. Discovery — Genre, mood, theme, inspiration. Load user's previous preferences if stored.
  2. Structure — Choose form (verse-chorus-bridge, AABA, etc.). Define section lengths.
  3. Lyrics — Draft section by section. Check rhyme, meter, emotional arc. See lyrics.md.
  4. Harmony — Suggest progressions matching mood/genre. See harmony.md.
  5. Polish — Review singability, hook strength, flow. Iterate with user.
  6. 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
Usage Guidance
This skill is instruction-only and appears coherent with its songwriting purpose. Before installing: be aware it expects to read and write files in ~/songs/ (drafts, versions, preferences) — check or create that directory if you want to control where content is stored. The skill prepares prompts for services like Suno/Udio but does not include API calls or require keys; if you later paste prompts into external generators, review those services' privacy policies. The skill source/homepage is unknown — that's common for small instruction-only skills, but if provenance matters to you, prefer skills with a verifiable homepage or author. If you keep sensitive personal details in lyrics, consider where those files are stored and who has access on your machine.
Capability Analysis
Type: OpenClaw Skill Name: song Version: 1.0.0 The OpenClaw skill bundle is designed to assist with songwriting, providing structured guidance and managing song drafts and user preferences within the `~/songs/` directory. All file operations and instructions are directly aligned with this stated purpose. There is no evidence of prompt injection attempts against the agent, data exfiltration, malicious execution, persistence mechanisms, or any other harmful behavior across any of the provided files.
Capability Assessment
Purpose & Capability
Name/description (songwriting, lyrics, harmony, AI prompts) align with the actual instructions and included reference files (lyrics.md, harmony.md, prompts.md). Required capabilities (reading/writing song drafts and preferences) are appropriate for a songwriting assistant.
Instruction Scope
All runtime instructions are prose only. The skill explicitly directs the agent to read/write a ~/songs/ directory (current.md, versions/, preferences.md) and to follow a versioning rule; this file I/O is coherent with pre-production/song-drafting purposes but does grant the skill the ability to create and update files in the user's home directory. The SKILL.md prepares prompts for external generators (Suno, Udio) but does not itself include API calls or endpoints.
Install Mechanism
No install spec and no code files — instruction-only. No packages, downloads, or executables are introduced.
Credentials
No environment variables, credentials, or config paths are requested. File access is limited to a single user-scoped path (~/songs/) which matches the skill's purpose.
Persistence & Privilege
always:false and normal invocation settings. The skill's own instructions tell it to create/update files under ~/songs/ (expected behavior). It does not request system-wide configuration changes or other skills' credentials.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install song
  3. After installation, invoke the skill by name or use /song
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release
Metadata
Slug song
Version 1.0.0
License
All-time Installs 3
Active Installs 3
Total Versions 1
Frequently Asked Questions

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.

💬 Comments