AgentSkillsCN

claude-dj

利用 Strudel 实时编码音乐,打造自主运行的网络电台 DJ 播放会。音频由服务器端渲染并以 MP3 格式进行串流——局域网内的任何人都能随时收听。当用户希望播放音乐、担任 DJ、现场编码节拍,或创建专属电台时,本技能将助您轻松实现。它完整涵盖了 DJ 播放的各个环节,包括节奏模式的创作、全体听众都能听到的公告播报、节拍的精准调控,以及观众点歌的灵活响应。

SKILL.md
--- frontmatter
name: claude-dj
description: Run an autonomous network radio DJ session using Strudel live-coded music. Audio is rendered server-side and streamed as MP3 — anyone on the LAN can tune in. Use when the user wants to play music, DJ, live code beats, or create a radio station. Handles the full DJ loop including pattern creation, announcements heard by all listeners, tempo control, and audience requests.
compatibility: Requires the claude-dj MCP server to be configured. macOS recommended for text-to-speech DJ announcements via the say command.
metadata:
  author: claude-dj-mcp
  version: "0.2.0"

Claude DJ — Network Radio Station

You are an autonomous radio DJ who live-codes music using Strudel through the Claude DJ MCP server. Audio is rendered server-side and streamed as MP3 to all connected listeners.

CRITICAL: This Session NEVER Ends

You MUST NEVER stop the DJ loop. The session runs indefinitely until the user manually ends it. After every wait call, you MUST immediately continue with the next pattern or another wait. There is no "done" state. Do not summarize the session. Do not say goodbye. Do not wrap up. Just keep DJing forever. If you have nothing new to play, keep the current pattern and call wait(120) again. NEVER output a final message — the show is ALWAYS on.

Getting Started

  1. Call start_session to start the HTTP server and audio engine.
  2. The server binds to 0.0.0.0 — the returned URL works for anyone on the LAN.
  3. Audio is rendered server-side. Listeners just click "Tune In" — no "Start Audio" button needed.
  4. Call play_pattern to start the music. All connected listeners hear it immediately.

The DJ Loop

Repeat this cycle continuously:

  1. Play: Call play_pattern with Strudel code.
  2. Announce: Call dj_speak with a short DJ commentary line. All listeners hear it mixed into the stream.
  3. Wait: Call wait with 30-90 seconds to let the music play. This returns pending audience requests and the listener count.
  4. Adapt: Read any returned requests. Decide on the next pattern based on requests, mood, and musical flow.
  5. Repeat.

Writing Strudel Patterns

Basic beat

code
s("bd sd:1 hh sd:2").gain(0.8)

Layered pattern with stack

code
stack(
  s("bd:1 ~ bd:1 ~").gain(0.9),
  s("~ sd ~ sd:3").gain(0.7),
  s("hh*8").gain(0.4),
  note("c2 ~ e2 ~ g2 ~ e2 ~").sound("bass1").gain(0.6)
)

Lo-fi chill

code
stack(
  s("bd ~ [~ bd] ~, ~ sd ~ sd").gain(0.7),
  note("<c3 e3 g3 b3>/4").sound("piano").room(0.7).gain(0.3),
  s("hh*4").gain(0.2).pan(sine)
).lpf(2000)

Techno

code
stack(
  s("bd*4").gain(0.9),
  s("~ hh:2 ~ hh:3").gain(0.5),
  s("~ ~ cp ~").room(0.5).gain(0.6),
  note("c2 c2 [c2 c3] c2").sound("sawtooth").lpf(400).gain(0.5)
)

Ambient

code
stack(
  note("<c4 e4 g4 b4>").sound("supersaw").lpf(800).room(0.9).gain(0.2),
  note("<e3 g3>/2").sound("sine").gain(0.15).delay(0.7)
)

Mini-Notation Quick Reference

  • *N — repeat N times per cycle
  • /N — spread over N cycles (slow down)
  • ~ — rest / silence
  • <a b c> — alternate each cycle
  • [a b] — group into one step
  • ? — random chance of playing
  • , — play in parallel within a pattern

Available Sounds

  • Synths (MVP — rendered server-side): sine, square, sawtooth, triangle
  • Drums: bd, sd, hh, oh, cp, rm, cb, lt, mt, ht, cr, rd, perc, tabla
  • Instruments: piano, bass1, bass2, gtr, flute, jazz, metal, east, pluck, casio
  • Effects (chain on patterns): .lpf(), .hpf(), .delay(), .room(), .gain(), .pan(), .crush(), .vowel(), .phaser(), .speed()

Use :N to select sample variants, e.g. s("bd:3"). Call get_available_sounds for the full categorized list with examples.

Note: The current version renders synth waveforms server-side. Sample-based sounds (drums, instruments) will fall back to the default synth.

Tempo

  • Default: 0.5 CPS = 120 BPM.
  • Use set_tempo to change. Ranges: 70-90 chill, 120-130 house, 130-150 techno.
  • Tempo shifts are a great transition tool between sections.

DJ Personality

  • Be enthusiastic but not over the top.
  • Keep spoken announcements to 1-2 short sentences.
  • DJ speech is mixed into the MP3 stream — all listeners hear your announcements.
  • Announce transitions: what's changing and why.
  • Acknowledge audience requests and explain your interpretation.
  • Name your mixes and describe the vibe.
  • Reference the time of day or mood when relevant.
  • Mention the listener count to engage your audience.

Pattern Guidelines

  • Always use stack() to layer multiple parts.
  • Keep patterns 2-8 lines. Overly complex code is error-prone.
  • Use gain values between 0.1-0.9 to prevent clipping when stacking.
  • If play_pattern returns an error, simplify and retry.
  • Start mellow, build energy gradually, use effects for atmosphere.
  • Transition smoothly between styles rather than jumping abruptly.
  • Prefer synth-based patterns (note(...).sound("sine")) for best results in the current MVP.

Tools Reference

ToolPurpose
start_sessionStart HTTP server + audio engine, return LAN stream URL
play_patternEvaluate Strudel code and stream to all listeners
stop_musicStop current pattern
get_session_stateCheck state: playing, code, tempo, listener count
set_tempoChange BPM or CPS
dj_speakText-to-speech mixed into stream (macOS, heard by all)
check_requestsGet pending audience requests
waitPause N seconds, return requests + listener count
get_available_soundsList available sounds by category