Update Omarchy skill for Quattro

[ssupt]

Summary

• document the active Omarchy 4 Hyprland Lua configuration and helpers
• document Quattro shell, bar, plugin cloning, menu extension, idle, and lock configuration
• cover every supported user hook and the composable hook installation workflow
• correct stale package, setup, restart, and support-log command guidance
• clarify packaged versus development paths and make privilege guidance consistent

Why

The Omarchy skill is the mandatory guide for end-user desktop customization, but parts of it still described pre-Quattro files and workflows. That could send agents to inactive Hyprland .conf files, hidden support commands, incomplete hook paths, or packaged shell plugin source.

This update aligns the full set of customization scenarios claimed by the skill with the current quattro branch while keeping Omarchy source-development workflows explicitly out of scope.

Verification

• ./test/cli
• git diff --check
• verified documented CLI routes against omarchy commands --json

./test/cli completed successfully. Its theme test emitted the expected sandbox-only /run/user/1000 lock warning, but the suite exited 0.

[Copilot]

Pull request overview

Updates the Omarchy agent skill documentation to reflect Omarchy 4 (“quattro”) Hyprland Lua configuration, so agents point users at the active *.lua modules (and Omarchy’s Lua helpers) instead of legacy *.conf files that may reload without effect.

Changes:

• Clarifies /usr/share/omarchy as packaged runtime files (or a linked dev checkout), not a Git-managed working tree.
• Updates Hyprland configuration guidance to reference hyprland.lua + the Lua override modules (bindings.lua, monitors.lua, etc.) and Omarchy helper APIs.
• Refreshes keybinding/monitor/window-rule examples and updates the canonical Hyprland window rules documentation link.

Tip

If you aren't ready for review, convert to a draft PR.
Click "Convert to draft" or run gh pr ready --undo.
Click "Ready for review" or run gh pr ready to reengage.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 1 comment.

Comments suppressed due to low confidence (1)

default/omarchy-skill/SKILL.md:353

• The rebind checklist still uses legacy .conf terminology (“unbind directive” / “bind”). Since this section now documents the Lua helpers, the checklist should reference calling hl.unbind(...) before o.bind(...) to match the examples and avoid confusion.

3. Inform the user what the key was previously bound to

[Copilot]

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 2 comments.

[Copilot]

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 1 comment.

[dhh]

Thanks — this caught real staleness. The essential corrections (Lua config layout, o.bind/hl.unbind/hl.monitor syntax, .d hook directories, plugin cloning, command route fixes) landed in 1feb025 with co-author credit, trimmed to keep the skill succinct. One note: { omarchy = "nautilus" } in the keybinding example would resolve to omarchy-launch-nautilus, which doesn't exist — { launch = "nautilus" } is the right form for launching apps.