Agent skill · design visual · aiskillstore
omarchy-theming
Create and manage Omarchy desktop themes. Use when working with colors.toml, terminal themes (Alacritty/Kitty/Ghostty), Hyprland colors, Waybar styling, btop themes, or theme installation/removal.
Why this skill is useful
Provides specific theme creation guidelines and color variable definitions for Omarchy that the AI wouldn't reliably generate on its own.
What it needs
About 3k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Omarchy Theme Creation Create themes for Omarchy by defining colors in colors.toml. Colors automatically propagate to all desktop applications. Quick Start <steps> 1. Create theme directory: 2. Create colors.toml with all 22 required variables (see schema below) 3. Add wallpaper images to backgrounds/ 4. Apply theme: </steps> Instructions When creating or modifying Omarchy themes: 1. Always define all 22 color variables in colors.toml - missing variables cause errors 2. Use HEX format only (#RRGGBB) - no RGB, HSL, or named colors 3. Include backgrounds/ directory with at least one wallpaper image 4. For light themes, create empty light.mode file in theme directory 5. Test with omarchy-theme-set after changes For detailed variable usage per application, see reference.md. Theme Structure colors.toml Schema <schema> </schema> Template Variables Each color supports 3 formats for different contexts: Format Example Output Use Case -------- --------- -------- ---------- {{ name }} {{ accent }} #89b4fa CSS, TOML {{ namestrip }} {{ accentstrip }} 89b4fa Hyprland rgb() {{ namergb }} {{ accentrgb }} 137,180,250 RGBA values Examples <example title="Dark Theme (Tokyo Night)"> </example> <example title="Light Theme (Catppuccin Latte)"> </example> <example title="neovim.lua"> </example> <example title="vscode.json"> </example> Theme Commands Troubleshooting <troubleshooting> Colors not applying: Verify all 22 variables defined Check HEX format (#RRGGBB) Run omarchy-theme-set to regenerate App not themed: Place static config in theme folder to override template Check variable names match colors.toml keys yq errors: </troubleshooting>
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/omarchy-theming