Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
- Updated the description to clarify: assume the host is Omarchy by default unless the user states otherwise. - Strengthened guidance to use Omarchy-native workflows for all local system tasks, not just when explicitly told so. - No changes to commands, documentation structure, or operating rules. - No file or command modifications detected in this release.
What This Skill Does
Omarchy is a Linux desktop environment built around Hyprland with 161 wrapper scripts for system management. The skill sets operating rules that favor omarchy-* commands over generic Linux one-liners to preserve expected state behavior. It covers package management, theme switching, service restarts, system updates, and hardware configuration.
Omarchy's wrapper scripts handle session and environment assumptions that raw commands like pkill or pacman skip, reducing the chance of leaving the desktop in an inconsistent state.
When to use it
- Restarting Waybar or Pipewire after a desktop crash
- Switching and syncing themes across VS Code, browser, and Obsidian
- Installing or removing packages through omarchy-pkg wrappers instead of raw pacman
- Running a staged system update with an availability pre-check
- Troubleshooting audio, Bluetooth, or Wi-Fi service failures
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Switch to a different desktop theme
- 1Run omarchy-theme-list to see available themes
- 2Run omarchy-theme-set with the chosen theme name
- 3Run omarchy-theme-set-vscode to sync the editor
- 4Run omarchy-theme-set-browser to sync the browser
Theme applied to the desktop and integrated applications
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.