Fedora Hyprland Installer Skill
This skill provides an automated, safety-first workflow for managing Hyprland on Fedora Linux.
Script Path Resolution Directive
When agy is launched from a user's working directory, bundled scripts do NOT reside in ./scripts/.
The agent MUST first locate the base directory of the fedora-hyprland-installer skill (e.g., <workspace>/.agents/skills/fedora-hyprland-installer, ~/.gemini/antigravity-cli/skills/fedora-hyprland-installer, or the skill repository root) and define it as SKILL_DIR.
All bundled scripts MUST be executed using their full path relative to SKILL_DIR: <SKILL_DIR>/scripts/<script-name>.sh.
Core Directives & Safety Rules
- Fedora-First: Always use Fedora tools (
dnf, systemctl, loginctl). Never use apt, pacman, or yay.
- Never Blindly Execute: Inspect the system prior to any installation or modification.
- 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).
- 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.
- 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.
- Privileged Operations: Sudo commands must be clearly identified and communicated to the user. Do not hardcode passwords.
- Idempotency: Running actions multiple times must be safe and avoid duplicate config lines.
Workflow Guide
1. Installation Workflow
When the user asks to "Install Hyprland" or "Setup Hyprland on Fedora":
- Execute
<SKILL_DIR>/scripts/detect-system.sh and <SKILL_DIR>/scripts/detect-gpu.sh.
- Execute
<SKILL_DIR>/scripts/preflight.sh to verify Fedora release, network, package manager, and sudo access.
- Execute
<SKILL_DIR>/scripts/backup.sh to preserve any pre-existing configurations.
- Execute
<SKILL_DIR>/scripts/install.sh to install Hyprland, Wayland portal packages (xdg-desktop-portal-hyprland, xdg-desktop-portal-gtk), PipeWire/WirePlumber, terminal, launcher, status bar, and authentication agent.
- Execute
<SKILL_DIR>/scripts/configure.sh to write a clean, functional initial Hyprland config (~/.config/hypr/hyprland.conf) tailored to detected terminal/launcher and GPU environment variables.
- Execute
<SKILL_DIR>/scripts/verify.sh to ensure binaries, portal services, PipeWire, and login desktop entries (/usr/share/wayland-sessions/hyprland.desktop) exist and validate.
- Present a summary report detailing installed packages, backup paths, and login instructions.
2. Repair Workflow
When the user asks to "Fix Hyprland", "Hyprland won't start", "No audio", "Screen sharing broken":
- Run
<SKILL_DIR>/scripts/detect-system.sh and inspect system logs (journalctl -xe, journalctl --user -u xdg-desktop-portal).
- Execute
<SKILL_DIR>/scripts/repair.sh to identify missing portals, PipeWire states, broken symlinks, or GPU driver mismatches.
- Apply minimal, targeted repairs without re-installing unchanged packages.
- Execute
<SKILL_DIR>/scripts/verify.sh.
3. Update Workflow
When the user asks to "Update Hyprland":
- Run
<SKILL_DIR>/scripts/backup.sh.
- Refresh Fedora package metadata (
sudo dnf check-update hyprland).
- Update Hyprland and related Wayland packages via
<SKILL_DIR>/scripts/install.sh --update.
- Validate configuration syntax and verify system integrity via
<SKILL_DIR>/scripts/verify.sh.
4. Uninstall Workflow
When the user asks to "Uninstall Hyprland":
- Explain to the user which packages will be removed.
- Run
<SKILL_DIR>/scripts/backup.sh.
- Execute
<SKILL_DIR>/scripts/uninstall.sh to cleanly remove Hyprland packages while preserving base desktop environments (GNOME/KDE) and user backup files.
Reference Manuals
- Fedora Details
- Hyprland Config Guide
- NVIDIA Setup & Wayland
- AMD Mesa Stack
- Intel Mesa Stack
- Wayland & Environment
- Portals & PipeWire
- Troubleshooting Matrix
1---2name: fedora-hyprland-installer-23description: Install, configure, verify, repair, update, and uninstall Hyprland on Fedora Linux with GPU-aware detection (NVIDIA/AMD/Intel).4---56# Fedora Hyprland Installer Skill78This skill provides an automated, safety-first workflow for managing Hyprland on Fedora Linux.910## Script Path Resolution Directive1112When `agy` is launched from a user's working directory, bundled scripts do NOT reside in `./scripts/`. 13The agent MUST first locate the base directory of the `fedora-hyprland-installer` skill (e.g., `<workspace>/.agents/skills/fedora-hyprland-installer`, `~/.gemini/antigravity-cli/skills/fedora-hyprland-installer`, or the skill repository root) and define it as `SKILL_DIR`.1415All bundled scripts MUST be executed using their full path relative to `SKILL_DIR`: `<SKILL_DIR>/scripts/<script-name>.sh`.1617---1819## Core Directives & Safety Rules20211. **Fedora-First**: Always use Fedora tools (`dnf`, `systemctl`, `loginctl`). Never use `apt`, `pacman`, or `yay`.222. **Never Blindly Execute**: Inspect the system prior to any installation or modification.233. **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).244. **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.255. **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.266. **Privileged Operations**: Sudo commands must be clearly identified and communicated to the user. Do not hardcode passwords.277. **Idempotency**: Running actions multiple times must be safe and avoid duplicate config lines.2829---3031## Workflow Guide3233### 1. Installation Workflow34When the user asks to **"Install Hyprland"** or **"Setup Hyprland on Fedora"**:351. Execute `<SKILL_DIR>/scripts/detect-system.sh` and `<SKILL_DIR>/scripts/detect-gpu.sh`.362. Execute `<SKILL_DIR>/scripts/preflight.sh` to verify Fedora release, network, package manager, and sudo access.373. Execute `<SKILL_DIR>/scripts/backup.sh` to preserve any pre-existing configurations.384. Execute `<SKILL_DIR>/scripts/install.sh` to install Hyprland, Wayland portal packages (`xdg-desktop-portal-hyprland`, `xdg-desktop-portal-gtk`), PipeWire/WirePlumber, terminal, launcher, status bar, and authentication agent.395. Execute `<SKILL_DIR>/scripts/configure.sh` to write a clean, functional initial Hyprland config (`~/.config/hypr/hyprland.conf`) tailored to detected terminal/launcher and GPU environment variables.406. Execute `<SKILL_DIR>/scripts/verify.sh` to ensure binaries, portal services, PipeWire, and login desktop entries (`/usr/share/wayland-sessions/hyprland.desktop`) exist and validate.417. Present a summary report detailing installed packages, backup paths, and login instructions.4243### 2. Repair Workflow44When the user asks to **"Fix Hyprland"**, **"Hyprland won't start"**, **"No audio"**, **"Screen sharing broken"**:451. Run `<SKILL_DIR>/scripts/detect-system.sh` and inspect system logs (`journalctl -xe`, `journalctl --user -u xdg-desktop-portal`).462. Execute `<SKILL_DIR>/scripts/repair.sh` to identify missing portals, PipeWire states, broken symlinks, or GPU driver mismatches.473. Apply minimal, targeted repairs without re-installing unchanged packages.484. Execute `<SKILL_DIR>/scripts/verify.sh`.4950### 3. Update Workflow51When the user asks to **"Update Hyprland"**:521. Run `<SKILL_DIR>/scripts/backup.sh`.532. Refresh Fedora package metadata (`sudo dnf check-update hyprland`).543. Update Hyprland and related Wayland packages via `<SKILL_DIR>/scripts/install.sh --update`.554. Validate configuration syntax and verify system integrity via `<SKILL_DIR>/scripts/verify.sh`.5657### 4. Uninstall Workflow58When the user asks to **"Uninstall Hyprland"**:591. Explain to the user which packages will be removed.602. Run `<SKILL_DIR>/scripts/backup.sh`.613. Execute `<SKILL_DIR>/scripts/uninstall.sh` to cleanly remove Hyprland packages while preserving base desktop environments (GNOME/KDE) and user backup files.6263---6465## Reference Manuals6667- [Fedora Details](references/fedora.md)68- [Hyprland Config Guide](references/hyprland.md)69- [NVIDIA Setup & Wayland](references/nvidia.md)70- [AMD Mesa Stack](references/amd.md)71- [Intel Mesa Stack](references/intel.md)72- [Wayland & Environment](references/wayland.md)73- [Portals & PipeWire](references/portals.md)74- [Troubleshooting Matrix](references/troubleshooting.md)
maleksaadi0109