@genex-ai/cli-demo 0.1.0

package/templates/skills/genex-threejs-water-optics/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: genex-threejs-water-optics
+description: Build analytic water surfaces for Genex Three.js games. Use for rivers, pools, lakes, shoreline water, shared wave displacement, normals, Fresnel, refraction, absorption, crest foam, underwater color, and cheaper water than a full spectral ocean.
+---
+
+# Genex Three.js Water Optics
+
+Use analytic water when the game needs readable local water with clear
+interaction, refraction, and shading without a full ocean simulation.
+
+Read [references/water-optics.md](references/water-optics.md) for wave,
+normal, refraction, and fallback patterns.
+
+## Build order
+
+1. Define water role: pool, river, lake, shoreline, hazard, boundary, or
+   traversal affordance.
+2. Build shared wave displacement and normals from named wave bands.
+3. Add Fresnel reflection, absorption, depth color, and controlled refraction.
+4. Derive crest foam and shoreline foam from wave height, slope, or masks.
+5. Add interaction ripples only after the base water reads.
+6. Expose debug views for displacement, normals, depth, refraction, and foam.
+
+## Rules
+
+- Use the same wave state for geometry, normals, and foam.
+- Keep refraction optional; provide a readable fallback.
+- Avoid screen-space refraction artifacts at silhouettes and edges.
+- Bound normal intensity so water does not shimmer in motion.
+- Keep gameplay collision and visual displacement expectations aligned.

package/templates/skills/genex-threejs-water-optics/references/water-optics.md

@@ -0,0 +1,29 @@
+# Water Optics
+
+Use this reference for local water surfaces in Genex games.
+
+## Wave bands
+
+- Primary waves define visible surface movement.
+- Secondary waves add directional complexity.
+- Micro normals add sparkle but must fade with distance.
+- Interaction ripples should be event-driven and decay over time.
+
+## Refraction
+
+- Sample the scene color only when the render pipeline supports it.
+- Clamp offsets at silhouettes.
+- Provide a non-refraction fallback using color absorption and reflection.
+- Keep edge artifacts visible in diagnostics.
+
+## Absorption and depth
+
+- Use depth or an approximate path length to tint deeper water.
+- Keep shallow water readable around gameplay-relevant surfaces.
+- Expose depth and absorption debug views.
+
+## Foam
+
+- Crest foam follows wave slope or height thresholds.
+- Shoreline foam follows terrain or water-edge masks.
+- Impact foam follows gameplay events and decays deterministically.