Omarchy

Guide safe configuration edits for Omarchy Linux systems.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/marlonangeli/omarchy-wsl --skill omarchy-marlonangeli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Omarchy
Source: https://github.com/marlonangeli/omarchy-wsl/tree/main/default/omarchy-skill
Command: npx skills add https://github.com/marlonangeli/omarchy-wsl --skill omarchy-marlonangeli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually editing Omarchy system configurations can lead to mistakes, misconfigurations, and unsafe changes that disrupt stability. This skill provides policy-driven guidance to ensure edits occur only in safe, user-level locations and through approved Omarchy commands.

Core Features & Use Cases

  • Enforces safe editing practices for Omarchy-related config files in ~/.config (hypr, waybar, walker, omarchy) and related directories.
  • Documents recommended command workflows (theme changes, refreshes, updates, and hooks) to prevent accidental system-wide modifications.
  • Serves as a decision framework to route changes through safe patterns, ensuring read-only sources are consulted and user prompts are minimized.

Quick Start

Invoke this skill before editing any Omarchy configuration files to ensure safe, auditable changes.

Frequently Asked Questions about Omarchy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely edit Hyprland configuration files in Omarchy Linux?

Safely edit Hyprland configuration files in Omarchy Linux by restricting changes to user-level directories like ~/.config/hypr/ and routing updates through standardized Omarchy commands to prevent accidental system-wide modifications.

What is the best way to manage waybar and walker configs without breaking Omarchy?

Manage waybar and walker configs without breaking Omarchy by enforcing safe editing practices in ~/.config/waybar/ and ~/.config/walker/, consulting read-only sources, and applying standardized commands to maintain system stability.

How do I apply theme changes and config refreshes in Omarchy?

Apply theme changes and config refreshes in Omarchy by utilizing documented command workflows that route updates through safe patterns, ensuring changes are auditable and do not disrupt core system stability.

Can I use custom hooks when modifying my Omarchy Linux setup?

Yes, you can use custom hooks when modifying your Omarchy Linux setup by following policy-driven guidance that directs changes through safe, user-level locations and approved commands to guard against destructive actions.

Why should I avoid manual edits in Omarchy configuration directories?

Avoid manual edits in Omarchy configuration directories because they can lead to mistakes and unsafe changes that disrupt stability; using approved commands and safe patterns prevents accidental misconfigurations.