DJclaude

A Claude Code skill for AI music generation using Google's Lyria 3 — completely free.

What It Does

Generate 30-second clips or full 2-3 minute songs from text prompts. Control genre, BPM, instruments, mood, and song structure — all through natural language.

/make-music chill lo-fi hip hop beat, 85 BPM, Rhodes piano, vinyl crackle, rainy day vibes

/make-music triumphant orchestral piece in D major, 120 BPM, strings, brass, timpani, epic movie trailer energy

Install

1. Copy SKILL.md to your Claude Code skills directory:

   mkdir -p ~/.claude/skills/djclaude
   cp SKILL.md ~/.claude/skills/djclaude/

2. Get a free Gemini API key from Google AI Studio

3. Set the environment variable:

   export GEMINI_API_KEY="your-key-here"

4. Install the SDK:

   pip install google-genai

5. Use it in Claude Code:

   /make-music dreamy synthwave, analog pads, arpeggiated bass, 110 BPM
   

Models

Model	Duration	Best For
lyria-3-clip-preview	30 seconds	Loops, samples, quick ideas
lyria-3-pro-preview	2-3 minutes	Full songs with verses/choruses

Both are free on the Gemini free tier.

Prompt Tips

• Genre: lo-fi, synthwave, jazz, EDM, folk, classical, metal
• BPM: specify exact tempo
• Instruments: name specific instruments
• Mood: chill, energetic, melancholic, triumphant
• Structure: use [Intro], [Verse], [Chorus], [Bridge], [Outro]
• No vocals: say "instrumental only"

Requirements

• Python 3.10+
• google-genai SDK
• Free Gemini API key

License

MIT — Kevin Cline / ClawdWorks