audio-router

Audio Router

Routes to 3 specialized skills based on audio requirements.

Routing Protocol

1. Classify — Identify audio task from user request
2. Match — Apply signal matching rules below
3. Combine — Audio-visual projects need 2-3 skills together
4. Load — Read matched SKILL.md files before implementation

Quick Route

Tier 1: Core Skills

Need	Skill	Signals
Playing audio, music, SFX	audio-playback	play, load, music, sound, mp3, transport, player, loop
Extracting audio data	audio-analysis	FFT, frequency, spectrum, amplitude, waveform, beat detection
Visual-audio connection	audio-reactive	visualizer, reactive, respond to audio, sync, pulse, beat-driven

Signal Matching

Primary Signals

audio-playback:

• "play audio", "load music", "sound effect"
• "Tone.js", "Player", "transport"
• "loop", "crossfade", "volume"
• "schedule", "timing", "sync to beat"
• "background music", "ambient sound"

audio-analysis:

• "FFT", "frequency", "spectrum"
• "beat detection", "amplitude"
• "waveform", "audio data"
• "frequency bands", "bass", "treble"
• "analyze", "extract", "measure"

audio-reactive:

• "visualizer", "audio reactive"
• "respond to music", "sync visuals"
• "pulse on beat", "frequency to color"
• "music driven", "audio visualization"
• "bloom on bass", "particles on beat"

Confidence Scoring

• High (3+ signals) — Route directly to matched skill
• Medium (1-2 signals) — Route with supporting skills
• Low (0 signals) — Start with audio-playback

Common Combinations

Simple Audio Player (1 skill)

audio-playback → Load and play audio files

Audio Visualizer (3 skills)

audio-playback → Load and control audio
audio-analysis → Extract frequency/beat data
audio-reactive → Map data to visual properties

Background Music (1-2 skills)

audio-playback → Looping, crossfade, volume
audio-analysis → Optional: beat sync features

Beat-Synced Animation (2-3 skills)

audio-analysis → Beat detection
audio-reactive → Trigger animations on beat
audio-playback → Control playback

Decision Table

Task	Primary Skill	Supporting Skills
Play music file	playback	-
Loop ambient sound	playback	-
Create visualizer	reactive	playback + analysis
Detect beats	analysis	playback
Pulse on bass	reactive	analysis + playback
Frequency spectrum display	analysis	playback
Sound effects	playback	-
Audio-reactive particles	reactive	analysis + playback
Volume meter	analysis	playback

Integration with Other Domains

With Post-Processing (postfx-*)

audio-analysis → Bass/high frequency data
audio-reactive → Mapping strategy
postfx-bloom → Audio-reactive glow intensity
postfx-effects → Audio-reactive chromatic aberration

Audio drives post-processing parameters.

With Particles (particles-*)

audio-analysis → Beat detection, energy levels
audio-reactive → Emission rate mapping
particles-systems → Particle emitter configuration

Beats trigger particle bursts, energy controls speed.

With GSAP (gsap-*)

audio-analysis → Beat detection
audio-reactive → Timeline control
gsap-sequencing → Beat-synced timeline

Audio events trigger or scrub GSAP timelines.

With R3F (r3f-*)

audio-playback → Audio context in React
audio-analysis → Data extraction
audio-reactive → Update Three.js objects
r3f-fundamentals → Scene/mesh setup

Audio data animates 3D scene properties.

With Shaders (shaders-*)

audio-analysis → Frequency uniforms
audio-reactive → Uniform update strategy
shaders-uniforms → Pass audio data to shaders

FFT data becomes shader uniforms for custom effects.

Workflow Patterns

Visualizer Development

1. audio-playback → Set up player and audio context
2. audio-analysis → Configure analyzers and band extraction
3. audio-reactive → Map frequencies to visual properties

Beat-Reactive Experience

1. audio-playback → Load audio
2. audio-analysis → Configure beat detection
3. audio-reactive → Define beat response animations

Ambient Soundscape

1. audio-playback → Looping players, crossfade
   (Single skill usually sufficient)

Temporal Collapse Stack

For the New Year countdown audio experience:

audio-playback → Cosmic ambient loop, countdown ticks, celebration
audio-analysis → Beat detection, bass/mid/high extraction
audio-reactive → Map to bloom, particles, digit glow, vignette

Key features:

• Background cosmic ambient audio (looped)
• Tick sound per second (intensifies in final 10)
• Beat detection for particle bursts
• Bass → bloom intensity
• High frequencies → chromatic aberration
• Celebration music at zero

Quick Reference

Task → Skills

Task	Skills Needed
"Play background music"	playback
"Loop ambient sound"	playback
"Crossfade between tracks"	playback
"Show frequency spectrum"	analysis + playback
"Detect beats in music"	analysis + playback
"Make visuals react to audio"	reactive + analysis + playback
"Pulse element on beat"	reactive + analysis
"Audio-reactive bloom"	reactive + analysis
"Sound effects on events"	playback

Audio Library Quick Reference

Library	Use Case
Tone.js	Full audio synthesis, analysis, effects
Howler.js	Simple playback, sprites, mobile
Web Audio API	Low-level, custom processing

Common Frequency Bands

Band	Range	Visual Use
Sub-bass	20-60 Hz	Deep pulses, rumble
Bass	60-250 Hz	Scale, intensity, beat
Low-mid	250-500 Hz	Background motion
Mid	500-2000 Hz	General energy
High-mid	2000-4000 Hz	Detail, sparkle
High	4000+ Hz	Shimmer, aberration

Fallback Behavior

• No specific signals → Start with audio-playback
• "Visualizer" mentioned → Full stack: all three skills
• "React to music" → audio-reactive + audio-analysis
• Just playing audio → audio-playback only
• Performance concerns → Focus on audio-analysis optimization

Performance Priority

When performance is critical:

1. audio-analysis — Use smaller FFT size (64-128)
2. audio-reactive — Apply smoothing to reduce jitter
3. audio-playback — Preload audio, reuse players