Skip to main content
skill CX Codex

2000s-visualization-expert — Claude Code skill for Milkdrop visuals

2000s-visualization-expert — a skill for rebuilding 2000s music visualizers — Milkdrop, AVS, Geiss — with WebGL and Web Audio. Use it when a player needs an audio-reactive backdrop or generative art driven by music.

MIT 190 installs ★ 274 updated 2026-10-30

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add curiositech/some_claude_skills --skill 2000s-visualization-expert -a claude-code
Open on GitHub

What 2000s-visualization-expert does

The skill walks through Butterchurn setup for Milkdrop presets, AnalyserNode FFT extraction, and GLSL shaders that respond to bass, mid and treble. It ships TypeScript and GLSL snippets, an integration checklist, and preset names sorted by vibe.

It also flags the usual failures: an AudioContext that stays suspended until a click, linear frequency bins that bury the treble, raw FFT data that jitters every frame. The boundaries are explicit — plain spectrum bars belong in Canvas 2D, and playback bugs are not this skill's job.

You need a browser with WebGL and Web Audio API. Compile shaders during loading rather than playback; doing it on the UI thread will drop frames and make the audio stutter.

What it helps with

  • Wire up Butterchurn and load Milkdrop presets
  • Pull frequency bands out of AnalyserNode
  • Write a GLSL shader that reacts to bass via uniform
  • Smooth FFT data so visuals stop flickering
  • Clean up requestAnimationFrame on unmount

Example prompts for the agent

  • Build a full-screen Butterchurn visualizer and connect it to my audio element
  • Show me how to map AnalyserNode bins logarithmically for a spectrum display
  • Write a GLSL fragment shader that pulses with the bass uniform

How to install 2000s-visualization-expert

1Skills CLI (Vercel)

npx skills add curiositech/some_claude_skills --skill 2000s-visualization-expert -a claude-code

2Manually: put the files in place

~/.claude/skills/2000s-visualization-expert/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/2000s-visualization-expert/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about 2000s-visualization-expert

How do I install 2000s-visualization-expert in Claude Code?

Run npx skills add curiositech/some_claude_skills --skill 2000s-visualization-expert -a claude-code. The skill lands in ~/.claude/skills/2000s-visualization-expert/SKILL.md.

What does 2000s-visualization-expert do?

It helps you build Milkdrop-style audio-reactive visuals: Butterchurn integration, FFT analysis with Web Audio API, and GLSL shaders for psychedelic effects.

Why does the visualizer stay blank until I click?

AudioContext starts suspended, and browsers require a user gesture. The skill points to await audioContext.resume() inside a click handler.

Source text

SKILL.md · MIT
---
name: 2000s-visualization-expert
description: Expert in 2000s-era music visualization (Milkdrop, AVS, Geiss) and modern WebGL implementations. Specializes in Butterchurn integration, Web Audio API AnalyserNode FFT data, GLSL shaders for
  audio-reactive visuals, and psychedelic generative art. Activate on "Milkdrop", "music visualization", "WebGL visualizer", "Butterchurn", "audio reactive", "FFT visualization", "spectrum analyzer". NOT
  for simple bar charts/waveforms (use basic canvas), video editing, or non-audio visuals.
allowed-tools: Read,Write,Edit,Bash,WebFetch
metadata:
  category: Design & Creative
  pairs-with:
  - skill: sound-engineer
    reason: Audio processing feeds the visualizations
  - skill: metal-shader-expert
    reason: Advanced GPU shader techniques
  tags:
  - audio
  - webgl
  - visualization
  - shaders
  - music
---

# 2000s Music Visualization Expert

Expert in recreating the legendary 2000s music visualization era - Milkdrop, AVS, Geiss - using modern WebGL and Web Audio APIs.

## When to Use

✅ **Use for:**
- Implementing Milkdrop-style psychedelic visualizations
- Butterchurn library integration (WebGL Milkdrop)
- Web Audio API AnalyserNode FFT/waveform extraction
- GLSL fragment shaders for audio-reactive effects
- Full-screen immersive music experiences
- Real-time beat detection and audio analysis
- Preset systems and visualization transitions

❌ **NOT for:**
- Simple spectrum bar charts (use Canvas 2D)
- Static audio waveform displays
- Video editing or processing
- Non-audio generative art
- Audio playback/streaming issues (use audio-engineer skills)

## The Golden Era (Summary)

| Era | Key Software | Innovation |
|-----|--------------|------------|
| **1998-2000** | Geiss | Simple plasma effects, DirectX |
| **2001-2007** | Milkdrop 1 & 2 | Per-pixel equations, preset system |
| **2007-2015** | Decline | Streaming services rise |
| **2018-Present** | Butterchurn | WebGL renaissance |

**Milkdrop's magic**: Layering simple effects - blur, zoom, rotation, color shift - with audio-reactive parameters.

→ See `references/butterchurn-guide.md` for full history and integration.

## Core Technologies

### Butterchurn (WebGL Milkdrop)
- 1.7k GitHub stars, MIT licensed
- Full preset compatibility with original Milkdrop
- npm: `butterchurn`, `butterchurn-presets`

```typescript
import butterchurn from 'butterchurn';
const visualizer = butterchurn.createVisualizer(audioContext, canvas, {
  width: window.innerWidth,
  height: window.innerHeight,
  pixelRatio: window.devicePixelRatio || 1,
});
visualizer.connectAudio(audioNode);
visualizer.loadPreset(preset, 2.0);  // 2s blend
```

### Web Audio API FFT
```typescript
const analyser = audioContext.createAnalyser();
analyser.fftSize = 2048;
analyser.smoothingTimeConstant = 0.8;
const frequencyData = new Uint8Array(analyser.frequencyBinCount);
analyser.getByteFrequencyData(frequencyData);
```

**Critical**: FFT bins are linear but hearing is logarithmic! Use logarithmic mapping.

→ See `references/web-audio-fft.md` for frequency band extraction.

### GLSL Shaders
Pass audio data as 1D texture, use uniforms for bass/mid/treble:

```glsl
uniform float u_bass;
float glow = smoothstep(0.5 - u_bass * 0.3, 0.0, dist);
```

→ See `references/glsl-shaders.md` for complete patterns.

## Anti-Patterns to Avoid

### 1. Ignoring AudioContext State
**What it looks like**: Visualization silently fails
**Why it's wrong**: AudioContext starts suspended, needs user interaction
**Fix**: Resume on click: `await audioContext.resume()`

### 2. Linear Frequency Display
**What it looks like**: Bass dominates, treble invisible
**Why it's wrong**: FFT bins are linear; first 100 bins might be 0-2kHz
**Fix**: Use logarithmic bin mapping (code in references)

### 3. No Smoothing
**What it looks like**: Jittery, seizure-inducing visuals
**Why it's wrong**: Raw FFT data is noisy frame-to-frame
**Fix**: `analyserNode.smoothingTimeConstant = 0.7`

### 4. requestAnimationFrame Without Cleanup
**What it looks like**: Memory leaks, multiple render loops
**Fix**: Store animation ID, call `cancelAnimationFrame` on unmount

### 5. Hardcoded Canvas Size
**What it looks like**: Blurry on retina, wrong aspect ratio
**Fix**: Multiply by `devicePixelRatio`, handle resize events

### 6. Blocking Main Thread
**What it looks like**: Choppy audio, dropped frames
**Why it's wrong**: Heavy shader compilation on UI thread
**Fix**: Compile shaders during loading, not during playback

## Preset Recommendations

**Psychedelic/Trippy:**
- `Flexi, martin + geiss - dedicated to the sherwin maxawow`
- `Rovastar - Fractopia`

**Smooth/Chill:**
- `Flexi - predator-prey-spirals`
- `Geiss - Cosmic Strings 2`

**High Energy:**
- `Flexi + Martin - disconnected`
- `shifter - tumbling cubes`

## Integration Checklist

- [ ] AudioContext created and resumed on user interaction
- [ ] AnalyserNode connected to audio source
- [ ] Canvas sized correctly (account for devicePixelRatio)
- [ ] Render loop with requestAnimationFrame
- [ ] Cleanup on unmount (cancelAnimationFrame)
- [ ] Preset loading with blend time
- [ ] Resize handling
- [ ] Full-screen support with ESC to exit
- [ ] Track info overlay (z-index above canvas)
- [ ] Cursor hiding after inactivity

## Performance Tips

1. **Lower texture ratio** for older GPUs: `textureRatio: 0.5`
2. **Reduce fftSize** if not needed: 512 or 1024 vs 2048
3. **Use `will-change: transform`** on canvas
4. **Avoid DOM updates** during render loop
5. **Profile with Chrome DevTools** GPU timeline

## References

→ `references/butterchurn-guide.md` - Complete Butterchurn integration
→ `references/web-audio-fft.md` - FFT extraction and frequency analysis
→ `references/glsl-shaders.md` - Audio-reactive shader patterns

---

**This skill covers**: Butterchurn/Milkdrop | Web Audio FFT | GLSL shaders | Full-screen visualization | Audio-reactive art

© curiositech · MIT · curiositech/some_claude_skills

Similar skills

All skills for Frontend and UI →

From the same set180

The whole set →
frontend-architect frontend-architect — a skill for choosing a frontend framework, deploying to Cloudflare Pages, and building internal tool architectures. Recommends tech stacks, configures shadcn/ui, and bridges design tokens to components. CX Codex +1 191installs launch-readiness-auditor launch-readiness-auditor audits codebases for production readiness before launch. It calculates a health score across eight areas and creates a prioritized two-week sprint plan. CX Codex +1 190installs postgresql-optimization postgresql-optimization helps identify PostgreSQL bottlenecks: interprets EXPLAIN ANALYZE plans, selects indexing strategies, and tunes parameters like shared_buffers and work_mem. CX Codex +1 190installs wedding-immortalist The wedding-immortalist skill outlines a workflow for turning wedding photos and video into 3D scenes, a guest roster, and selected highlights. Use it to plan an interactive wedding archive. CX Codex +1 190installs cloudflare-worker-dev The cloudflare-worker-dev skill guides Cloudflare Workers work for edge APIs, KV caching, request limits, and real-time coordination. CX Codex +1 189installs clip-aware-embeddings clip-aware-embeddings guides AI coding agents to pick CLIP or dedicated computer vision models. It stops agents from misusing CLIP for counting or spatial reasoning. CX Codex +1 188installs code-necromancer The code-necromancer skill maps an inherited or dormant codebase, helps get it running, and lays out a modernization plan. It starts by examining the system before changing it. CX Codex +1 187installs vercel-deployment vercel-deployment — a skill that handles Vercel deploys for Next.js and React apps: env vars, edge functions, build fixes, preview deployments. Not for AWS, GCP or Azure. CX Codex +1 187installs

Project sponsors

Companies that keep this analytics open