OpenParable
Skip to content
← Back to skills

Update Theme

Design
update-theme

Update Theme is an Agent Skill for design published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Update the Warm Graphite color theme for lsd and vivid terminal tools. Use when modifying colors, refreshing the palette, or adjusting file type styling.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/development/update-theme/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/update-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.

Update lsd/vivid Theme

Update the Warm Graphite theme for lsd and vivid.

References

Getting Documentation

Clone repos for reference when needed:

git clone --depth 1 https://github.com/lsd-rs/lsd.git /tmp/lsd-repo
git clone --depth 1 https://github.com/sharkdp/vivid.git /tmp/vivid-repo

Key reference files:

  • /tmp/lsd-repo/doc/samples/colors-sample.yaml - lsd color config example
  • /tmp/lsd-repo/doc/colors.md - lsd color documentation
  • /tmp/vivid-repo/themes/ - vivid theme examples

File Locations

Master files (edit these):

  • lsd/colors.yaml - UI metadata colors (user, group, permissions, dates, git status)
  • lsd/config.yaml - lsd layout and behavior settings
  • vivid/themes/warm-graphite.yml - file type colors via LS_COLORS

Installed locations:

  • ~/.config/lsd/colors.yaml
  • ~/.config/lsd/config.yaml
  • ~/.config/vivid/themes/warm-graphite.yml

Color Palette (ANSI 256)

CodeNameHexUsed For
140mauve#af87d7user, symlinks, renamed (lavender)
243gray#767676group, unmodified
245light gray#8a8a8apermissions, older dates
240dark gray#585858no-access, ignored, tree-edge
223peach#ffd7afhour-old dates, highlights
174rose#d78787day-old dates, media (salmon)
186tan#d7d787large files, markup (chartreuse)
107sage#87af5fexecutables, git new, source code (lime)
178gold#d7af00git modified, config, archives (cleaner)
173coral#d7875ferrors, deleted, conflicts (terracotta)
73teal#5fafafdirectories, links, tooling (richer)

Workflow

  1. Edit the master files in this repo
  2. Install: just install
  3. Reload: source ~/.zshrc
  4. Test: just test
  5. Commit changes to git if satisfied

Testing Colors

To verify ANSI codes are being applied correctly (since terminal output may strip colors):

lsd -la --color=always | head -3 | cat -v

This shows raw ANSI escape codes like ^[[38;5;251m (color 251) so you can verify the config is loaded.

Color Formats

  • lsd colors.yaml: ANSI 256 codes (numbers) or named colors
  • vivid warm-graphite.yml: Hex colors without # prefix (e.g., "d7af5f")

Common Tasks

Change a specific color

  1. Find the element in the appropriate file
  2. Update the color code/hex value
  3. Run just install && source ~/.zshrc && just test

Add a new accent color to vivid

  1. Add to colors: section in warm-graphite.yml
  2. Reference it in the appropriate category (core, text, programming, etc.)