Install and Manage Hyprland Desktop on Fedora Linux

This skill provides an automated, safety-first workflow for managing Hyprland (a Wayland compositor) on Fedora Linux, covering four workflows: install, repair, update, and uninstall. Before running any bundled script it resolves SKILL_DIR to the directory actually containing SKILL.md rather than assuming the working directory, and stops to ask the user if it can't be resolved from runtime context.

Use it when installing or updating a Fedora-packaged Hyprland desktop stack, verifying a Hyprland session (portals, PipeWire, WirePlumber), or diagnosing the specific repair cases the workflow documents. Eight core safety rules govern every action: Fedora-only tooling (dnf, systemctl, loginctl - never apt, pacman, or yay); never blindly execute without inspecting the system first; never uninstall an existing desktop environment (Hyprland is added as an additional display-manager session choice); a mandatory timestamped backup before touching ~/.config/hypr/ or ~/.config/waybar/; GPU-aware handling that checks NVIDIA/AMD/Intel/Hybrid before touching drivers and never uses arbitrary NVIDIA .run installers; clearly identified, non-hardcoded sudo commands; idempotent actions safe to re-run; and explicit consent - showing the exact package/service change and running mutating scripts (like repair.sh --apply) only after user approval.

bash "$SKILL_DIR/scripts/detect-system.sh"
bash "$SKILL_DIR/scripts/detect-gpu.sh"
bash "$SKILL_DIR/scripts/install.sh" --dry-run

Install: detect system and GPU, run preflight.sh (Fedora release, network, package manager, sudo access), back up existing configs, show the package plan via install.sh --dry-run, then on approval install Hyprland plus Wayland portal packages (xdg-desktop-portal-hyprland, xdg-desktop-portal-gtk), PipeWire/WirePlumber, terminal, launcher, status bar, and auth agent; write an initial ~/.config/hypr/hyprland.conf tailored to the detected terminal/launcher/GPU; verify binaries, portal services, and the hyprland.desktop login entry; then report installed packages, backup paths, and login instructions. Repair: inspect logs (journalctl -xe, the user's xdg-desktop-portal unit), run repair.sh to report missing config/portal packages/inactive services, get approval, then repair.sh --apply to fix only what it detected - other faults need manual investigation. Update and uninstall follow the same backup-then-dry-run-then-approve-then-execute pattern, with uninstall explicitly preserving GNOME/KDE and user backups.

Eight reference manuals ship alongside the workflow scripts, covering Fedora specifics, Hyprland config, NVIDIA/AMD/Intel Mesa stacks, Wayland/environment variables, portals/PipeWire, and a troubleshooting matrix. It explicitly does not enable RPM Fusion or install GPU drivers itself, and its generated config is a minimal starting point that is not merged into an existing hyprland.conf.

Fedora users setting up, diagnosing, updating, or removing a Hyprland desktop who want a safety-railed workflow - backups, dry-runs, explicit consent gates - instead of running installer scripts blind, while keeping their existing GNOME or KDE session intact as a fallback.