postfx-router

What this skill does

# Post-Processing Router

Routes to 3 specialized skills based on post-processing requirements.

## Routing Protocol

1. **Classify** — Identify effect type from user request
2. **Match** — Apply signal matching rules below
3. **Combine** — Most production scenes need 2-3 skills together
4. **Load** — Read matched SKILL.md files before implementation

## Quick Route

### Tier 1: Core (Start Here)
| Need | Skill | Signals |
|------|-------|---------|
| Pipeline setup, effect ordering | `postfx-composer` | EffectComposer, setup, pipeline, render target, custom pass, multi-pass |
| Glow, luminance effects | `postfx-bloom` | bloom, glow, neon, emissive, luminance, UnrealBloom, selective bloom |
| Cinematic polish, color | `postfx-effects` | vignette, chromatic, DOF, grain, color grade, LUT, aberration |

## Signal Matching

### Primary Signals

**postfx-composer** (always start here for new projects):
- "set up post-processing"
- "configure effect pipeline"
- "create custom effect/pass"
- "render targets", "effect ordering"

**postfx-bloom**:
- "bloom", "glow", "luminance", "neon", "emissive"
- "selective bloom", "object glow", "UnrealBloomPass"

**postfx-effects**:
- "chromatic aberration", "vignette", "depth of field", "DOF"
- "film grain", "noise", "color grading", "LUT", "tone mapping"
- "scanlines", "CRT", "god rays"

### Confidence Scoring

- **High (3+ signals)** — Route directly to matched skill
- **Medium (1-2 signals)** — Route with composer as foundation
- **Low (0 signals)** — Start with `postfx-composer` for setup

## Common Combinations

### Basic Post-Processing Setup (2 skills)
```
postfx-composer → Pipeline architecture, effect ordering
postfx-bloom    → Basic glow effects
```

### Cinematic Scene (3 skills)
```
postfx-composer → Pipeline setup, tone mapping
postfx-bloom    → Subtle glow on lights
postfx-effects  → Vignette, grain, color grading
```

### Neon/Cyberpunk Aesthetic (2 skills)
```
postfx-bloom    → High-intensity selective bloom
postfx-effects  → Chromatic aberration, vignette
```

### Custom Effect Development (1-2 skills)
```
postfx-composer → Custom Effect class, shader writing
postfx-effects  → Reference existing effects
```

## Decision Table

| Effect Type | Complexity | Primary Skill | Supporting Skill |
|-------------|------------|---------------|------------------|
| Glow/bloom only | Simple | bloom | composer |
| Cinematic look | Medium | effects | composer + bloom |
| Custom effect | Complex | composer | - |
| Selective bloom | Medium | bloom | composer |
| Color grading | Simple | effects | composer |
| Full production | Complex | All three | - |

## Effect Categories

### Lighting Effects → postfx-bloom
- Bloom/glow, selective bloom, emissive enhancement, HDR luminance

### Camera Effects → postfx-effects
- Chromatic aberration, vignette, depth of field, lens distortion

### Color Effects → postfx-effects
- Tone mapping, color grading, LUT, hue/saturation

### Texture Effects → postfx-effects
- Film grain, noise, scanlines, CRT

### Architecture → postfx-composer
- EffectComposer setup, effect ordering, custom effects, render targets

## Integration with Other Domains

### With R3F (r3f-*)
```
r3f-fundamentals → Scene setup
postfx-composer  → Effect pipeline
postfx-bloom     → Object glow
```

### With Shaders (shaders-*)
```
shaders-glsl     → Custom effect shader code
postfx-composer  → Wrap in Effect class
```

### With Particles (particles-*)
```
particles-systems → Particle emitters
postfx-bloom      → Particle glow
postfx-effects    → Atmosphere
```

### With Audio (audio-*)
```
audio-analysis    → Frequency data
postfx-bloom      → Audio-reactive bloom
postfx-effects    → Audio-reactive aberration
```

## Quick Reference

| Effect | Skill |
|--------|-------|
| Bloom | `postfx-bloom` |
| Selective Bloom | `postfx-bloom` |
| Vignette | `postfx-effects` |
| Chromatic Aberration | `postfx-effects` |
| Depth of Field | `postfx-effects` |
| Film Grain/Noise | `postfx-effects` |
| Color Grading | `postfx-effects` |
| LUT | `postfx-effects` |
| Tone Mapping | `postfx-effects` |
| Custom Effects | `postfx-composer` |
| Render Targets | `postfx-composer` |

## Temporal Collapse Stack

```
postfx-composer → HDR pipeline, tone mapping, adaptive quality
postfx-bloom    → Cosmic glow on digits, particles, UI
postfx-effects  → Vignette (void edge), subtle chromatic, grain
```

## Fallback Behavior

- **No framework context** → Assume @react-three/postprocessing
- **Unclear effect type** → Start with `postfx-composer` + `postfx-bloom`
- **Performance concerns** → Prioritize `postfx-composer` optimization patterns