omarchy-theming_skill

Overview

This skill creates and manages Omarchy desktop themes by generating and validating the required colors.toml and related theme files. It automates propagation of colors to terminals, Hyprland, Waybar, btop, Neovim, and VS Code, and provides install/update/remove commands for theme management.

How this skill works

The skill inspects a theme directory structure (~/.config/omarchy/themes/{theme}) and ensures colors.toml contains all 22 required HEX variables. It supports template variables ({{ name }}, {{ name_strip }}, {{ name_rgb }}) and can generate or validate terminal, Hyprland, Waybar, btop, and editor theme files. It also manages wallpapers, previews, and applies themes via omarchy-theme-set and related commands.

When to use it

• Creating a new Omarchy desktop theme from scratch
• Modifying colors.toml or updating theme previews and wallpapers
• Converting a color palette into terminal, Hyprland, Waybar, btop, or Neovim files
• Installing, updating, listing, or removing community themes
• Troubleshooting apps that do not pick up theme changes

Best practices

• Always define all 22 color variables in colors.toml using HEX (#RRGGBB) to avoid errors
• Include a backgrounds/ folder with at least one wallpaper image and a preview.png when possible
• Create an empty light.mode file for light themes to mark light-mode behavior
• Use template variables ({{ name }}, {{ name_strip }}, {{ name_rgb }}) for consistent outputs across contexts
• Test changes immediately with omarchy-theme-set and check omarchy-theme-current for the active theme

Example use cases

• Build a Tokyo Night dark theme: author colors.toml, add wallpapers, add neovim.lua and vscode.json, then run omarchy-theme-set
• Create a Catppuccin Latte light theme: define colors.toml, add an empty light.mode file, include preview and icons.theme, then install
• Package a theme for distribution: include btop.theme and hyprland.conf overrides, then omarchy-theme-install <git-url>
• Quickly fix missing app colors: add a static config (hyprland.conf or chromium.theme) in the theme folder to override templates
• Cycle wallpapers automatically using omarchy-theme-bg-next after adding multiple images to backgrounds/