Add Theme
Designadd-themeAdd Theme is an Agent Skill for design published in the IvanWng97/pixtuoid repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Add a new color theme to pixtuoid (a full ~90-role palette across 9 groups, rendered into the office). Use when the user says 'add a <name> theme', 'new color scheme', or 'port <palette> to pixtuoid'. Orchestrates the Rust registration PLUS the two steps agents miss — the site manifest bridge test and the committed-media regen.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/IvanWng97/pixtuoid/blob/HEAD/.claude/skills/add-theme/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/add-theme, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
add-theme (v1)
A theme is a pub static Theme with ~90 color roles across 9 groups
(surface, office, lighting, furniture, effects, ui, tool_glow, ApplianceColors
for corridor appliances, and SourceColors for per-CLI dashboard badge hues).
Every field must be supplied — corridor appliances render wrong until each theme
provides its own set.
When to use
- "Add a
<name>theme" / "new color scheme" / "port<palette>".
The checklist
Full current steps: .github/prompts/add-theme.prompt.md
- the theme notes in
crates/pixtuoid/src/tui/CLAUDE.md. Read an existing theme (e.g.crates/pixtuoid-scene/src/theme/dracula.rs) for the full field set, then:
- Create
crates/pixtuoid-scene/src/theme/<name>.rs— fill EVERY field; never fall back to the normal palette. - Register:
modintheme/mod.rs, append&<NAME>toALL_THEMES,theme_by_name()resolves the kebab-case name. - Each palette key must map to a UNIQUE RGB — the renderer recolors by RGB
equality (
recolor_frame); duplicate keys collide silently.
The two steps agents miss (both have teeth)
site/src/themes.jsonrow (id= the kebab-case name) —theme_gallery_manifest_matches_all_themes(theme/mod.rs) asserts the manifest ids ==ALL_THEMESnames, so the theme failsjust testuntil the row exists. The site never runs the binary, so this bridge test is the only guard that the switcher stays in sync.just gen-media—themes.jsondrives the committed theme stills; a new theme drifts them, so regenerate and commit them or the smokegen-checkreds the PR (the same error the bridge test's message points at).
(Full step list + field details: add-theme.prompt.md + the tui CLAUDE.md theme
notes — this skill headlines the two teeth steps agents miss.)
Finish
just test—appliance_palette_is_legible_for_every_theme+ the snapshot tests must pass; update insta snapshots if the theme list changed.- Visually verify — render the
snapshotexample and eyeball the office (see thebeautify-decorationskill); a palette that passes the legibility guard can still read badly. just preflight, then the two-lens-review skill (a theme is public-facing — add the editorial/film-critic lens for the rendered stills).