Agent skill · software engineering · sickn33
fedora-hyprland-installer
Install, configure, verify, repair, update, and uninstall Hyprland on Fedora Linux with GPU-aware detection (NVIDIA/AMD/Intel).
Why this skill is useful
Adds multiple executable scripts for installing and configuring Hyprland on Fedora, including GPU detection and safety checks that aren't in public docs.
What it needs
Requires bash installed locally. About 3k tokens when loaded. Last updated 2026-08-07. 44,571 stars on the source repository.
What this skill does
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 SKILLDIR 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 "$SKILLDIR/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 backup in ~/.local/state/fedora-hyprland-installer/backups/ before writing or altering configurations in ~/.config/hypr/, ~/.config/waybar/, etc. 5. GPU Awareness: Check whether the system uses NVIDIA, AMD, Intel, or Hybrid graphics before configuring environment variables or graphics drivers. Never use arbitrary .run installers for NVIDIA; rely on Fedora/RPM Fusion repositories. 6. Privileged Operations: Sudo commands must be clearly identified and communicated to the user. Do not hardcode passwords. 7. Idempotency: Running actions multiple times must be safe and avoid duplicate config lines. 8. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sickn33/fedora-hyprland-installer--f303ee