Communitygithub.com

coastdigitalgroup/coastai-skills

Entwerfen und implementieren Sie ein systematisches Farbpalette, das die WCAG 2.2-Konformität für Barrierefreiheit gewährleistet. Verwenden Sie diesen Skill, wenn Sie gebeten werden, Markenfarben zu definieren, UI-Themen zu erstellen oder ein visuelles System für eine Website zu etablieren.

Was ist coastai-skills?

Der Skill 'Accessible Color System' von Coast Digital Group bietet eine methodische Vorgehensweise zur Erstellung von Farbpaletten, die sowohl visuell kohärent als auch funktional barrierefrei sind. Er geht über ästhetische Farbauswahl hinaus und führt ein strukturiertes System aus Farbskalen, kontrastsicheren Paarungen und semantischer Anwendung ein, das sicherstellt, dass Inhalte von allen Nutzern, einschließlich solcher mit Sehbehinderungen, wahrgenommen werden können. Unterstützte Plattformen sind alle Webentwicklungsprojekte, die CSS Custom Properties verwenden, und er ist besonders nützlich für die Etablierung neuer Markenfarben, die Überprüfung bestehender Websites auf Farbkontraste sowie die Gestaltung von Dark-/Light-Mode-Themen. Der Skill legt klare Entscheidungsregeln fest, wie die Lesbarkeit vor der Ästhetik zu priorisieren ist, und vermeidet häufige Fehlermuster wie unzureichenden Kontrast oder zu viele Farben. Die Ausgabe umfasst tonale Skalen, eine Kontrastmatrix, semantische Zuordnungen und direkt einsetzbare CSS-Custom-Properties, die auf WCAG 2.2 AA (oder AAA) getestet sind.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/accessible-color-system

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Barrierefreies Farbsystem

Zweck

Der Skill "Barrierefreies Farbsystem" bietet eine Methode zur Erstellung von Farbpaletten, die visuell kohärent und funktional barrierefrei sind. Er geht über ästhetische Farbauswahl hinaus zu einem strukturierten System aus Skalen, kontrastsicheren Paarungen und semantischer Anwendung und stellt sicher, dass Inhalte von allen Nutzern, einschließlich solcher mit Sehbehinderungen, wahrgenommen werden können.

Anwendungsfälle

  • Etablieren einer digitalen Farbpräsenz für eine neue Marke.
  • Überprüfen und Beheben von Barrierefreiheitsproblemen einer bestehenden Website in Bezug auf Farbe.
  • Gestalten von Dark-/Light-Mode-Themen.
  • Definieren semantischer Farben für Rückmeldungen (Erfolg, Fehler, Warnung).

Wann NICHT zu verwenden

  • Kunstopferte Erlebnisse: Wenn Farbe rein expressiv ist und keine funktionalen Informationen trägt (Barrierefreiheit wird dennoch empfohlen).
  • Festverdrahtete Legacy-Apps: Wenn die technische Schuld die Implementierung eines Variablensystems unmöglich macht (konzentrieren Sie sich auf punktuelle Korrekturen).
  • Rein dekorative Elemente: Elemente wie Hintergrundmuster, die keinen Text oder interaktive Komponenten enthalten (WCAG 1.4.3 ist hier nicht anwendbar).

Eingaben

Zum Erstellen eines barrierefreien Farbsystems benötigen Sie:

  1. Primäre Markenfarbe: Die Kernfarbe, die die Marke identifiziert (z. B. #0055FF).
  2. Neutrale Basis: Ein Ausgangspunkt für Graustufen/Schwarztöne (z. B. #1A1A1A oder ein getönter Neutralton).
  3. Barrierefreiheitsziel: WCAG-Level AA (Standard) oder AAA (erweitert).
  4. Nutzungskontext: Handelt es sich um ein Dashboard mit hoher Dichte, eine Marketing-Landingpage oder eine Utility-first-Anwendung?

Ausgaben

  1. Farbskalen: Tonale Paletten für Primär-, Sekundär-, Neutral- und Semantikfarben (normalerweise 10-stufige Skalen).
  2. Kontrastmatrix: Eine Übersicht, welche Vordergrundfarben auf welchen Hintergrundfarben sicher verwendet werden können.
  3. Semantische Zuordnung: Definierte Rollen für Farben (z. B. --color-action-primary, --color-surface-muted).
  4. CSS-Custom-Properties: Ein produktionsreifer Block aus CSS-Variablen, optional mit color-mix(), um Hover-/Active-Töne aus einem einzigen Basistoken abzuleiten, anstatt jeden Zustand manuell auszuwählen.

Arbeitsablauf

1. Tonalen Skalen erstellen

Erweitern Sie die Basisfarben zu Skalen (z. B. 50 bis 900). Verwenden Sie ein Werkzeug oder eine Formel, die konsistente Helligkeitsschritte beibehält. Das Arbeiten im OKLCH-Farbraum (statt HSL) führt zu wahrnehmungsmäßig gleichmäßigeren Helligkeitsschritten über Farbtöne hinweg, was die Vorhersage von Kontrasten vor dem Testen erleichtert. Tipp: Stellen Sie sicher, dass Ihre Primärfarbe 500 oder 600 die "Marken"-Version ist.

2. Neutrale Farben definieren

Erstellen Sie eine neutrale Skala. Erwägen Sie, die Neutraltöne mit einem kleinen Anteil der Primärfarbe (z. B. 2–5 %) zu "tönen", um ein kohärentes Erscheinungsbild zu erzielen.

3. Semantische Rollen festlegen

Weisen Sie Farben funktionalen Rollen zu:

  • Aktion: Primärfarbe für Schaltflächen, Links und aktive Zustände.
  • Oberfläche: Hintergründe, Karten und Trennlinien (Neutraltöne).
  • Inhalt: Text und Symbole (hochkontrastreiche Neutraltöne).
  • Status: Erfolg (Grün), Warnung (Gelb/Orange), Fehler (Rot), Info (Blau).

4. Kontrastvalidierung durchführen

Testen Sie Paarungen mit WCAG-Formeln (1.4.3, 1.4.11):

  • Normaler Text: 4,5:1 für AA, 7:1 für AAA.
  • Großer Text (>18pt): 3:1 für AA, 4,5:1 für AAA.
  • UI-Komponenten/Symbole: 3:1 für AA (Nicht-Text-Kontrast, 1.4.11).
  • Fokusindikatoren: 3:1 gegenüber angrenzenden Farben, und der Indikator darf nicht von sticky Headern oder anderen Inhalten verdeckt werden (WCAG 2.2 SC 2.4.11, Focus Not Obscured).

5. Paarungsregeln erstellen

Dokumentieren Sie, welche Textfarben auf welchen Hintergründen verwendet werden können. Beispiel: Weißer Text (#FFFFFF) ist nur auf Primärfarbe 600 oder höher sicher.

Entscheidungsregeln

  • Lesbarkeit zuerst: Funktion (Lesbarkeit) überschreibt immer die Ästhetik. Wenn eine Markenfarbe für Text zu hell ist, verwenden Sie eine dunklere Variante für den Text, während Sie die Markenfarbe für dekorative Elemente beibehalten.
  • Farbe nicht allein verwenden: Verlassen Sie sich niemals ausschließlich auf Farbe, um Informationen zu vermitteln (z. B. fügen Sie eine Fehlermeldung ein Symbol oder eine Textbeschriftung hinzu).
  • Konsistente Helligkeit: Halten Sie die Helligkeitswerte über verschiedene Farbtöne auf derselben Skalenstufe ähnlich (z. B. sollten Rot 500 und Blau 500 eine ähnliche wahrgenommene Helligkeit haben).

Einschränkungen

  • Responsivität: Farben müssen den Kontrast auf mobilen Bildschirmen beibehalten, wo Blendung oder Displays mit geringer Qualität die Sichtbarkeit beeinträchtigen könnten.
  • Barrierefreiheit: Muss mindestens den WCAG 2.2 AA-Standards für alle funktionalen Elemente entsprechen, einschließlich der Anforderung 2.4.11, dass Fokusindikatoren sichtbar und unverdeckt bleiben.
  • Hierarchie: Verwenden Sie Farbsättigung und -kontrast, um das Auge zu führen; wichtigere Elemente (CTAs) sollten ein höheres visuelles Gewicht haben.

Häufige Fehlermuster

  • Unzureichender Kontrast: Verwendung von hellem grauem Text auf weißem Hintergrund oder weißem Text auf einer hellen Markenfarbe.
  • Vibrierende Farben: Kombination von stark gesättigten Farben (wie Rot und Grün), die visuelle Anstrengung verursachen.
  • Zu viele Farben: Erzeugen eines "Regenbogen"-Effekts, der die Markenidentität verwässert und die Hierarchie verwirrt.
  • Semantischer Missbrauch: Verwendung von "Fehler-Rot" für ein dekoratives Element, was zu Nutzerängsten führt.

Validierungskriterien

  • Jedes funktionale Textelement hat ein Kontrastverhältnis von mindestens 4,5:1 gegenüber seinem Hintergrund.
  • UI-Komponenten (Rahmen, Symbole) haben mindestens 3:1-Kontrast.
  • Das System enthält eine klare Skala für Primär- und Neutralfarben.
  • Informationen werden niemals ausschließlich durch Farbe vermittelt.
  • Das System wird mittels CSS-Custom-Properties für die Portabilität dokumentiert.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for non-overlay notifications, managing global announcements and contextual inline alerts to communicate system states without interrupting the user's flow.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for secondary navigation trails that provide orientation, context, and one-click access to parent levels in deep information architectures.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for threaded conversations, managing nesting depths, action hierarchies, and community signaling to foster engagement and readability.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and specify a systematic dark theme framework, establishing rules for elevation-based surface colors, desaturated brand accents, text legibility, and media adaptation to ensure an accessible, low-fatigue experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

Verwandte Skills