Description

Generate music from text prompts using ElevenLabs Eleven Music API. Use when creating songs, soundtracks, jingles, lullabies, or any audio music from descriptions. Supports vocals with AI-generated lyrics, instrumental tracks, and multiple genres/styles. Requires paid ElevenLabs plan.

README (SKILL.md)

ElevenLabs Music Generation

Name: ElevenLabs Music
Author: clawdbotborges

Generate complete songs from text prompts with AI-generated lyrics and vocals.

Quick Start

# Basic generation (30 seconds)
uv run {baseDir}/scripts/generate_music.py "upbeat jazz piano"

# Longer track (3 minutes)
uv run {baseDir}/scripts/generate_music.py "epic orchestral battle music" --length 180

# Instrumental only (no vocals)
uv run {baseDir}/scripts/generate_music.py "lo-fi hip hop beats" --length 120 --instrumental

# Custom output path
uv run {baseDir}/scripts/generate_music.py "romantic bossa nova" -o /tmp/bossa.mp3

Options

Flag	Description
`-l, --length`	Duration in seconds (3-600, default: 30)
`-o, --output`	Output file path (default: /tmp/music.mp3)
`-i, --instrumental`	Force instrumental, no vocals

Prompt Engineering Tips

Be Specific About Style

Include genre, mood, tempo, and instruments
Reference decades or eras: "90s Brazilian romantic pagode", "1960s sci-fi TV theme"
Describe energy: "builds from soft to explosive", "relaxed and intimate"

For Vocals

Specify language: "vocals in Portuguese", "singing in Japanese"
Describe vocal style: "soulful male vocals", "ethereal female choir"
Include lyrical themes: "about love and saudade", "celebrating friendship"

Avoid Copyright Issues

Don't mention artist/band names directly
Describe the style instead: "classic 90s romantic samba style" not "like Raça Negra"
If rejected, the API returns a suggested alternative prompt

Example Prompts

MPB (Brazilian Popular Music)

A soulful MPB track featuring gentle acoustic guitar, warm nylon strings, 
and dreamy Rhodes piano. Bossa nova-influenced rhythm with soft brushed 
drums. Vocals in Portuguese express themes of saudade and the beauty of life.

Epic Orchestral

Epic military march with powerful brass fanfares, thundering timpani drums, 
and a soaring choir. Triumphant and heroic, with deep bass tubas, bold 
trumpets, snare rolls, and an anthemic melody building to a glorious crescendo.

Lullaby

Gentle orchestral lullaby with sweeping strings, soft brass, and ethereal 
wordless soprano vocals. Peaceful yet majestic, evoking wonder and hope. 
Perfect for falling asleep while dreaming of adventures.

Comedy Rock

Brazilian comedy rock with absurd, hilarious Portuguese lyrics full of 
wordplay. Mix energetic rock guitars with unexpected rhythms - forró 
breakdowns, pagode moments. Theatrical, exaggerated vocals singing about 
ridiculous situations.

Requirements

ElevenLabs API Key: Set ELEVENLABS_API_KEY environment variable
Paid Plan: Music API requires Creator plan or higher
uv: For running the Python script with dependencies

Supported Features

Text-to-music generation up to 10 minutes
AI-generated lyrics and vocals in multiple languages (English, Spanish, Portuguese, German, Japanese, etc.)
Instrumental-only mode
Most musical styles and genres

Usage Guidance

This skill appears to do what it says: it calls the ElevenLabs Music API and saves an MP3. Before installing, verify you trust the ElevenLabs service and are willing to provide ELEVENLABS_API_KEY. Be aware the script uses python-dotenv (load_dotenv) so a local .env file will be read — avoid placing unrelated secrets there or run the skill in an isolated environment. Ensure you have a paid ElevenLabs plan, the 'uv' runner, and the required Python dependencies installed in a controlled environment. If you need stronger isolation, run the script inside a container or ephemeral VM.

Capability Analysis

Type: OpenClaw Skill Name: elevenlabs-music Version: 1.0.1 The skill bundle is benign. The `SKILL.md` provides clear instructions for using the music generation feature and does not contain any prompt injection attempts against the agent. The `scripts/generate_music.py` script correctly uses the ElevenLabs API to generate music based on user input, saves the output to a local file (defaulting to `/tmp/music.mp3`), and handles API key and plan requirements. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, or obfuscation. All dependencies are legitimate and relevant to the stated purpose.

Capability Assessment

✓ Purpose & Capability

Name/description match the included script and instructions: the skill runs a Python script that calls ElevenLabs' music.compose API and writes an audio file. Requiring ELEVENLABS_API_KEY and the 'uv' runner is proportional to this purpose.

✓ Instruction Scope

SKILL.md instructs running the included script with uv and provides prompt/options. The instructions do not direct the agent to read unrelated system files or send data to unexpected endpoints. Note: the script calls load_dotenv(), which will read a local .env file if present (common for picking up ELEVENLABS_API_KEY).

✓ Install Mechanism

No install spec is provided (instruction-only with an included script). The script lists normal Python dependencies (elevenlabs, python-dotenv) in comments but does not auto-download arbitrary code from unknown URLs. This is low risk in the context of the declared functionality.

✓ Credentials

Only ELEVENLABS_API_KEY is required and declared as the primary credential, which is appropriate. As noted, python-dotenv may load additional environment variables from a local .env file—so any secrets in that file would be read by the script.

✓ Persistence & Privilege

The skill is not always-enabled and does not request system-wide persistence or modify other skills. It writes output to a user-specified path (default /tmp) which is expected behavior for a generation tool.

Version History

v1.0.1

Added prompt engineering tips and examples

v1.0.0

Initial release: Generate music from text prompts using ElevenLabs Eleven Music API

Metadata

Slug elevenlabs-music

Version 1.0.1

License —

All-time Installs 19

Active Installs 19

Total Versions 2

Frequently Asked Questions

What is ElevenLabs Music?

Generate music from text prompts using ElevenLabs Eleven Music API. Use when creating songs, soundtracks, jingles, lullabies, or any audio music from descriptions. Supports vocals with AI-generated lyrics, instrumental tracks, and multiple genres/styles. Requires paid ElevenLabs plan. It is an AI Agent Skill for Claude Code / OpenClaw, with 3249 downloads so far.

How do I install ElevenLabs Music?

Run "/install elevenlabs-music" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is ElevenLabs Music free?

Yes, ElevenLabs Music is completely free (open-source). You can download, install and use it at no cost.

Which platforms does ElevenLabs Music support?

ElevenLabs Music is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created ElevenLabs Music?

It is built and maintained by clawdbotborges (@clawdbotborges); the current version is v1.0.1.

More Skills

ElevenLabs Music