omarchy-theminglisted
Install: claude install-skill aiskillstore/marketplace
# 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:
```bash
mkdir -p ~/.config/omarchy/themes/my-theme/backgrounds
```
2. Create `colors.toml` with all 22 required variables (see schema below)
3. Add wallpaper images to `backgrounds/`
4. Apply theme:
```bash
omarchy-theme-set my-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](reference.md).
## Theme Structure
```
~/.config/omarchy/themes/{theme-name}/
├── colors.toml # [Required] 22 color definitions
├── backgrounds/ # [Required] Wallpaper images (PNG/JPG)
├── preview.png # [Recommended] Theme preview
├── icons.theme # [Recommended] GTK icon theme name
├── neovim.lua # [Recommended] LazyVim colorscheme
├── vscode.json # [Recommended] VS Code theme metadata
├── btop.theme # [Recommended] btop color theme
├── light.mode # [Optional] Empty file = lig