Agent skill in the open SKILL.md format
A working color library for AI agents.
chromary is a portable skill that helps compatible AI agents research, design, evaluate, and explain color palettes: brand palettes, UI color systems, data visualization sets, and palettes from images. It computes WCAG contrast, builds OKLCH ramps, and exports tokens your project can paste in.
Free and open. The ZIP contains a folder with SKILL.md
and its references; extract it into your client's skills directory.
See compatibility for per client paths.
Overview
One repo to rule every color decision.
No more 40 tab chaos. chromary fuses APIs, perceptual color spaces, accessibility math, scientific colormaps, design system scales and AI palette generation into one opinionated toolkit.
Curated & opinionated
200+ hand picked resources, star rated with TL;DR tables and pitfalls in every guide. The vault tells you what to use, and what to skip.
Agent ready
Six drop in SKILL.md skills plus a working MCP server. Agents don't memorize hex codes, they compute them.
Actually runnable
Nine copy paste recipes and the zero dependency Chroma Lab. Every snippet tested, every claim sourced.
Resources
The Vault: 16 deep dive guides.
Every guide is a standalone Markdown doc in the repo, star rated with a TL;DR table at the top. Start with the ones your task needs.
| # | Guide | What's inside |
|---|---|---|
| 01 | REST APIs & MCP | The Color API, color.pizza, Colormind + MCP in 2 minutes |
| 02 | AI Agent Skills | The open SKILL.md format, progressive disclosure, per client paths |
| 03 | Perceptual Color Spaces | OKLCH/OKLab, CIE Lab/LCH, HSLuv, HCT, gamut mapping |
| 04 | Accessibility & Contrast | WCAG 2.1 math, APCA/WCAG 3, color blind simulation, auto-fix |
| 05 | Design Systems & Scales | Tailwind 50 to 950, Radix 12-step, shadcn tokens, Material 3 HCT |
| 06 | Data-Viz Colormaps | viridis, Crameri scientific maps, ColorBrewer, when jet attacks |
| 07 | CSS Gradients | Perceptual interpolation in OKLab, mesh gradients, grainy overlays |
| 08 | AI Palette Generation | Huemint, Khroma, Colormind + LLM prompting that respects contrast |
| 09 | Inspiration, Culture & Themes | Brand colors, Japanese & Chinese traditional palettes, dev themes |
| 10 | Image Color Extraction | Color Thief, Vibrant, fast-average-color, k-means recipes |
| 11 | Libraries & SDKs | culori, colorjs.io, chroma.js, colord · coloraide · go-colorful |
| 12 | Print & Physical Standards | Pantone, RAL, NCS, Munsell, CMYK workflows |
| 13 | Color Science & Standards | CIE, ICC, ΔE2000, CSS Color 4/5, the papers worth reading |
| 14 | Game & Pixel Palettes | Lospec, PICO-8, Sweetie 16, ENDESGA, dithering |
| 15 | Tool Selection Matrix | One giant table: task → first choice → alternative → skill → guide |
| 16 | Glossary | Hue, chroma, gamut, metamerism, ΔE, Lc, in plain English |
Recipes
Nine copy paste superpowers.
Small, tested files you can paste into any project. JavaScript, Python and CSS, each one does one job well.
Examples
Output you can paste straight in.
Rendered live by this page: no images, no JS libraries. The ramp below uses native CSS oklch(), the way the skill exports tokens.
Perceptual OKLCH ramp
One hue, chroma bell curve, 50 → 950.
Mesh gradient
Four radial OKLCH blobs, zero images.
Semantic tokens
Paste ready CSS custom properties.
/* this page's own theme */ --bg: #F7F6F2; /* paper */ --surface: #FFFFFF; --text: #202521; /* ink */ --primary: #225C48; /* pine */ --accent: #D9EF72; /* citron */ --alert: #C85B43; /* coral */
Install
Two minutes to a color-engineer agent.
Works with Claude Code, Cursor, Windsurf and any SKILL.md-aware runtime.
Install the skills
git clone https://github.com/izynu/chromary.git mkdir -p .claude/skills cp -r chromary/skills/* .claude/skills/
Per-project, versioned with your repo. Global install: ~/.claude/skills/ instead. Then just ask naturally: "give me a palette that matches #225C48".
Give it live tools (MCP)
cd chromary/mcp/example-color-server bun install && bun run index.ts
A working stdio MCP server with generate_palette and color_info tools. Full config for Claude Desktop, Cursor & VS Code in the MCP registry.
About
The armory of color.
chromary is free, open source software under the MIT license. Free for humans and agents alike. It stands on the shoulders of giants: Björn Ottosson (OKLab/OKLCH), Myndex (APCA), Fabio Crameri (scientific colormaps), Cynthia Brewer (ColorBrewer), and the maintainers of culori, colorjs.io and chroma.js.
Contributions are extremely welcome, adding a resource takes two minutes. Read CONTRIBUTING.md and be excellent to each other.
chromary is built and maintained by Zynu. If it saved you a 40 tab rabbit hole, a star makes the algorithm smile.
MIT License · © 2026 Zynu