docs(skills): document Electron x-skip-launch-check requirement for headless CI

Electron apps segfault (exit 139) in the headless gnome-49 container
because there is no display. Document x-skip-launch-check: true as the
fix pattern in both the skill and goose GOTCHAS.md.

Assisted-by: Claude Sonnet 4.6 via OpenCode

Author: castrojo

flatpaks/goose/GOTCHAS.md

@@ -21,7 +21,17 @@ migrated to the `manifest.yaml` (flatpak-builder) path.
 requires at least one category. This is a documentation-only violation — it does not affect
 build or runtime behaviour in this personal remote.
 
-## chunkah layer count
+## CI launch check: x-skip-launch-check required
+
+Goose is a GUI Electron app. In a headless CI container (no `$DISPLAY`), `zypak-wrapper`
+segfaults with exit 139 — even with `--no-sandbox` — because the Ozone X11 platform fails
+to initialize (`Missing X server or $DISPLAY`).
+
+Set `x-skip-launch-check: true` in `release.yaml` so the launch check step exits 0 with a
+SKIP message instead of trying to run a display-required binary. The install step already
+validates the Flatpak can be installed; the launch check adds no signal here.
+
+
 
 16 layers configured (`chunkah-max-layers: "16"`). At ~200MB the OSTree object store
 heuristics alone may produce ~30 layers. If chunkah warns about exceeding the layer budget,

skills/app-gotchas.md

@@ -41,7 +41,26 @@ Real flatpak-tracker runtime-update issue bodies use:
 
 Applies to: `scripts/sync-runtime-issues.py` and any task spec describing issue body format.
 
-## bundle-repack apps: no metainfo injection
+## Electron GUI apps: x-skip-launch-check required
+
+Electron apps (e.g. goose, lmstudio) run as root in the CI container and require a display
+to initialize (X11/Wayland). In the headless gnome-49 container:
+
+- `zypak-wrapper` segfaults with exit 139 even with `--no-sandbox`
+- The Ozone X11 platform fails: `Missing X server or $DISPLAY`
+
+**Fix:** set `x-skip-launch-check: true` in `release.yaml` (or `manifest.yaml`). The
+launch check step reads this field and exits 0 with a SKIP message. The install step
+already validates that the Flatpak installs correctly.
+
+```yaml
+# In release.yaml or manifest.yaml:
+x-skip-launch-check: true
+```
+
+Applies to: **goose**, **lmstudio** (any Electron GUI app).
+
+
 
 The `release.yaml` pipeline downloads a pre-built upstream `.flatpak` and repackages it as
 OCI. There is no mechanism to inject source-side files (e.g. metainfo XML) into the bundle.