fedora-hyprland-installer

Fedora Hyprland Installer Skill

This skill provides an automated, safety-first workflow for managing Hyprland on Fedora Linux.

Resolve the Skill Directory

Before running a bundled script, resolve SKILL_DIR to the directory that contains this SKILL.md. Do not assume the user's current working directory or guess a global installation path. If the agent cannot resolve the installed skill directory from its runtime context, stop and ask the user to provide it. Invoke bundled shell files explicitly with bash and a quoted path, for example bash "$SKILL_DIR/scripts/detect-system.sh".

When to Use

• Use when installing or updating a Fedora-packaged Hyprland desktop stack.
• Use when verifying a Hyprland session, portals, PipeWire, or WirePlumber on Fedora.
• Use when diagnosing the limited repair cases documented below or removing the Hyprland-specific packages installed by this workflow.

Core Directives & Safety Rules

1. Fedora-First: Always use Fedora tools (dnf, systemctl, loginctl). Never use apt, pacman, or yay.
2. Never Blindly Execute: Inspect the system prior to any installation or modification.
3. Preserve Existing Desktop: Do not uninstall GNOME, KDE, or any existing desktop environment. Hyprland should be added as a session choice in the display manager (GDM/SDDM/LightDM).
4. Mandatory Backup: Always create a timestamped