1 files changed, 15 insertions, 0 deletions

diff --git a/CONTEXT.md b/CONTEXT.md
index 741050d..f2b091a 100644
--- a/CONTEXT.md
+++ b/CONTEXT.md
@@ -358,6 +358,21 @@ vocabulary / decisions.
 - End is clamped above Start. Re-applied on level change via
   `fog_invalidate()`. Saved as `[fog] active/bind/r/g/b/start/end/skybox/disable`.
 
+### Skybox changer
+
+- `sv_skyname <name>` through `ClientCmd`, the same mechanism the stock
+  `skybox_swapper` entity uses. Choice list is the HL2 skybox set from the
+  game's VPK (no episode-only skies, so a selected sky always exists).
+- Before the first override of a map, the map's own sky is captured by
+  scanning loaded materials in the `SkyBox textures` group and parsing
+  `skybox/<name>(_hdr|_ldr)?(rt|bk|lf|ft|up|dn)`. Disabling the feature (or
+  choosing "Map default") restores that name; a level change also restores it
+  naturally, so `skybox_invalidate()` just drops the captured state.
+- Changing the sky invalidates the world tint so the freshly loaded sky
+  materials get the sky colour.
+- Saved as `[skybox] active/bind/choice`. The GUI uses a `CK_CHOICE`
+  control (value box with `<`/`>` hit zones).
+
 ## Logging
 
 - `/tmp/hl2hake.log` is opened once at startup with `"w"` (so it only contains