Omarchy System Management

What it does

Provides a comprehensive guide for agents to manage Omarchy Linux installations. The skill catalogs command patterns (omarchy-*) and configuration locations, offers safe editing and backup patterns, and lists common tasks such as theme management, keybinding edits, monitor/display setup, screenshots, system updates, and troubleshooting. It emphasizes never modifying core ~/.local/share/omarchy/ files and recommends placing user config in ~/.config/.

When to use it

Use this skill when a user asks about Omarchy-specific system operations: changing themes, adding keybindings, restarting or refreshing services, editing Hyprland/Waybar configs, applying system updates, or performing safe configuration edits. Also use it as the first step before answering "how do I" questions — fetch the relevant manual pages it references.

What's included

• Scripts: the repository exposes many omarchy-* helper commands (discovery described in the SKILL.md) but the SKILL.md itself is a reference; no installation scripts bundled in the skill doc.
• References: the skill points to the Omarchy manual (learn.omacom.io) for authoritative procedures and includes an index of manual topics to fetch when answering user questions.
• Instructions: step-by-step safe edit pattern (backup, edit, restart), examples for themes, keybindings, display config, and troubleshooting commands.

Compatible agents

Agents with shell/command execution capabilities and access to the user's environment (to run omarchy-* commands and edit ~/.config) will get the most value from this skill.