使用方法
- 复制安装命令,在自己的智能体环境安装前先检查源码包。
- 从原始文档核对所需工具、凭据和支持的宿主。
- 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/scottstts/threejs-awesome-graphics-agent-skills --skill threejs-water-optics开始前需了解
- 安装不包含模型订阅、API 额度或访问文件的权限。
- 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。
Water Optics
Treat water as geometry motion, surface orientation, and a participating optical layer. A blue transparent material is not a water system.
This skill contains exemplary examples and assets beyond descriptive guidance, they're worth studying, referencing, or even copying. Use them sufficiently when relevant and do NOT blindly skip them.
For large seas with spectral cascades, coastal breakers or camera-medium crossings, use $threejs-spectral-ocean. This skill also owns the air-side photoreal-water shallow-water compositor.
Analytic surface build order
- Define wave bands and evaluate displacement.
- Derive the normal analytically from the same waves.
- Choose displaced geometry or explicitly normal-only water.
- Establish scene-color ownership for heuristic refraction.
- Declare whether absorption uses true depth or a fallback path-length estimate.
- Blend analytic reflection/refraction through side-aware Fresnel.
- Derive foam and glints from the shared wave response.
- Filter unresolved normal bands from derivatives.
Read references/water-surface-system.md for the authored displacement/normal contract, optical hierarchy, side-aware refraction, absorption fallback, and diagnostic channels.
Read the interactive pool volume implementation for bounded RGBA height/velocity/normal simulation, local drops, moving-sphere displacement suitable for draggable objects, differential-area caustics, and in-shader pool/water/sphere ray tracing against the pool bounds and sphere.
Read the photoreal water implementation for gravity-capillary FFT waves, touch ripples, RGB caustics, refracted pebble-bed radiance and aperture diffraction glare. Read references/photoreal-water.md for its pass, coordinate, filtering, integration and diagnostic contracts.
Failure conditions
- normal texture motion does not agree with displaced crests;
- heuristic refraction can sample foreground objects but the limitation is undisclosed;
- fallback path length is presented as reconstructed scene thickness;
- bounded pool caustics are a decorative projection detached from simulated
height normals;
- micro-waves alias into sparkling noise;
- foam is a scrolling texture unrelated to the shared crest metric;
- Fresnel is replaced by constant opacity;
- reflection, refraction, and transparency are all added without energy control.
Routing boundary
Use $threejs-spectral-ocean for large spectral cascades, Jacobian breaking, persistent ocean foam and camera-medium crossings. The photoreal-water example uses an FFT patch for shallow-water optics viewed from air; it does not implement underwater viewing. The analytic screen-refraction recipe also assumes an air-side camera above a bounded volume. Use $threejs-precipitation-surfaces for rain-driven puddle wetness, ripple masks, and weather-coupled splashes on ground surfaces. This skill owns authored analytic waves, bounded heightfield simulation, ray-traced pool-volume optics, and bounded-water optics.


