Color Systems
Use this skill when designing or reviewing color palettes, implementing them in code, or ensuring accessibility compliance.
MCP Tool Discovery
The plugin provides visual analysis tools usable across agent contexts:
| Color Task |
Tool Name Pattern |
| Extract palettes from images |
analyze_image — query for dominant colors |
| Generate palette swatches |
nv_oos_*_agent_generate_gemini_image_validated or bare |
| Web search for color trends |
nv_oos_*_agent_web_search_validated or bare |
| Cross-site color sync |
remote_wp_connection — push brand colors to spoke sites |
WP-CLI Commands
Key mcp-ai WP-CLI commands for design workflows. Run via terminal:
| Command |
Use for |
wp mcp-ai health |
Verify tool and provider availability |
wp mcp-ai provider |
Check configured AI providers |
When to use this skill
Trigger when ANY of the following is true:
- Creating a new color palette for a brand, website, or design project.
- Implementing color tokens / design tokens in CSS.
- Auditing color contrast for WCAG compliance.
- Adding dark mode or multiple theme support.
- Extracting colors from images or generating complementary palettes.
- The task mentions "color scheme", "palette", "brand colors", or "accessibility contrast".
Color theory foundations
Color relationships
Primary → Main brand color (60% usage)
Secondary → Complementary accent (30% usage)
Accent → CTAs, highlights (10% usage)
Neutral → Text, backgrounds, borders
Semantic → Success (green), Error (red), Warning (amber), Info (blue)
Palette types
| Type |
Structure |
Example |
| Monochromatic |
One hue, varying saturation/lightness |
Spotify green ecosystem |
| Analogous |
2-3 adjacent hues on color wheel |
Calm, cohesive brands (wellness, nature) |
| Complementary |
Opposite hues (blue + orange) |
High contrast, energetic (sports, entertainment) |
| Triadic |
3 evenly spaced hues |
Vibrant, balanced (education, family) |
| Neutral + Pop |
Grays + one bold accent |
Modern, sophisticated (tech, luxury) |
WCAG contrast requirements
| Level |
Normal Text |
Large Text (18px+ bold or 24px+) |
UI Components |
| AA (minimum) |
4.5:1 |
3:1 |
3:1 |
| AAA (enhanced) |
7:1 |
4.5:1 |
3:1 |
Test contrast: https://webaim.org/resources/contrastchecker/
Common failing combinations
❌ #CCCCCC text on #FFFFFF — 1.6:1 (fail AA)
✅ #767676 text on #FFFFFF — 4.5:1 (pass AA)
❌ #999999 text on #FFFFFF — 2.85:1 (fail AA large text threshold)
✅ #595959 text on #FFFFFF — 7:1 (pass AAA)
CSS custom properties implementation
Design tokens
:root {
/* ── Brand palette ── */
--color-primary: #2563EB;
--color-primary-light: #3B82F6;
--color-primary-dark: #1D4ED8;
--color-secondary: #7C3AED;
--color-accent: #F59E0B;
/* ── Neutrals ── */
--color-neutral-50: #FAFAFA;
--color-neutral-100: #F5F5F5;
--color-neutral-200: #E5E5E5;
--color-neutral-300: #D4D4D4;
--color-neutral-400: #A3A3A3;
--color-neutral-500: #737373;
--color-neutral-600: #525252;
--color-neutral-700: #404040;
--color-neutral-800: #262626;
--color-neutral-900: #171717;
/* ── Semantic ── */
--color-success: #16A34A;
--color-warning: #D97706;
--color-error: #DC2626;
--color-info: #2563EB;
/* ── Applied tokens ── */
--color-text: var(--color-neutral-900);
--color-text-muted: var(--color-neutral-500);
--color-bg: #FFFFFF;
--color-bg-muted: var(--color-neutral-50);
--color-border: var(--color-neutral-200);
}
Dark mode
@media (prefers-color-scheme: dark) {
:root {
--color-text: var(--color-neutral-100);
--color-text-muted: var(--color-neutral-400);
--color-bg: var(--color-neutral-900);
--color-bg-muted: var(--color-neutral-800);
--color-border: var(--color-neutral-700);
}
}
/* Manual toggle */
[data-theme="dark"] {
--color-text: var(--color-neutral-100);
--color-bg: var(--color-neutral-900);
/* ... */
}
AI-assisted palette work (MCP)
Extract palette from an image
Use analyze_image (MCP) to identify dominant colors, color mood, and palette composition from any image:
analyze_image with prompt: "Extract the dominant color palette from this
image. List hex values for primary, secondary, accent, and neutral colors."
Generate mood boards
Use the Gemini image tool in your tool list (agent-prefixed or bare) to create color palette swatches and mood boards:
prompt: "A warm, earthy brand palette for an organic coffee company —
rich browns, cream, sage green accent, modern and minimal.
Display as organized color swatches with hex labels."
Color psychology quick reference
| Color |
Associations |
Best For |
| Blue |
Trust, stability, professionalism |
Finance, tech, healthcare |
| Green |
Growth, nature, health |
Wellness, environment, education |
| Red |
Energy, urgency, passion |
Food, entertainment, sales |
| Purple |
Luxury, creativity, wisdom |
Beauty, spirituality, premium |
| Orange |
Friendly, confident, warm |
E-commerce CTAs, youth brands |
| Yellow |
Optimism, clarity, warmth |
Children, creativity, warnings |
| Black |
Sophistication, power, elegance |
Luxury, fashion, tech |
| White |
Clean, minimal, pure |
Healthcare, minimalism, modern |
Critical rules
- 60-30-10 rule — 60% dominant (backgrounds), 30% secondary (UI elements), 10% accent (CTAs).
- Test contrast for ALL text — especially muted/secondary text, which often fails.
- Don't rely on color alone — use icons, underlines, or patterns for colorblind users.
- Define neutral scale first — a good gray scale (8–10 steps) is more important than brand colors.
- Use HSL for programmatic manipulation —
hsl(var(--hue), 80%, 50%) makes theming trivial.
- Extract palettes with AI — use
analyze_image (MCP) to pull color schemes from reference images.
Common mistakes
/* WRONG — hardcoded colors everywhere */
.button { background: #2563EB; color: white; }
.card { border: 1px solid #E5E5E5; background: white; }
/* RIGHT — design tokens */
.button { background: var(--color-primary); color: var(--color-bg); }
.card { border: 1px solid var(--color-border); background: var(--color-bg); }
/* WRONG — low contrast muted text */
.caption { color: #CCCCCC; } /* 1.6:1 on white — fails AA */
/* RIGHT — accessible muted text */
.caption { color: var(--color-text-muted); } /* from token system */
What This Skill Does NOT Cover
- Logo design and brand mark creation — use
design-brand-kit.
- Font selection and typography pairing — use
design-typography.
- Full brand guideline document generation — use
design-document-generation.
- Image generation or editing — use
design-image-generation.
- WordPress theme development or block styling — use
wp-plugin-architecture.
- Social media content creation — use
design-social-content.
- UI component library building (React/Vue components) — this skill is CSS-focused; component frameworks are out of scope.
Cross-references
- Run
design-brand-kit to define the full brand identity including colors.
- Run
design-typography to pair fonts with the color palette.
- Run
design-image-generation to create visuals using the brand palette — check your tool list for the Gemini image tool.
- Run
wp-plugin-options-storage to store color tokens in WordPress settings.
- Run
mcp-ai-wpoos-plugin for remote_wp_connection — push color palettes from Hub to spoke sites.
References
1---2type: Skill3name: design-color-systems4description: Produces accessible color palettes and CSS design-token implementations for brands and websites. Use when the task asks for "color palette", "brand colors", "color scheme", "WCAG contrast", "dark mode colors", "design tokens", or "CSS custom properties for colors". Covers color theory, WCAG 2.2 contrast compliance, dark mode, AI palette extraction, and color psychology.5license: Proprietary. See LICENSE.txt6metadata:7 source: https://skillmd.com/skills/nvdigitalsolutions/design-color-systems8 type: Skill9---1011# Color Systems1213Use this skill when designing or reviewing color palettes, implementing them in code, or ensuring accessibility compliance.1415## MCP Tool Discovery1617The plugin provides visual analysis tools usable across agent contexts:1819| Color Task | Tool Name Pattern |20|---|---|21| Extract palettes from images | `analyze_image` — query for dominant colors |22| Generate palette swatches | `nv_oos_*_agent_generate_gemini_image_validated` or bare |23| Web search for color trends | `nv_oos_*_agent_web_search_validated` or bare |24| Cross-site color sync | `remote_wp_connection` — push brand colors to spoke sites |2526## WP-CLI Commands2728Key `mcp-ai` WP-CLI commands for design workflows. Run via `terminal`:2930| Command | Use for |31|---|---|32| `wp mcp-ai health` | Verify tool and provider availability |33| `wp mcp-ai provider` | Check configured AI providers |3435## When to use this skill3637Trigger when ANY of the following is true:3839- Creating a new color palette for a brand, website, or design project.40- Implementing color tokens / design tokens in CSS.41- Auditing color contrast for WCAG compliance.42- Adding dark mode or multiple theme support.43- Extracting colors from images or generating complementary palettes.44- The task mentions "color scheme", "palette", "brand colors", or "accessibility contrast".4546## Color theory foundations4748### Color relationships4950```51Primary → Main brand color (60% usage)52Secondary → Complementary accent (30% usage)53Accent → CTAs, highlights (10% usage)54Neutral → Text, backgrounds, borders55Semantic → Success (green), Error (red), Warning (amber), Info (blue)56```5758### Palette types5960| Type | Structure | Example |61|---|---|---|62| **Monochromatic** | One hue, varying saturation/lightness | Spotify green ecosystem |63| **Analogous** | 2-3 adjacent hues on color wheel | Calm, cohesive brands (wellness, nature) |64| **Complementary** | Opposite hues (blue + orange) | High contrast, energetic (sports, entertainment) |65| **Triadic** | 3 evenly spaced hues | Vibrant, balanced (education, family) |66| **Neutral + Pop** | Grays + one bold accent | Modern, sophisticated (tech, luxury) |6768## WCAG contrast requirements6970| Level | Normal Text | Large Text (18px+ bold or 24px+) | UI Components |71|---|---|---|---|72| **AA (minimum)** | 4.5:1 | 3:1 | 3:1 |73| **AAA (enhanced)** | 7:1 | 4.5:1 | 3:1 |7475**Test contrast**: <https://webaim.org/resources/contrastchecker/>7677### Common failing combinations7879```80❌ #CCCCCC text on #FFFFFF — 1.6:1 (fail AA)81✅ #767676 text on #FFFFFF — 4.5:1 (pass AA)8283❌ #999999 text on #FFFFFF — 2.85:1 (fail AA large text threshold)84✅ #595959 text on #FFFFFF — 7:1 (pass AAA)85```8687## CSS custom properties implementation8889### Design tokens9091```css92:root {93 /* ── Brand palette ── */94 --color-primary: #2563EB;95 --color-primary-light: #3B82F6;96 --color-primary-dark: #1D4ED8;9798 --color-secondary: #7C3AED;99 --color-accent: #F59E0B;100101 /* ── Neutrals ── */102 --color-neutral-50: #FAFAFA;103 --color-neutral-100: #F5F5F5;104 --color-neutral-200: #E5E5E5;105 --color-neutral-300: #D4D4D4;106 --color-neutral-400: #A3A3A3;107 --color-neutral-500: #737373;108 --color-neutral-600: #525252;109 --color-neutral-700: #404040;110 --color-neutral-800: #262626;111 --color-neutral-900: #171717;112113 /* ── Semantic ── */114 --color-success: #16A34A;115 --color-warning: #D97706;116 --color-error: #DC2626;117 --color-info: #2563EB;118119 /* ── Applied tokens ── */120 --color-text: var(--color-neutral-900);121 --color-text-muted: var(--color-neutral-500);122 --color-bg: #FFFFFF;123 --color-bg-muted: var(--color-neutral-50);124 --color-border: var(--color-neutral-200);125}126```127128### Dark mode129130```css131@media (prefers-color-scheme: dark) {132 :root {133 --color-text: var(--color-neutral-100);134 --color-text-muted: var(--color-neutral-400);135 --color-bg: var(--color-neutral-900);136 --color-bg-muted: var(--color-neutral-800);137 --color-border: var(--color-neutral-700);138 }139}140141/* Manual toggle */142[data-theme="dark"] {143 --color-text: var(--color-neutral-100);144 --color-bg: var(--color-neutral-900);145 /* ... */146}147```148149## AI-assisted palette work (MCP)150151### Extract palette from an image152153Use `analyze_image` (MCP) to identify dominant colors, color mood, and palette composition from any image:154155```156analyze_image with prompt: "Extract the dominant color palette from this157image. List hex values for primary, secondary, accent, and neutral colors."158```159160### Generate mood boards161162Use the Gemini image tool in your tool list (agent-prefixed or bare) to create color palette swatches and mood boards:163164```165prompt: "A warm, earthy brand palette for an organic coffee company —166 rich browns, cream, sage green accent, modern and minimal.167 Display as organized color swatches with hex labels."168```169170## Color psychology quick reference171172| Color | Associations | Best For |173|---|---|---|174| **Blue** | Trust, stability, professionalism | Finance, tech, healthcare |175| **Green** | Growth, nature, health | Wellness, environment, education |176| **Red** | Energy, urgency, passion | Food, entertainment, sales |177| **Purple** | Luxury, creativity, wisdom | Beauty, spirituality, premium |178| **Orange** | Friendly, confident, warm | E-commerce CTAs, youth brands |179| **Yellow** | Optimism, clarity, warmth | Children, creativity, warnings |180| **Black** | Sophistication, power, elegance | Luxury, fashion, tech |181| **White** | Clean, minimal, pure | Healthcare, minimalism, modern |182183## Critical rules184185- **60-30-10 rule** — 60% dominant (backgrounds), 30% secondary (UI elements), 10% accent (CTAs).186- **Test contrast for ALL text** — especially muted/secondary text, which often fails.187- **Don't rely on color alone** — use icons, underlines, or patterns for colorblind users.188- **Define neutral scale first** — a good gray scale (8–10 steps) is more important than brand colors.189- **Use HSL for programmatic manipulation** — `hsl(var(--hue), 80%, 50%)` makes theming trivial.190- **Extract palettes with AI** — use `analyze_image` (MCP) to pull color schemes from reference images.191192## Common mistakes193194```css195/* WRONG — hardcoded colors everywhere */196.button { background: #2563EB; color: white; }197.card { border: 1px solid #E5E5E5; background: white; }198199/* RIGHT — design tokens */200.button { background: var(--color-primary); color: var(--color-bg); }201.card { border: 1px solid var(--color-border); background: var(--color-bg); }202203/* WRONG — low contrast muted text */204.caption { color: #CCCCCC; } /* 1.6:1 on white — fails AA */205206/* RIGHT — accessible muted text */207.caption { color: var(--color-text-muted); } /* from token system */208```209210## What This Skill Does NOT Cover211212- **Logo design and brand mark creation** — use **`design-brand-kit`**.213- **Font selection and typography pairing** — use **`design-typography`**.214- **Full brand guideline document generation** — use **`design-document-generation`**.215- **Image generation or editing** — use **`design-image-generation`**.216- **WordPress theme development or block styling** — use **`wp-plugin-architecture`**.217- **Social media content creation** — use **`design-social-content`**.218- **UI component library building (React/Vue components)** — this skill is CSS-focused; component frameworks are out of scope.219220## Cross-references221222- Run **`design-brand-kit`** to define the full brand identity including colors.223- Run **`design-typography`** to pair fonts with the color palette.224- Run **`design-image-generation`** to create visuals using the brand palette — check your tool list for the Gemini image tool.225- Run **`wp-plugin-options-storage`** to store color tokens in WordPress settings.226- Run **`mcp-ai-wpoos-plugin`** for `remote_wp_connection` — push color palettes from Hub to spoke sites.227228## References229230- WCAG 2.2 contrast: <https://www.w3.org/TR/WCAG22/#contrast-minimum>231- WebAIM contrast checker: <https://webaim.org/resources/contrastchecker/>232- Coolors palette generator: <https://coolors.co/>233- Adobe Color: <https://color.adobe.com/>234- OKLCH color space (modern CSS): <https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/oklch>