postfx-router_skill

Overview

This skill is a router for Three.js post-processing effects that directs requests to the right specialized skill for bloom, general effects, or composer/pipeline setup. It simplifies decision-making when implementing screen-space effects like bloom, chromatic aberration, vignette, DOF, and color grading. Use it to map high-level intent to focused implementations and common skill combinations.

How this skill works

It classifies incoming requests by detecting key signals (e.g., "bloom", "vignette", "effect composer") and matches them to one of three target skills: composer, bloom, or effects. It applies simple confidence scoring (high/medium/low) based on number of signals and suggests combining skills when scenes need multiple layers. It also provides fallback guidance and common combinations for production-ready pipelines.

When to use it

• Starting a new post-processing pipeline or ordering effects
• Adding glow/luminance or selective bloom to a scene
• Applying cinematic touches: vignette, grain, color grading, DOF
• Creating custom passes or writing an Effect class/shader
• Optimizing or structuring multiple screen-space effects together

Best practices

• Always start new projects with the composer route to define ordering and render targets
• Combine 2–3 skills for production scenes (composer + bloom + effects) rather than many isolated passes
• Use signal counts: 3+ signals → direct route; 1–2 signals → route via composer; 0 signals → default to composer
• Prefer selective bloom for object-specific glow to limit performance cost
• When performance is a concern, prioritize composer optimizations (render target formats, adaptive quality) before adding expensive effects

Example use cases

• Basic pipeline: use postfx-composer for EffectComposer setup, then postfx-bloom for soft glow
• Cinematic scene: composer for tone mapping, bloom for emissive highlights, effects for vignette and film grain
• Neon/cyberpunk: postfx-bloom for high-intensity selective bloom plus postfx-effects for chromatic aberration
• Custom effect development: composer to wrap a custom Effect class and shader; consult effects skill for reference implementations
• Audio-reactive visuals: feed frequency data to bloom and aberration for synchronized glow and color shifts