omarchy

Guide safe edits to Omarchy configuration files with backups and validation.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/stamatim/agent-skills --skill omarchy-stamatim
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: omarchy
Source: https://github.com/stamatim/agent-skills/tree/main/.agents/skills/omarchy
Command: npx skills add https://github.com/stamatim/agent-skills --skill omarchy-stamatim

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents unsafe manual edits by guiding users to safely modify Omarchy configuration files.

Core Features & Use Cases

  • Safe config editing guidance across the primary Omarchy config directories.
  • Backup and restore support before applying changes.
  • Restart guidance after applying changes and auto-detection of impacted components.

Quick Start

Confirm the exact config file and apply the change safely by backing up the current file, editing the appropriate ~/.config file, and reloading the relevant component.

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 config files without breaking my system?▼

To safely edit Hyprland config files, back up the current file before making changes, modify the appropriate ~/.config/hypr/ file, and reload the relevant component to apply the update without breaking the system.

What is the best way to manage Omarchy configuration updates across multiple directories?▼

The best way to manage Omarchy configuration updates is to use an approach that enforces safe patterns with backups, validation, and clear restart guidance across ~/.config/hypr/, waybar, walker, and omarchy directories.

How do I back up and restore Waybar or Walker settings before applying changes?▼

You can back up and restore Waybar or Walker settings by creating a backup of the current files in ~/.config/waybar/ or ~/.config/walker/ before editing, ensuring you can revert if the new configuration causes issues.

Why does my Hyprland window manager break after manual config edits?▼

Hyprland can break after manual config edits due to syntax errors or unsafe modifications. Validating configurations and following guided restart procedures for impacted components prevents these system failures.

Can I modify automation hooks and themes in Omarchy without losing my previous setup?▼

Yes, you can modify automation hooks and themes without losing your setup by backing up the current configuration files in ~/.config/omarchy/ before applying changes, allowing for safe restoration if needed.