color-semantic-systems

Designs semantic color tokens with role-based mapping and contrast-aware tone stops for design systems.

6|3|Updated May 3, 2026
One-click install
npx skills add https://github.com/HDeibler/universal-design-principles --skill color-semantic-systems
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: color-semantic-systems
Source: https://github.com/HDeibler/universal-design-principles/tree/main/plugins/perception-and-hierarchy-principles/skills/color-semantic-systems
Command: npx skills add https://github.com/HDeibler/universal-design-principles --skill color-semantic-systems

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Semantic color systems fail when the same color means different things across screens, causing users to misread status, category, and hierarchy cues.

Core Features & Use Cases

  • Status / state encoding: Define success, warning, error, and info meanings and map them to consistent palettes for badges, alerts, and UI feedback.
  • Category (categorical) palettes: Create distinct hues for projects, departments, product lines, or user segments with limits that preserve memorability.
  • Brand role hierarchy: Use primary, secondary, and tertiary colors to express importance (e.g., CTA emphasis vs. informational micro-emphasis).
  • Consistency and contrast rules: Enforce one color per role, prevent destructive/status drift, and use tone stops (bg, border, text) that support accessible pairings.

Quick Start

Draft a semantic color spec for your design system by listing each semantic role (success, warning, destructive, info, neutral, plus category and brand roles) and pairing background and text tones for accessible usage.

Frequently Asked Questions about color-semantic-systems

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design semantic color tokens for a design system?

To design semantic color tokens, list each semantic role (success, warning, destructive, info, neutral) and pair background and text tones for accessible usage. This role-based mapping ensures consistent UX across badges, alerts, and chart palettes.

Why does the same color mean different things across my UI screens?

Colors mean different things across UI screens due to semantic drift. Enforcing one color per role and applying anti-pattern checks for semantic drift ensures status, category, and hierarchy cues remain stable and consistent across product surfaces.

What's the best way to create accessible color palettes for status badges?

The best way to create accessible status badges is using contrast-aware tone stops for background, border, and text. Defining success, warning, error, and info meanings with consistent palettes ensures color pairings meet accessibility standards across UI feedback components.

How many distinct hues should I use for categorical data palettes?

For categorical palettes, use limited hue counts to preserve memorability. Creating distinct hues for projects, departments, or product lines with strict limits prevents visual confusion and maintains color consistency across complex data visualizations.

Can I use brand colors to express hierarchy in a design system?

Yes, you can use primary, secondary, and tertiary brand colors to express importance. This brand role hierarchy differentiates CTA emphasis from informational micro-emphasis, applying consistency and contrast rules to prevent destructive status drift.