skills.rest
okw0204
okw0204COMMUNITY
Explore all skills by this author →
GitHub

omarchy

Guide safe customization of Omarchy configuration files in ~/.config/.

Updated Mar 10, 2026
Search Tags:#safety#linux#config-management#waybar#hyprland#omarchy
One-click install
npx skills add https://github.com/okw0204/dotfiles --skill omarchy-okw0204
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: omarchy
Source: https://github.com/okw0204/dotfiles/tree/main/dot_config/opencode/skills/omarchy
Command: npx skills add https://github.com/okw0204/dotfiles --skill omarchy-okw0204

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps end users customize Omarchy-installed systems by guiding safe edits to user-focused config directories, while preventing changes to read-only internal source trees.

Core Features & Use Cases

  • Guided safe editing of ~/.config/* (Hyprland, Waybar, Walker, terminal configs, omarchy) with explicit safety caveats.
  • Enforces best practices for resets and backups via omarchy-refresh commands.
  • Provides a decision framework for whether a change should be applied directly, via themes, or via hooks.

Quick Start

Read the safety guidelines and edit your ~/.config files using the recommended practices, then apply changes with the appropriate omarchy-* commands.

Frequently Asked Questions about omarchy

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

FAQPage Schema
How do I safely customize Hyprland and Waybar configurations in Omarchy?▼

To safely customize Omarchy, edit user-focused config files within ~/.config/omarchy/ and related directories, then apply changes using omarchy-refresh commands to avoid modifying the read-only internal source tree.

What is the best way to apply Omarchy configuration changes without breaking the system?▼

The best way to apply Omarchy configuration changes safely is by using omarchy-refresh commands for resets and backups, ensuring you only edit ~/.config/* files and never modify ~/.local/share/omarchy/.

Can I directly modify the internal source tree to change Walker and terminal settings?▼

No, you cannot directly modify the internal source tree. You must use a decision framework to apply changes directly, via themes, or via hooks by editing ~/.config/ files instead of read-only source directories.

When do I need to use omarchy-refresh commands for config management?▼

You need to use omarchy-refresh commands when you want to enforce best practices for resets and backups after editing your Hyprland, Waybar, Walker, or terminal configurations in ~/.config/omarchy/.

Why should I refrain from editing ~/.local/share/omarchy/ files?▼

You should refrain from editing ~/.local/share/omarchy/ because it contains the read-only internal source tree; modifying it breaks safe config management workflows and prevents proper Omarchy customization.

Does Omarchy config management support applying changes via themes and hooks?▼

Yes, Omarchy config management provides a decision framework to determine whether a change should be applied directly, via themes, or via hooks to safely implement user preferences for Hyprland and Waybar.

Related Skills

Explore More Software Engineering Skills→
zebbernzebbern
4.5k

Privilege Escalation Methods

Guide ethical privilege escalation on Linux and Windows systems.

Community
Advanced
khrorekhrore

omarchy

Manage Omarchy desktop and Hyprland configuration files under ~/.config/.

Community
Advanced
miguelcsilvamiguelcsilva

omarchy

Manage and configure Omarchy desktop environment settings and user configuration files.

Community
Advanced
ConnectiveTCSConnectiveTCS

pinia

Manage JARVIS system state with type-safe Pinia stores.

Community
Advanced