From hyprland-config
This skill should be used when the user asks about Hyprland configuration syntax, "hyprland.conf", how to configure monitors, input, decoration, animations, keybinds/keybindings, dispatchers, submaps, window rules, layer rules, workspace rules, gestures, or environment variables in Hyprland, what a Hyprland config option or hyprctl keyword does, whether a Hyprland option is deprecated or renamed, to review/audit an existing hyprland.conf for outdated syntax, or about the Hyprland ecosystem and companion packages (hyprlock, hypridle, hyprpaper, hyprpicker, hyprsunset, hyprpolkitagent, waybar, status bars, launchers like wofi/rofi/fuzzel, notification daemons, clipboard managers, screenshot tools, portals/screen sharing) and how to wire them in. Also covers how to make the desktop look visually appealing — styling guides for waybar, launchers, notifications, terminals, hyprlock, GTK/Qt apps, btop/cava/fastfetch/starship, and the Hyprland decoration/animation look, plus cross-cutting design principles (palette coherence, accent, spacing, transparency, fonts) drawn from how the community rices these. Provides authoritative reference material for the Hyprland (Wayland compositor) config language, ecosystem, and visual styling.
How this skill is triggered — by the user, by Claude, or both
Slash command
/hyprland-config:hyprland-referenceThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Authoritative reference for the Hyprland configuration language: file format, every major
Authoritative reference for the Hyprland configuration language: file format, every major
config section, keybinding/dispatcher syntax, window rules, and a catalog of options that have
been renamed or removed across versions. Use this to answer "how do I configure X in Hyprland"
questions and to write or audit hyprland.conf files that use correct, current syntax.
It also carries a styling reference library (references/styling/) for the visual design
side — how to make waybar, launchers, notifications, terminals, hyprlock, GTK/Qt apps, and the
Hyprland decoration/animation look genuinely good, plus cross-cutting design principles. Reach for
that section when the question is about appearance ("make my X look nice / match / ricing") rather
than syntax; see the dedicated section below.
~/.config/hypr/hyprland.conf.misc:disable_autoreload is set).general { gaps_in = 5 }general:gaps_in = 5$name = value, reference as $name. Example: $mod = SUPER.source = ~/.config/hypr/monitors.conf. Sourcing is how modular
configs are assembled (one main file that sources topic files).# to end of line.rgba(rrggbbaa), rgb(rrggbb), or 0xAARRGGBB. Gradients list multiple colors
plus an optional angle: col.active_border = rgba(33ccffee) rgba(00ff99ee) 45deg.references/deprecations.md so old tutorials' syntax is not reproduced.hyprctl version when a real system is available.Consult these as needed — each is loaded only when relevant:
references/config-syntax.md — file format, variables, sourcing, keyword vs block form,
color/gradient syntax, dynamic variables, and config-reload behavior.references/sections.md — every major section (monitor, input, general,
decoration, animations, dwindle, master, gestures, group, misc, cursor,
binds, xwayland) with their commonly used options and value types.references/keybindings.md — bind and its variants (bindm, binde, bindl,
bindr, bindel, …), modifier syntax, submaps, and the dispatcher catalog.references/window-rules.md — windowrule / windowrulev2, layerrule,
workspace rules, matcher fields (class, title, initialClass, …), and common recipes.references/deprecations.md — options that were renamed or removed and their modern
replacements (shadow/blur subcategories, master:new_status, cursor category, the
windowrule/windowrulev2 merge, and more). Check this before trusting any older example.references/testing.md — how to read a config (resolving source=) and how to actually
test it on a live Hyprland (hyprctl reload + hyprctl configerrors, hyprctl keyword for a
single option), plus the safe apply→test→rollback pattern. Use whenever changing a live config.references/ecosystem.md — the official Hypr ecosystem tools (hyprlock, hypridle,
hyprpaper, hyprpicker, hyprsunset, hyprpolkitagent, hyprshot, portals) plus the
community packages commonly paired with Hyprland (status bars, launchers, notification
daemons, clipboard, screenshots, OSD, theming), with launch commands and the hyprlock /
hypridle / hyprpaper config formats. Use when wiring companion apps into a config.For visual design — not syntax — consult references/styling/. Each page surveys how the
community actually styles a component and distills a palette-driven recipe. Start with
design-principles.md (the coherence layer), then the per-app page. Use these whenever building or
theming a desktop for looks, or when the user asks "how do I make my X look good / nicer / match".
references/styling/README.md — index + the rice palette contract every recipe uses.references/styling/design-principles.md — read first. Coherence rules (one palette,
accent discipline, spacing, shape, transparency, typography), the aesthetic archetypes
(Catppuccin/Tokyo Night/Gruvbox/Nord/Material You/minimal/maximalist), wallpaper-driven theming,
a coherence checklist.references/styling/hyprland-decoration.md — gaps, gradient borders, rounding, blur, shadow,
animations/beziers — the compositor's own look.references/styling/waybar.md — the status bar (config.jsonc layout + style.css).references/styling/widgets.md — desktop widgets beyond the bar: choosing a widget system
(decision matrix), the widget archetypes, turnkey panels (HyprPanel/nwg-shell), theming flow.references/styling/eww.md — eww (yuck + SCSS): dashboards, sidebars, OSDs, music, gauges.references/styling/ags-astal.md — AGS / Astal (JS/TS over GTK): the v1-vs-v2 split, material
cards, quick-settings toggles, blurred album-art player, matugen Material You.references/styling/quickshell.md — QtQuick/QML desktop shells (caelestia, end-4, Noctalia,
DankMaterialShell): styling via QML properties (not CSS), the Theme/Colors singleton + matugen.references/styling/launchers.md — wofi / rofi / fuzzel / tofi.references/styling/notifications.md — mako / dunst / swaync.references/styling/terminals.md — kitty / alacritty / foot / wezterm / ghostty.references/styling/hyprlock.md — the lock screen.references/styling/gtk-qt.md — GTK/libadwaita + Qt app theming (themes, icons, cursors).references/styling/tui-and-prompt.md — btop / cava / fastfetch / starship.decoration:shadow { } and decoration:blur { }
subcategories — drop_shadow/shadow_range at the top of decoration are deprecated.master:new_is_master was replaced by master:new_status / master:new_on_top.general/input into a dedicated cursor { } category.windowrulev2 syntax was merged into windowrule; both still parse but prefer the unified
form on current versions. See references/deprecations.md.monitor lines are positional: name, resolution@hz, position, scale — order matters.Provides UI/UX resources: 50+ styles, color palettes, font pairings, guidelines, charts for web/mobile across React, Next.js, Vue, Svelte, Tailwind, React Native, Flutter. Aids planning, building, reviewing interfaces.
Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.
npx claudepluginhub nschatz/hyprland-config --plugin hyprland-config