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.