diff --git a/SKILL.md b/SKILL.md
index 3d355fb..db09525 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -34,4 +34,8 @@ user-invocable: true
     summary="Mealie REST API: add/edit recipes, ingredient parser (food/unit id resolution + locale seeding), tag/category and instruction gotchas, misleading-error decoder"
     categories=["food", "services"]
     keywords=["Mealie", "meals.vino.network", "recipe", "recipes", "meal", "meal planning", "ingredient parser", "PATCH recipe", "MEALIE_TOKEN", "household Family"] />
+  <reference file="reference/kiosk.md"
+    summary="Wall-display kiosks on host101/host102 (Chromium full-screen): which screen shows what, and how to change the displayed webpage (KIOSK_URL via GitOps or kubectl)"
+    categories=["services", "display"]
+    keywords=["kiosk", "screen", "display", "wall panel", "TV", "monitor", "webpage", "Chromium", "KIOSK_URL", "host101", "host102", "signage", "dashboard"] />
 </references>
diff --git a/reference/kiosk.md b/reference/kiosk.md
new file mode 100644
index 0000000..182bf43
--- /dev/null
+++ b/reference/kiosk.md
@@ -0,0 +1,21 @@
+# Kiosks (wall displays)
+
+<what>Full-screen web kiosks on the two Nest compute nodes, each driving its attached display (DP/HDMI) via Chromium. Run as Kubernetes pods on the msp001 cluster (the Nest site). Infra/build/troubleshooting: see fritzlab skill `msp001.md` <kiosk> + the `fritzlab/kiosk` repo.</what>
+
+<screens>
+| Node | Pod (ns `kiosk`) | Output | Showing |
+|---|---|---|---|
+| host101 | `kiosk-host101` | card0-DP-1 (4K) | google.com (validation default) |
+| host102 | `kiosk-host102` | card0-DP-1 (4K) | netflix.com (validation default) |
+Each node drives one screen; multi-screen would need host100's GT 730 (see KIOSK-DESIGN.md).
+</screens>
+
+<change-page>
+The displayed URL is the `KIOSK_URL` env per pod.
+**Permanent (GitOps, preferred):** edit `KIOSK_URL` in `fritzlab/apps/msp001/kiosk/kiosk/manifests/deployments.yaml` (block `kiosk-host101` or `kiosk-host102`), commit + push to `apps` main → msp001 ArgoCD syncs (~3 min poll) → pod recreates on the new page.
+**Temporary (now, reverts on next ArgoCD sync):** `kubectl --context msp001 set env deploy/kiosk-host101 -n kiosk KIOSK_URL=https://example.com` — pod recreates immediately; ArgoCD selfHeal puts it back to the git value, so use git for anything lasting.
+</change-page>
+
+<verify>`kubectl --context msp001 get pods -n kiosk` (want 1/1 Running). On-screen page check needs a screenshot via Chromium CDP (localhost-only) — see fritzlab `msp001.md` <kiosk>. A blank screen usually means `getty@tty1` re-took DRM master (re-mask on the node) or the page is down (Chromium shows last-good frame).</verify>
+
+<other-options>Want a dashboard, photo slideshow, or Home Assistant wall panel instead of a website — just point `KIOSK_URL` at it (e.g. `https://home.vino.network`). [[home-assistant]] for HA URLs.</other-options>