Communitygithub.com

coastdigitalgroup/coastai-skills

Entwerfen und implementieren Sie ein systematisches Framework für Diagramme und Grafiken, das visuelle Hierarchie, barrierefreie Farbtheorie und responsives Verhalten verwaltet, um komplexe Daten in umsetzbare Erkenntnisse zu verwandeln.

Was ist coastai-skills?

Das Data Visualization System bietet eine methodische Anleitung zur Erstellung von Diagrammen und Grafiken, die über die Darstellung einzelner Metriken hinausgeht. Es stellt sicher, dass quantitative Beziehungen wie Trends im Zeitverlauf, Kategorienvergleiche oder Werteverteilungen klar, genau und barrierefrei kommuniziert werden. Das System definiert Regeln für Diagrammauswahl, optische Normalisierung, barrierefreie Farbcodierung und responsives Verhalten, um „visuelles Rauschen“ und kognitive Überlastung zu vermeiden. Es unterstützt gängige UI-Plattformen und Frameworks und ist besonders geeignet für SaaS-Dashboards, Finanzberichte, Analyseplattformen und Impact-Reports. Der Workflow führt Schritt für Schritt von der Identifikation des Kommunikationsziels über die Diagrammauswahl und -normalisierung bis hin zur barrierefreien Gestaltung und responsiven Anpassung, mit klaren Entscheidungsregeln und Validierungskriterien für eine konsistente, hochwertige Datenvisualisierung.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

System zur Datenvisualisierung

Zweck

Das System zur Datenvisualisierung bietet eine Methodik zum Entwerfen von Diagrammen und Grafiken, die über die Ebene einzelner Metriken hinausgeht. Es stellt sicher, dass quantitative Beziehungen – wie Trends im Zeitverlauf, Vergleiche zwischen Kategorien und Verteilungen von Werten – klar, genau und barrierefrei kommuniziert werden. Dieses System verhindert „visuelles Rauschen“ und kognitive Überlastung, indem es Regeln für Diagrammauswahl, optische Normalisierung, barrierefreie Farbcodierung und responsives Reflow festlegt.

Anwendungsfälle

  • SaaS-Dashboards: Visualisierung von Nutzerwachstum, Umsatztrends oder Systemleistung.
  • Finanzberichte: Darstellung von Portfolioverteilungen, Ausgabenkategorien oder Marktschwankungen.
  • Analyseplattformen: Anzeige von Traffic-Quellen, Conversion-Funnels oder Verhaltens-Kohorten.
  • Impact- & Nachhaltigkeitsberichte: Visualisierung von Umweltkennzahlen oder sozialen Auswirkungen im Zeitverlauf.
  • Gesundheits- & Fitness-Apps: Verfolgung von Vitalwerten, Aktivitätsniveaus oder Fortschritten bei Zielen.

Wann NICHT zu verwenden

  • Einzelne, hochwirksame Zahlen: Für isolierte KPIs (z. B. „Gesamtumsatz: 10.000€“) verwenden Sie metric-and-statistic-system.
  • Rohe Mehrattribut-Daten: Wenn der Benutzer spezifische Werte für 20+ Elemente über mehrere Spalten hinweg lesen muss, verwenden Sie data-table-ui-system.
  • Rein dekorative Infografiken: Wenn das Ziel künstlerischer Ausdruck oder narrative Geschichtenerzählung mit nicht-dynamischen, nicht-datengetriebenen Grafiken ist.
  • Schritt-für-Schritt-Status: Für lineare Prozesse (z. B. „Schritt 2 von 4“) verwenden Sie step-progress-system.

Eingaben

  1. Benutzerziel: Was versucht der Benutzer zu verstehen? (Vergleich, Trend, Verteilung oder Teil-vom-Ganzen).
  2. Datentyp: Sind die Daten kategorisch (z. B. „Browsertyp“), temporal (z. B. „Umsatz nach Monat“) oder quantitativ (z. B. „Preis vs. Qualität“)?
  3. Kardinalität: Wie viele Elemente oder Serien müssen gleichzeitig angezeigt werden?
  4. Gerätebeschränkungen: Ziel-Viewports und Interaktionsmodi (Touch vs. Maus).
  5. Marken-Tokens: Palette, Typografie und Abstände aus dem übergeordneten Designsystem.

Ausgaben

  1. Diagrammauswahl-Map: Der gewählte Diagrammtyp (Linie, Balken, Kreis, Streuung) basierend auf Ziel und Daten.
  2. Barrierefreies Farbschema: Eine Palette, die für Benutzer mit Farbblindheit (Protanopie, Deuteranopie, Tritanopie) unterscheidbar bleibt.
  3. Anatomie- und Beschriftungsspezifikation: Regeln für Achsentitel, Legenden, Tooltips und Datenmarkierungen.
  4. Responsive Übergangs-Map: Wie sich das Diagramm von Desktop zu Mobilgerät anpasst (z. B. Ausrichtungswechsel, Datenvereinfachung).

Arbeitsablauf

1. Kommunikationsziel identifizieren

Bevor Sie ein Diagramm auswählen, definieren Sie, was die Daten „aussagen“ sollen:

  • Trend im Zeitverlauf: Verwenden Sie ein Liniendiagramm oder Flächendiagramm.
  • Vergleich von Kategorien: Verwenden Sie ein Balkendiagramm (vertikal oder horizontal).
  • Teil-vom-Ganzen-Beziehung: Verwenden Sie ein Donut-Diagramm oder eine Baumkarte (Vermeiden Sie Standard-Kreisdiagramme für >3 Kategorien).
  • Korrelation/Verteilung: Verwenden Sie ein Streudiagramm oder Histogramm.

2. Diagrammtyp auswählen und normalisieren

Wenden Sie die „Wahrheit in Daten“-Regeln an, um Genauigkeit zu gewährleisten:

  • Die Null-Baseline-Regel: Balkendiagramme MÜSSEN auf der Werteachse bei einer Null-Baseline beginnen, um Übertreibungen von Unterschieden zu vermeiden.
  • Die „Seitenverhältnis“-Regel: Für Liniendiagramme ein ausgewogenes Seitenverhältnis beibehalten (normalerweise 2:1 oder 3:2), damit Steigungen nicht künstlich verstärkt oder abgeflacht werden.
  • Minimalistische Geometrie: Entfernen Sie nicht wesentliches „Diagramm-Junk“ wie 3D-Effekte, schwere Gitterlinien oder Schatten, die keine Daten vermitteln.

3. Visuelle Hierarchie und Beschriftung festlegen

Wenden Sie visual-hierarchy-system auf die Diagrammkomponenten an:

  • Direkte Beschriftung: Beschriften Sie Datenreihen wann immer möglich direkt neben den Linien/Balken, anstatt eine separate Legende zu verwenden, um Augenermüdung zu reduzieren.
  • Hervorhebung: Verwenden Sie eine kontrastreiche Farbe für die „Aktuelle“ oder „Ziel“-Datenreihe und gedämpfte Neutrale für historische oder Benchmark-Daten.
  • Hierarchie des Kontexts: Achsentitel sollten vorhanden, aber untergeordnet sein (kleiner/heller) im Vergleich zu den Primärdaten und dem Diagrammtitel.

4. Barrierefreie Farben und Muster anwenden

Stellen Sie sicher, dass die Daten von jedem wahrgenommen werden können:

  • Farbenblinde-sichere Paletten: Verwenden Sie unterschiedliche Farbtöne und variierende Helligkeitsstufen. Vermeiden Sie es, nur Rot und Grün zu paaren, um „Schlecht“ vs. „Gut“ anzuzeigen; verwenden Sie Rot/Blau oder fügen Sie Symbole/Symbole hinzu.
  • Redundante Kodierung: Verwenden Sie mehr als nur Farbe. Fügen Sie gestrichelte Linien, unterschiedliche Markierungsformen (Kreise, Quadrate, Dreiecke) oder unterschiedliche Muster/Texturen hinzu, um Serien zu unterscheiden.
  • Kontrast: Stellen Sie sicher, dass der gesamte Text (Beschriftungen, Achsen) den WCAG-AA-Kontrast (4,5:1) gegenüber dem Hintergrund erfüllt.

5. Für Interaktion und Responsivität entwerfen

  • Progressive Offenlegung: Verwenden Sie Tooltips, um bei Hover/Berührung genaue Werte anzuzeigen, sodass das Diagramm sauber und überfliegbar bleibt.
  • Responsives Reflow:
    • Horizontal zu Vertikal: Ein breites vertikales Balkendiagramm auf dem Desktop sollte auf Mobilgeräten zu einem horizontalen Balkendiagramm wechseln, um horizontales Scrollen zu vermeiden.
    • Datenreduzierung: Reduzieren Sie auf Mobilgeräten die Anzahl der X-Achsen-Beschriftungen (z. B. jeden zweiten Monat anzeigen) oder aggregieren Sie Datenpunkte.
    • Seitenverhältnis-Sperrung: Stellen Sie sicher, dass das Diagramm seine Lesbarkeit behält; verwenden Sie aspect-ratio in CSS, um Platz zu reservieren und CLS zu verhindern.

Entscheidungsregeln

  • Die „Kein Kreis“-Regel: Vermeiden Sie Kreis-/Donut-Diagramme, wenn Sie mehr als 5 Kategorien haben oder wenn die Unterschiede zwischen den Kategorien gering sind. Verwenden Sie stattdessen ein horizontales Balkendiagramm.
  • Beschriftung vor Legenden: Wenn eine Legende benötigt wird, platzieren Sie sie so nah wie möglich an den Daten (z. B. über dem Diagramm oder rechtsbündig), anstatt ganz unten.
  • Monochromatischer Erfolg: Ein gutes Diagramm sollte auch beim Drucken in Graustufen verständlich sein. Ist dies nicht der Fall, sind die Farbwahl oder Markierungen zu stark von der Farbe allein abhängig.
  • Präzision vs. Überfliegen: Runden Sie Werte auf Dashboards (z. B. 1,2 Mio. statt 1.242.301) für sofortiges Überfliegen. Behalten Sie die hohe Präzision für die Tooltips bei.

Einschränkungen

  • Barrierefreiheit: Diagramme müssen eine begleitende Datentabelle oder eine beschreibende aria-label haben, die die wichtigste Erkenntnis zusammenfasst. Verwenden Sie role="graphics-document" oder role="img" mit einer aria-label. Stellen Sie sicher, dass alle interaktiven Elemente (Markierungen) die Mindestzielgröße von 24x24 Pixel erfüllen.
  • Responsivität: Diagramme dürfen niemals eine feste Pixelbreite haben; sie müssen fließend sein. Verwenden Sie für komplexe SVG-Diagramme viewBox zur Skalierung.
  • Hierarchie: Der Titel des Diagramms sollte der markanteste Text sein, gefolgt von den Daten selbst.

Häufige Fehlermuster

  • Kreisdiagramm-Überlastung: 10 Segmente in einem Kreisdiagramm darzustellen, macht die kleineren unmöglich zu unterscheiden.
  • Die abgeschnittene Achse: Ein Balkendiagramm bei einem Wert ungleich Null beginnen zu lassen, um einen kleinen Unterschied riesig erscheinen zu lassen (täuschendes Design).
  • Nur-Farben-Abhängigkeit: 5 Linien in einem Liniendiagramm nur durch ähnliche Blautöne zu unterscheiden, macht es für farbenblinde Benutzer unzugänglich.
  • Legendenermüdung: Den Benutzer zu zwingen, zehnmal zwischen einem Farbschlüssel und den Daten hin- und herzusehen, um das Diagramm zu verstehen.
  • Überlaufende Mobil-Diagramme: Den Diagrammtyp oder die Beschriftung nicht für Mobilgeräte anzupassen, was zu winzigem, unleserlichem Text oder kaputten Layouts führt.

Validierungskriterien

  • Die Auswahl des Diagrammtyps entspricht dem Kommunikationsziel (z. B. Linie für Trend).
  • Balkendiagramme beginnen bei einer Null-Baseline.
  • Die Farbpalette ist farbenblindsicher und verwendet redundante Kodierung (Markierungen/Muster).
  • Direkte Beschriftung wird verwendet, wo der Platz es zulässt; Legenden werden in unmittelbarer Nähe platziert.
  • Das Diagramm ist fließend und passt sich korrekt an Mobilgeräte an (z. B. horizontales Reflow).
  • Barrierefreiheit: aria-label bietet eine Zusammenfassung der Daten/Erkenntnisse.
  • Interaktion: Tooltips liefern präzise Daten bei Hover/Berührung.
  • Der gesamte Text erfüllt den WCAG-AA-Kontrast (4,5:1).

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 progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

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 implement a systematic color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

Verwandte Skills