selkies/skills/selkies-kde/SKILL.md
The KDE Plasma flavor of the Selkies streaming desktop (cpu/default GPU build) — a browser-accessible, headless-pod Wayland desktop running startplasma-wayland nested in pixelflux. MUST be invoked before building, deploying, or troubleshooting the selkies-kde box.
npx skillsauth add overthinkos/overthink-plugins selkies-kdeInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
The full KDE Plasma flavor of the selkies streaming desktop — a
browser-accessible Wayland desktop streamed via Selkies/pixelflux WebSocket at
https://localhost:3000 (HTTPS, self-signed Traefik cert). It is the symmetric
sibling of the labwc flavor (/charly-selkies:selkies-labwc); both compose the shared
/charly-selkies:selkies-core spine and differ ONLY in the nested compositor (KDE
Plasma here via /charly-selkies:kde-selkies, labwc there). Always a headless pod
— de-SDDM startplasma-wayland nested in pixelflux, with no logind seat and no
SDDM (see /charly-selkies:selkies-kde-desktop for that load-bearing design). The
pixelflux encoder is auto-selected per GPU at runtime (VAAPI on an AMD/Intel
render node, software x264 otherwise; the selkies-kde-nvidia sibling adds NVENC).
Owned by the overthinkos/cachyos submodule (box/cachyos).
selkies-kde:
base: cachyos # plain CachyOS base (x86_64_v3 Arch derivative)
build: [pac, aur] # aur: chrome (google-chrome) + wl-tools (wlrctl)
candy:
- agent-forwarding
- selkies-kde-desktop # the KDE metalayer (selkies-core + kde-selkies → kde-shell)
- dbus
- charly
port: ["3000:3000", "9222:9222", "9224:9224", "2222:2222"]
platform: [linux/amd64]
| Port | Service | |------|---------| | 3000 | Selkies web UI (Traefik HTTPS → static files + WebSocket proxy) | | 9222 | Chrome DevTools Protocol (CDP) | | 9224 | Chrome DevTools MCP (Streamable HTTP) | | 2222 | sshd |
selkies candy
ships libva-mesa-driver); DRINODE auto-detected by charly config./charly-selkies:selkies-kde-nvidia (the CachyOS
GPU build with the real NVENC-compiled pixelflux).charly -C box/cachyos box build selkies-kde
charly config selkies-kde
charly start selkies-kde
# Access: https://localhost:3000 (accept the self-signed cert)
charly check live selkies-kde --filter wl # run the candy's wl: screenshot step
charly check box selkies-kde — build-scope (binaries: plasmashell, kwin_wayland, chrome, selkies).charly check run check-selkies-kde-pod — the disposable R10 bed: compositor renders
(plasmashell + kwin_wayland present, wayland-0 up), live :3000 stream
(traefik HTTPS + capture STATUS-socket frames>0), kde-selkies-stable ≥20s uptime./charly-selkies:selkies-kde-desktop — the KDE metalayer + the de-SDDM headless-Plasma design (the load-bearing detail)./charly-selkies:kde-selkies, /charly-selkies:kde-shell — the KDE compositor primitive + the SDDM-free Plasma package leaf./charly-selkies:selkies-labwc — the labwc sibling flavor (same streaming core; the canonical home of the shared SPA-interaction / CDP / wl-automation docs)./charly-selkies:selkies-kde-nvidia — the GPU build of this flavor (real NVENC)./charly-selkies:selkies — the pixelflux streaming transport./charly-distros:cachyos — the CachyOS base + submodule./charly-image:image — image family umbrella (candy: image entries with base:/from:, build/validate/inspect/list)./charly-build:build — the embedded build vocabulary in charly/charly.yml (distros, builders, init-systems).tools
Use when authoring or modifying a charly PLUGIN — a candy with a `plugin:` block that contributes Providers (verbs/kinds/deploy-targets/steps/builders/commands), its own CUE schema, builtin (compiled-in) or external (out-of-tree git repo). Covers the unified Provider model, the per-plugin CUE-schema contract (single source → Go params for dev + schema-over-Describe RPC for runtime), the SDK, and the loader.
tools
The CUE data-validation / configuration CLI (cue), pinned to v0.16.1. Use when working with the cue candy, installing the cue binary into a box or onto a target:local dev host, or running the offline schema-vendoring pipeline that feeds charly's egress validation.
tools
CUE EGRESS validation — validating (and, where it adds value, generating) the config files charly WRITES to a system BEFORE the bytes hit disk. MUST be invoked before working on charly/egress.go, the vendored schemas under candy/plugin-egress/egress-schemas/vendor/, the ValidateEgress / registerVendoredEgressKind path, the offline `task cue:vendor` pipeline, or adding an egress schema for any written artifact (cloud-init, k8s manifests, traefik routes, runtime config, install ledger, systemd/quadlet units, ssh_config, libvirt XML).
tools
Kubernetes cluster-probe declarative check verb — the `kube:` check verb (nodes, pods, ingress, storage class, addon health, apply/delete, and arbitrary resource GETs) served out-of-process by the candy/plugin-kube plugin (vendored client-go; no external kubectl required).