$npx -y skills add scottstts/Threejs-Awesome-Graphics-Agent-Skills --skill threejs-volumetric-cloudsImplement volumetric cloud systems in Three.js. Use for weather-driven density, bounded raymarching, shape/detail erosion, vertical profiles, lighting cones, silver lining, temporal reconstruction, cloud shadows, multiple layers, and scalable quality modes.
| 1 | # Volumetric Clouds |
| 2 | |
| 3 | Cloud quality comes from density organization, lighting, and temporal stability—not from increasing march steps over unstructured noise. |
| 4 | |
| 5 | ## System order |
| 6 | |
| 7 | 1. Define the cloud volume and layer bounds. |
| 8 | 2. Generate or source weather, base-shape, detail, and turbulence fields. |
| 9 | 3. Build a density function with vertical and weather profiles. |
| 10 | 4. Raymarch only the bounded occupied segment. |
| 11 | 5. Integrate transmittance and lighting front-to-back. |
| 12 | 6. Reconstruct low-resolution output temporally. |
| 13 | 7. Project a separate low-cost cloud-shadow solution. |
| 14 | |
| 15 | Read [references/weather-volume-and-reconstruction.md](references/weather-volume-and-reconstruction.md) before implementing or auditing the cloud system. |
| 16 | |
| 17 | Read the [weather volume cloud entry](examples/weather-volume-clouds/cloud-effect.js) |
| 18 | and its `source/` modules for weather-layer ownership, spherical shell bounds, |
| 19 | authored shape/detail sampling, cloud shadow maps, temporal upscale, |
| 20 | atmospheric composition, and package-owned diagnostics. |
| 21 | |
| 22 | ## Required controls |
| 23 | |
| 24 | - coverage, cloud type, precipitation, and anvil bias; |
| 25 | - base/top altitude and vertical density profile; |
| 26 | - shape/detail scales and erosion; |
| 27 | - wind for each field; |
| 28 | - primary step count, light step count, and empty-space policy; |
| 29 | - history weight and disocclusion threshold; |
| 30 | - cloud-shadow extent, resolution, and update rate. |
| 31 | |
| 32 | ## Failure conditions |
| 33 | |
| 34 | - density is only `fbm(position)`; |
| 35 | - the raymarch traverses the full camera range; |
| 36 | - detail noise adds density instead of eroding shaped masses; |
| 37 | - temporal history is accepted across disocclusion; |
| 38 | - shadows use the full beauty raymarch; |
| 39 | - every cloud layer shares the same wind and density profile. |
| 40 | |
| 41 | ## Routing boundary |
| 42 | |
| 43 | Use `$threejs-atmosphere-aerial-perspective` for molecular/aerosol scattering |
| 44 | without weather density. This skill owns weather-shaped cloud volumes, |
| 45 | reconstruction, cloud lighting, and cloud shadows. |