Claude Code Plugins

Community-maintained marketplace

Feedback

omarchy

@robzolkos/omarchy-skill
15
0

Manage and configure Omarchy Linux systems. Use when user asks about Omarchy, Hyprland, themes, keybindings, system config, or any omarchy-* commands.

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name omarchy
description Manage and configure Omarchy Linux systems. Use when user asks about Omarchy, Hyprland, themes, keybindings, system config, or any omarchy-* commands.

Omarchy Skill

Manage Omarchy Linux systems using natural language.

Discovery

Omarchy provides ~145 commands following the pattern omarchy-<category>-<action>.

Find Commands

# List all omarchy commands
compgen -c | grep -E '^omarchy-' | sort -u

# Find commands by category
compgen -c | grep -E '^omarchy-theme'
compgen -c | grep -E '^omarchy-restart'

# Read a command's source to understand it
cat $(which omarchy-theme-set)

Command Categories

Prefix Purpose Example
omarchy-refresh-* Reset config to Omarchy defaults (backs up first) omarchy-refresh-waybar
omarchy-restart-* Restart a service/app omarchy-restart-waybar
omarchy-toggle-* Toggle feature on/off omarchy-toggle-nightlight
omarchy-theme-* Theme management omarchy-theme-set <name>
omarchy-install-* Install optional software omarchy-install-docker-dbs
omarchy-launch-* Launch apps omarchy-launch-browser
omarchy-cmd-* System commands omarchy-cmd-screenshot
omarchy-pkg-* Package management omarchy-pkg-install <pkg>
omarchy-setup-* Initial setup tasks omarchy-setup-fingerprint
omarchy-update-* System updates omarchy-update

Configuration Locations

Hyprland (Window Manager)

~/.config/hypr/
├── hyprland.conf      # Main config (sources others)
├── bindings.conf      # Keybindings
├── monitors.conf      # Display configuration
├── input.conf         # Keyboard/mouse settings
├── looknfeel.conf     # Appearance (gaps, borders, animations)
├── envs.conf          # Environment variables
├── autostart.conf     # Startup applications
├── hypridle.conf      # Idle behavior (screen off, lock, suspend)
├── hyprlock.conf      # Lock screen appearance
└── hyprsunset.conf    # Night light / blue light filter

Restart/Refresh:

  • omarchy-refresh-hyprland - Reset to defaults
  • Hyprland auto-reloads on config save (no restart needed)
  • omarchy-restart-hypridle / omarchy-restart-hyprsunset for those services

Waybar (Status Bar)

~/.config/waybar/
├── config.jsonc       # Bar layout and modules (JSONC format)
└── style.css          # Styling

Restart/Refresh:

  • omarchy-restart-waybar - Restart waybar
  • omarchy-refresh-waybar - Reset to defaults
  • omarchy-toggle-waybar - Show/hide

Walker (App Launcher)

~/.config/walker/
└── config.toml        # Launcher configuration

Restart/Refresh:

  • omarchy-restart-walker
  • omarchy-refresh-walker

Terminals

~/.config/alacritty/alacritty.toml
~/.config/kitty/kitty.conf
~/.config/ghostty/config

Restart:

  • omarchy-restart-terminal

Other Configs

App Location
btop ~/.config/btop/btop.conf
fastfetch ~/.config/fastfetch/config.jsonc
lazygit ~/.config/lazygit/config.yml
starship ~/.config/starship.toml
git ~/.config/git/config

Omarchy Data

~/.local/share/omarchy/
├── bin/               # All omarchy-* scripts
├── config/            # Default config templates
├── themes/            # Installed themes
└── version            # Current version info

Safe Editing Pattern

When modifying any Omarchy config:

1. Read Current Config

cat ~/.config/<app>/config

2. Backup Before Changes

cp ~/.config/<app>/config ~/.config/<app>/config.bak.$(date +%s)

3. Make Changes

Use the Edit tool. Preserve existing structure and comments.

4. Apply Changes

# For most apps, use the restart command
omarchy-restart-<app>

# Or reset to defaults (creates backup automatically)
omarchy-refresh-<app>

Common Tasks

Themes

omarchy-theme-list              # Show available themes
omarchy-theme-current           # Show current theme
omarchy-theme-set <name>        # Apply theme
omarchy-theme-next              # Cycle to next theme
omarchy-theme-bg-next           # Cycle wallpaper
omarchy-theme-install <url>     # Install from git repo

Keybindings

Edit ~/.config/hypr/bindings.conf. Format:

bind = SUPER, Return, exec, xdg-terminal-exec
bind = SUPER, Q, killactive
bind = SUPER SHIFT, E, exit

View current bindings: omarchy-menu-keybindings

Display/Monitors

Edit ~/.config/hypr/monitors.conf. Format:

monitor = eDP-1, 1920x1080@60, 0x0, 1
monitor = HDMI-A-1, 2560x1440@144, 1920x0, 1

List monitors: hyprctl monitors

Screenshots

  • omarchy-cmd-screenshot - Interactive screenshot
  • omarchy-cmd-screenrecord - Toggle screen recording

System

omarchy-update                  # Full system update
omarchy-version                 # Show Omarchy version
omarchy-debug                   # Debug info for troubleshooting
omarchy-lock-screen             # Lock screen
omarchy-cmd-shutdown            # Shutdown
omarchy-cmd-reboot              # Reboot

Fonts

omarchy-font-list               # Available fonts
omarchy-font-current            # Current font
omarchy-font-set <name>         # Change font

Troubleshooting

# Check Omarchy state
omarchy-state

# Debug information
omarchy-debug

# Upload logs for support
omarchy-upload-log

# Reset specific config to defaults
omarchy-refresh-<app>

# Full reinstall (nuclear option)
omarchy-reinstall

Example Requests

  • "Change my theme to catppuccin"
  • "Add a keybinding for Super+E to open file manager"
  • "Configure my external monitor"
  • "Make the window gaps smaller"
  • "Set up night light to turn on at sunset"
  • "Show me what omarchy commands are available for bluetooth"
  • "Increase waybar height"
  • "Change my terminal font"