hermes-themes

Create and activate YAML color themes for the Hermes CLI, TUI, and desktop GUI.

1|Updated Aug 11, 2026
One-click install
npx skills add https://github.com/Chia1104/agent-air --skill hermes-themes-chia1104
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hermes-themes
Source: https://github.com/Chia1104/agent-air/tree/main/skills/hermes/hermes-themes
Command: npx skills add https://github.com/Chia1104/agent-air --skill hermes-themes-chia1104

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Customizing the appearance of Hermes across its CLI, TUI, and desktop GUI normally requires touching multiple surfaces; this Skill lets you define one YAML skin file that themes every surface at once and applies it live. ## Core Features & Use Cases - Single-file theming: Author one YAML skin in <hermes-home>/skins/ that colors the CLI, TUI, and desktop GUI through semantic keys like ui_accent, background, and ui_tool. - Live activation and tweaking: Apply a skin with hermes config set display.skin <name> or adjust one color in the active skin with hermes skin set <key> <hex>, with every surface repainting within about a second. - Use Case: A user asks for a synthwave look for Hermes. You copy the provided skin template, fill in a magenta-and-cyan palette, write it to the skins directory, activate it, and confirm the new theme landed on all surfaces. ## Quick Start Ask the agent to create a custom Hermes theme with your preferred colors and activate it across the CLI, TUI, and desktop.

Frequently Asked Questions about hermes-themes

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

FAQPage Schema
How do I create a custom theme for Hermes?▼

Create a YAML skin file by copying the skin template, filling in the colors palette, and writing it to the skins directory under the Hermes home folder. Then activate it by running hermes config set display.skin with your skin name, which repaints all surfaces live.

How do I change one color in the current Hermes theme?▼

Use the command hermes skin set followed by the key and hex value, such as hermes skin set ui_tool "#00FFFF". This edits only that key in the active skin file, preserving the rest of the palette including the background.

Does a Hermes skin apply to the CLI, TUI, and desktop GUI?▼

Yes, one YAML skin file themes all three surfaces at once. The skin engine resolves the active skin and the gateway pushes it everywhere, repainting each surface within about a second of activation.

Why should I not edit config.yaml directly to change the Hermes theme?▼

Hand-editing config.yaml risks a stray indent that corrupts the file and can break the live gateway. The safe writer command hermes config set display.skin always emits valid YAML and triggers the skin watcher automatically.

What color format do Hermes skins support?▼

Hermes skins require full #rrggbb hex values. Shorthand #rgb, rgb() functions, and named colors are not guaranteed to parse on every surface, so always use six-digit hex codes.