ov-selkies/skills/xdg-portal/SKILL.md
# xdg-portal - XDG Desktop Portal Infrastructure ## Overview Provides XDG Desktop Portal support for Sway containers. Installs the portal daemon, the wlroots-specific backend (`xdg-desktop-portal-wlr`), and the GTK fallback backend. Enables screen sharing, screenshots via portal API, and file dialogs for applications running inside the container. ## Layer Definition ```yaml requires: - dbus - sway - pipewire env: XDG_CURRENT_DESKTOP: "sway" rpm: packages: - xdg-desktop-portal
npx skillsauth add overthinkos/overthink-plugins ov-selkies/skills/xdg-portalInstall 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.
Provides XDG Desktop Portal support for Sway containers. Installs the portal daemon, the wlroots-specific backend (xdg-desktop-portal-wlr), and the GTK fallback backend. Enables screen sharing, screenshots via portal API, and file dialogs for applications running inside the container.
requires:
- dbus
- sway
- pipewire
env:
XDG_CURRENT_DESKTOP: "sway"
rpm:
packages:
- xdg-desktop-portal
- xdg-desktop-portal-wlr
- xdg-desktop-portal-gtk
- slurp
| Property | Value |
|----------|-------|
| Depends | dbus, sway, pipewire |
| Packages | xdg-desktop-portal, xdg-desktop-portal-wlr, xdg-desktop-portal-gtk, slurp |
| Env | XDG_CURRENT_DESKTOP=sway |
| Service | None (D-Bus activation on demand) |
| Ports | None |
~/.config/sway/config.d/portal.conf which runs dbus-update-activation-environment to export WAYLAND_DISPLAY, XDG_RUNTIME_DIR, XDG_CURRENT_DESKTOP, and SWAYSOCK to the D-Bus activation environment. Without this, portal daemons can't find the Wayland display.~/.config/xdg-desktop-portal-wlr/config with chooser_type=none for headless automation (no user dialog for screen sharing).| Interface | Backend | Status | |-----------|---------|--------| | Screenshot | xdg-desktop-portal-wlr | Supported | | ScreenCast (PipeWire) | xdg-desktop-portal-wlr | Supported | | RemoteDesktop | — | NOT supported on wlroots | | File dialogs | xdg-desktop-portal-gtk | Supported (fallback) | | Settings | xdg-desktop-portal-gtk | Supported (fallback) |
sway-desktop metalayer (default for all desktop images)/ov-selkies:sway-browser-vnc (via sway-desktop metalayer)/ov-openclaw:openclaw-sway-browser (via sway-desktop metalayer)/ov-openclaw:openclaw-ollama-sway-browser (via sway-desktop metalayer)/ov-selkies:sway-desktop — Desktop metalayer that includes this layer/ov-foundation:dbus — D-Bus session bus (required dependency)/ov-selkies:pipewire — PipeWire (required for ScreenCast)/ov-selkies:sway — Sway compositor (required)/ov-build:layer — layer authoring reference (layer.yml schema, task verbs, service declarations)/ov-build:eval — declarative testing (eval: block, ov eval image, ov eval live)development
Claude Code multi-agent support in Overthink — sub-agents, dynamic workflows, and agent teams, and how each drives the existing `ov eval` disposable beds to test and verify. MUST be invoked before authoring or invoking an ov sub-agent / dynamic workflow / agent team, wiring agent-lifecycle hooks, or asking "which primitive should drive the R10 beds?".
tools
Mounts a virtiofs share tagged `workspace` at /workspace inside a VM guest via a systemd .mount unit. Use when a kind:vm entity shares a host directory into the guest and you need it auto-mounted (and re-mounted at every boot).
development
MUST be invoked before any work involving: the `kind: android` schema kind, a `target: android` deploy, the `apk:` layer package format (installing Android apps declaratively), AndroidDeployTarget, an in-pod emulator OR a remote/physical adb-endpoint device, or nested `pod → android` deployment. The first-class Android device + app surface that sits above `ov eval adb`/`appium`.
tools
Use when committing, branching, pushing, merging, tagging, creating PRs, or approving/merging PRs with gh — the feat/-branch, R10-gated, never-force-push landing workflow across the main repo + the plugins submodule + image/<distro> submodules. Covers sync-to-upstream, branch/worktree pruning, the fork+PR path for contributors without write access, and cross-repo @github landing order.