What is the Color Expert skill?
Color Expert is an agent skill by meodai that adds color science to a coding agent. Its SKILL.md covers color spaces, OKLCH ramps, gamut mapping, WCAG and APCA contrast, harmony and pigment mixing, and points to 185 reference files for deeper questions on palettes and color naming.
Color Expert is a skill from the skill.color-expert repo that turns a coding agent into a color specialist. The author built it from resources he kept looking up: articles, talks, libraries and historical color texts.
It has three layers. SKILL.md holds the key facts the agent loads at once. references/INDEX.md maps one line per file. The references folder holds the deeper material, counted in the README at 185 markdown files.
What changes in the agent's output
- Perceptual work uses OKLCH or OKLAB rather than HSL, whose lightness the skill calls misleading for perceptual tasks.
- Ramps for design systems follow a token chain: reference palette, semantic roles, then component usage.
- Every text and background pair is checked against WCAG or APCA, in light and dark themes.
- Chroma is reduced, not lightness or hue, when a color falls outside the target gamut.
- Palette requests get several generation methods with trade-offs before the agent narrows to one.
Who the Color Expert skill is for
Best for
- Building a design token set or a light and dark theme with accessible contrast.
- Writing palette generators, gradients or color conversion code.
- Answering color questions such as why a gradient turns gray in the middle.
- Generative art and creative coding where color technique matters.
Not for
- A visual picker. It advises and writes code; it does not draw a UI.
- Layout, type or motion. Pair it with a design system skill for the structure around the colors.
- A one-line brand color pick with no context. The skill asks about medium, mood and constraints first.
Use it with UiChemy
Use Color Expert to settle the palette and tokens before a build. When the design is ready for WordPress, UiChemy Figma to WordPress converts a Figma design into an editable page. Click Get Started on uichemy.com.
How to install Color Expert Skill: OKLCH, Palettes and Contrast for AI Agents
git clone https://github.com/meodai/skill.color-expert ~/Sites/color-expertThe README also documents a one-command installer from the skills CLI and says to update with a git pull in the clone folder.Clone the repo
Run the clone command above. It brings in SKILL.md and the references folder together, which the skill needs to answer deeper questions.
Symlink into your agent
The README lists targets: ~/.codex/skills/color-expert for Codex, ~/.agents/skills/color-expert for OpenCode, ~/.claude/skills/color-expert for Claude Code, or .agents/skills/color-expert inside a project for any agent.
Create the link
For example,
ln -s ~/Sites/color-expert ~/.claude/skills/color-expert. Use the target that matches the agent you run.Ask a color question
Try a prompt such as: build a 9-step accent ramp in OKLCH and check every text pair against APCA.
Check that it loaded
Ask a color question that matches the skill description, such as an OKLCH palette request. The reply should name OKLCH and check contrast.
Key features
- Five working modesSKILL.md separates a concrete design project, design system tokens, generative art, a general color question and building a color tool, and tells the agent how deep to go in each.
- Color space tableA table maps tasks to spaces: OKLCH for perceptual changes and gradients, OKHSL for picking, HSLuv for normalized saturation, CIELAB D50 for print, CAM16 for appearance matching and CIEDE2000 for precise color difference.
- HSL limits explainedIt shows why saturated yellow and blue share HSL lightness 50% yet look different, why hue spacing is uneven, and when HSL is still fine for a quick CSS tweak.
- Gamut mapping rulesBrowsers gamut-map oklch() in CSS, but JavaScript conversions only truncate channels. The skill points to Culori clampChroma and inGamut checks so chroma is trimmed while lightness and hue stay put.
- Token structure guidanceRaw colors live in reference tokens, meaning lives in semantic tokens, and components use only the semantic layer. It also suggests encoding rules, such as best contrast against a surface, instead of fixed hex values.
- Accessibility numbersAn accessibility section lists key contrast figures. The README adds a brute-force study of about 281 trillion hex pairs that found only 11.98% pass WCAG AA and 0.08% pass APCA 90.
- Harmony and 60-30-10It treats hue-first harmony as a weak standalone heuristic, favors character such as pale, muted, vivid or deep, and covers the 60-30-10 proportion rule and legibility through lightness variation.
- Generative color techniquesTechniques include weighted hue selection, narrow-band hue jitter, cosine palettes, anchor interpolation, trajectory ramps, spectral mixing and palette cycling, each documented in references/techniques.
- Pigment, naming and historySections cover pigment mixing beyond the simple subtractive model, color temperature, multiple naming systems and historical corrections, so answers do not repeat tidy but wrong color folklore.
- Evals folderThe repo includes trigger and task prompts under evals so the skill can be reviewed against realistic color tasks, with a written rule for when it should and should not activate.
Frequently asked questions
What is the Color Expert skill?
Color Expert is an agent skill from the meodai/skill.color-expert repo. Its SKILL.md gives a coding agent working knowledge of color spaces, OKLCH palettes, contrast, harmony, naming and pigment mixing, with 185 reference files behind it for deeper questions.
How do I install the Color Expert skill?
Clone the repo, then symlink the folder into your agent's skills directory, for example ~/.codex/skills/color-expert or .agents/skills/color-expert in a project. The README also lists a one-command installer that detects your agents. Update later with a git pull in the clone.
Which agents does Color Expert work with?
The repo description says it works with Claude Code, Codex, Cursor, Copilot and others, and the README names Claude Code, Codex, Cursor, Copilot and OpenCode for the installer. Manual symlink targets are listed for Claude Code, Codex, OpenCode and project folders.
Why does Color Expert prefer OKLCH over HSL?
The skill says HSL lightness does not match perception: saturated yellow and blue both sit at 50% yet look very different. OKLCH keeps lightness, chroma and hue closer to what people see, so ramps and gradients avoid muddy mid-tones.
Does it check WCAG and APCA contrast?
Yes. For design systems the skill tells the agent to verify every text and background pair against APCA or WCAG in both light and dark themes. It also keeps an accessibility section with key numbers for those checks.
Can Color Expert build a Tailwind-style color scale?
It covers 9-step accent scales and Tailwind or Radix-style ramps in OKLCH, plus the token chain from palette to semantic roles. For the Tailwind setup itself, the Tailwind design system skill is the better fit.
What are Color Expert alternatives?
Narrower options include Better Colors for palettes and tokens, Color Contrast for contrast checks and Impeccable Colorize for strategic color in a UI. Color Expert is broader on theory and tools, but heavier to load.
Is Color Expert free to use?
The repo is public and lists the Creative Commons Attribution 4.0 license, which asks for credit to the author. Check the LICENSE file in the repo before reusing reference material in your own work.


