PlugWiki

music Skill (ElevenLabs) for Claude Code: Generate Music With the API

Teaches Claude Code to generate music with the ElevenLabs Music API: instrumentals, songs with lyrics, jingles and video soundtracks. Needs an API key.

Installs
11.9K
on skills.sh
Stars
528
on GitHub
Files
2
besides SKILL.md
Updated
Oct 2026
last repo commit

The music skill gives Claude the ElevenLabs Music API reference. Claude can write Python, TypeScript or CLI code that turns a text prompt into an MP3, builds a composition plan with per-section lyrics and styles, streams audio as it is generated, or scores a video. It triggers when you ask for instrumental tracks, songs with lyrics, background music or jingles.

It needs an ElevenLabs API key in ELEVENLABS_API_KEY and internet access. If the key is missing, the SKILL.md tells Claude to run the ElevenLabs CLI's onboard init command first. The folder holds 3 Markdown files and no scripts.

Good for

  • Developers adding generated music to an app or video pipeline
  • Creators who want background music scored to a video clip
  • Claude Code users with an ElevenLabs account

Install music

Claude Code

  1. 1

    Copy this prompt.

    Install the music skill in Claude Code. Run this command:

npx skills add https://github.com/elevenlabs/skills --skill music

Then check that it loaded and tell me how to use it.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

From its listing on skills.sh. Source.

What's in the skill

When it loads

Generate music using ElevenLabs Music API. Use when creating instrumental tracks, songs with lyrics, background music, jingles, or any AI-generated music composition. Supports prompt-based generation, composition plans for granular control, and detailed output with metadata.

Sections in SKILL.md

  1. Quick Start
  2. Python
  3. TypeScript
  4. CLI
  5. Methods
  6. Music Finetunes
  7. Video to Music
  8. Python
  9. TypeScript
  10. CLI
  11. Composition Plans
  12. Output Formats
  13. Streaming
  14. Detailed streaming
  15. Inpainting
  16. Content Restrictions

Key facts

Author
ElevenLabs
Repo
elevenlabs/skills
License
MIT
Installs on skills.sh
11,926 (Nov 2, 2026)
GitHub stars
528 (Nov 2, 2026), whole repo
Last commit
Oct 28, 2026 (repo)
Files in the skill folder
3 files including SKILL.md
Needs
An ElevenLabs API key (ELEVENLABS_API_KEY) and internet access
Works in
Any assistant that supports the Agent Skills spec, per the README; no client is named

What it includes

  • Generates audio from a prompt or a composition plan.

    Quick-start examples use model music_v2_5 and write the result to an MP3.

    Try: “Generate a 30 second chill lo-fi beat with jazzy piano chords”

    Files · music.compose

  • Streams audio chunks as they are generated.

    The SKILL.md marks streaming as available on paid plans.

    Network · music.stream

  • Creates a structured plan you can edit before composing.

    A plan is a list of up to 30 chunks, each with text, duration, positive and negative styles.

    Network · music.composition_plan.create

  • Returns audio plus the composition plan and metadata.

    Pass store_for_inpainting=True to keep the song for later edits.

    Network · music.compose_detailed

  • Streams audio with plan, metadata and optional word timestamps.

    Sent as server-sent events.

    Network · music.compose_detailed_stream

  • Generates background music from 1 to 10 uploaded video files.

    Limits stated: 200 MB total upload and 600 seconds total length.

    Files · music.video_to_music

  • Uploads audio for later inpainting.

    The SKILL.md says it is available to enterprise clients with inpainting access.

    Files · music.upload

  • Lists, creates, gets, updates and deletes music finetunes.

    Create one from uploaded training audio, poll until it completes, then pass its id when composing.

    Delete · music.finetunes.*

  • Re-generates part of a stored song.

    Mix audio reference chunks with new generation chunks in one plan.

    Network · Inpainting

From the official docs

Permissions

Low risk

Claude may run an npm-based ElevenLabs CLI command, write audio files, and send prompts and uploaded video to ElevenLabs with your API key. Approve each command and use a key you can revoke.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • It runs an npm package

    The SKILL.md tells Claude to run `npx -y @elevenlabs/cli@latest onboard init` when no key is set. Check the command before approving. github.com

  • Your video and audio files are uploaded

    video_to_music and upload send your files to the ElevenLabs API. Do not use footage you cannot share. github.com

  • Finetunes can be deleted

    The finetune methods include delete. Check the id before Claude runs it. github.com

Technical details
Scopes

  • ELEVENLABS_API_KEY

Questions

What does the music skill do?

It teaches Claude Code the ElevenLabs Music API. Claude can then write the code or CLI commands to generate a track from a prompt, control it section by section with a composition plan, or score a video.

How do I install it?

Use the install box above. The README also shows npx skills add elevenlabs/skills, which adds every skill in the ElevenLabs repo.

Do I need an API key?

Yes. The SKILL.md requires ELEVENLABS_API_KEY and internet access. If the key is missing, Claude is told to run the CLI's onboard init, which signs you in and stores a key for the project.

Can I ask for songs in the style of a named artist?

No. The SKILL.md lists content restrictions: you cannot reference specific artists or bands, or copyrighted lyrics. A rejected prompt returns a suggested rewording.

Does streaming work on a free plan?

The SKILL.md says streaming is for paid plans. Plain compose is the default path.

Is it safe?

The skill bundles no scripts. It does tell Claude to run npx -y @elevenlabs/cli@latest onboard init, which runs a package from npm, and to write files such as output.mp3. Approve commands one at a time.

Does it work in Claude.ai, Codex or Cursor?

The README says the skills work with any assistant that follows the Agent Skills spec, but names no client. The examples need an API key and use the CLI, Python or TypeScript.

Information

updated Nov 2, 2026

Repository
elevenlabs/skills
Folder
music

elevenlabs/skillsskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 3
  1. music SKILL.md · github.com
  2. elevenlabs/skills README · github.com
  3. music installation reference · github.com

Updated Nov 2, 2026.