Communitygithub.com

Metrik- und Statistiksystem

Ein systematischer Rahmen für die Darstellung hochwirksamer quantitativer Daten, der numerische Klarheit, Trendkontext und visuelle Hierarchie für KPIs und soziale Beweise sicherstellt.

Was ist Metrik- und Statistiksystem?

Dieses Skill beschreibt ein systematisches Framework zur Visualisierung quantitativer Daten, das über die bloße Anzeige einer Zahl hinausgeht. Es definiert Regeln für numerische Hierarchie, Trendvisualisierung und semantische Farbgebung, sodass Benutzer die Bedeutung eines Werts (z. B. „Ist 42 % gut oder schlecht?“) ohne tiefgehende Analyse erfassen können. Das System ist ideal für SaaS-Dashboards, Marketing-Social-Proof, Gesundheits- und Überwachungsdashboards sowie persönliche Analysen und E-Commerce. Es unterstützt die Plattformen Claude Code, Cursor und Codex und stellt sicher, dass Metriken stets mit Kontext (Trend, Vergleichszeitraum) und klaren visuellen Hierarchien dargestellt werden. Der Skill enthält detaillierte Workflows (Kategorisierung, Typografie, räumliche Rhythmen, Ladezustände), Entscheidungsregeln (z. B. „Gut/Schlecht“-Regel, Rundungslogik) und Validierungskriterien zur Sicherstellung von Zugänglichkeit, Konsistenz und Lesbarkeit.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Metrik- und Statistiksystem?

Zweck

Das Metrik- und Statistiksystem bietet eine Methodik zur Visualisierung quantitativer Daten, die sofort verständlich und kontextuell relevant ist. Es geht über das bloße „Anzeigen einer Zahl“ hinaus, indem es Regeln für numerische Hierarchie, Trendvisualisierung und semantische Farbgebung festlegt. Dadurch können Benutzer die Bedeutung eines Wertes (z. B. „Ist 42 % gut oder schlecht?“) ohne tiefgehende Analyse erfassen.

Anwendungsfälle

  • SaaS-Dashboards: Anzeige von Key Performance Indicators (KPIs) wie MRR, Churn oder aktive Benutzer.
  • Marketing-Social-Proof: Präsentation von „Auf einen Blick“-Abschnitten (z. B. „10.000+ Kunden“, „99,9 % Verfügbarkeit“).
  • Gesundheits- und Überwachungsdashboards: Visualisierung von Systemleistung, Fehlerraten oder Ressourcennutzung.
  • Persönliche Analysen: Darstellung von Fortschritten bei Zielen in Fitness-, Finanz- oder Produktivitäts-Apps.
  • E-Commerce: Anzeige von Bewertungszahlen, Lagerbeständen oder „in den letzten 24 Stunden verkaufte Artikel“.

Wann NICHT zu verwenden

  • Rohdatensätze: Wenn der Benutzer 10+ Zeilen mit mehreren Attributen sortieren, filtern oder vergleichen muss, verwenden Sie das data-table-ui-system.
  • Komplexe Beziehungen: Wenn das primäre Ziel darin besteht, die Beziehung zwischen Variablen im Zeitverlauf darzustellen, verwenden Sie eine vollständige Charting-/Graphing-Bibliothek (nicht von diesem atomaren System abgedeckt).
  • Erzählerischer Inhalt: Zahlen innerhalb von Sätzen sollten der Standardtypografie folgen; dieses System ist für „Anzeige“-Metriken gedacht.
  • Wertarme Metadaten: Kleine Zählungen (wie Benachrichtigungspings) sollten das badge-and-tag-system verwenden.

Eingaben

  1. Der Wert: Die primäre Zahl oder der Prozentsatz, der angezeigt werden soll.
  2. Das Label: Eine klare, prägnante Beschreibung, was der Wert darstellt.
  3. Kontext/Trend: Vergleichsdaten (z. B. vs. letzten Monat, vs. Ziel).
  4. Einheit/Format: Währungssymbole, Prozentsätze oder Einheiten (z. B. „ms“, „GB“).
  5. Hierarchie-Priorität: Ist dies ein „Primärer KPI“ oder eine „Unterstützende Statistik“?

Ausgaben

  1. Stat-Karten-Spezifikation: Die räumliche Anordnung von Wert, Label und Trend innerhalb eines Containers.
  2. Typografieskala: Definierte Größen für „Anzeige“-Zahlen vs. Labels.
  3. Trendlogik: Visuelle Regeln für Aufwärts-, Abwärts- und Neutrale Zustände (Farbe + Symbole).
  4. Responsive-Strategie: Wie Metrikraster auf Mobilgeräten zusammenbrechen oder skaliert werden.

Arbeitsablauf

1. Kategorisieren Sie den Metriktyp

Bestimmen Sie die erforderliche visuelle „Schwerkraft“:

  • Stufe 1: Heldenmetrik. Groß, zentriert, oft ohne Rahmen. Wird für Social Proof auf oberster Ebene auf Landing Pages verwendet.
  • Stufe 2: KPI-Karte. In einer Karte enthalten, oft in einem Raster. Für Dashboard-Zusammenfassungen.
  • Stufe 3: Inline-Statistik. Kleine, hochdichte Anzeige. Wird in Kopfzeilen oder Seitenleisten verwendet.

2. Etablieren Sie die numerische Hierarchie

Wenden Sie die Regeln der „Anzeige-Typografie“ an:

  • Der Wert: Muss das größte Element sein (normalerweise 200–400 % der Körpergröße).
  • Das Label: Entweder direkt über oder unter dem Wert platziert. Verwenden Sie eine gedämpfte Farbe oder eine kleinere Schriftstärke, um sicherzustellen, dass es nicht konkurriert.
  • Die Einheit: Symbole (%, $) sollten etwas kleiner als die Zahl sein, um zu verhindern, dass sie den Fokus des Auges auf den Wert „unterbrechen“.

3. Stellen Sie Trend- und Vergleichskontext bereit

Eine Zahl ohne Kontext ist oft bedeutungslos. Fügen Sie eine „Vergleichsschicht“ hinzu:

  • Trendindikator: Verwenden Sie einen Pfeil (↑/↓) zusammen mit einer prozentualen oder absoluten Änderung.
  • Zeitraum-Label: Geben Sie immer den Vergleichszeitraum an (z. B. „vs. letzte 30 Tage“).
  • Semantische Farbgebung: Wenden Sie die Farbe auf den Trend an, nicht unbedingt auf den Wert.
    • Positiver Trend: Grün (üblich).
    • Negativer Trend: Rot (üblich).
    • Neutral: Grau.

4. Wenden Sie räumlichen Rhythmus an (Das Raster)

Metriken werden selten isoliert angezeigt. Gruppieren Sie sie mit responsive-grid-system:

  • Raster-Layout: 3 oder 4 Spalten auf dem Desktop; 1 oder 2 auf Mobilgeräten.
  • Interner Abstand: Sorgen Sie für reichlich Weißraum (--space-l oder --space-xl) um den Wert, damit er „poppt“.

5. Gestalten Sie für Lade- und Leerzustände

  • Skeleton: Verwenden Sie skeleton-state-system für den Wert und den Trend, während Daten geladen werden.
  • Nullzustände: Wenn eine Metrik 0 ist, entscheiden Sie, ob sie als „0“ oder als Gedankenstrich (—) angezeigt werden soll.

Entscheidungsregeln

  • Die „Gut/Schlecht“-Regel: Verwenden Sie Grün/Rot niemals für Trends, wenn die Metrik nicht inhärent positiv/negativ ist (z. B. sollte „Temperatur“ nicht grün sein, nur weil sie gestiegen ist). Verwenden Sie Neutral (Grau/Blau) für nicht bewertete Änderungen.
  • Rundungslogik: Für Marketing-Statistiken runden Sie auf die nächste „K“ oder „M“ für sofortiges Erfassen (z. B. „12,4K“ vs. „12.432“). Für Dashboards verwenden Sie die für die Aufgabe erforderliche Genauigkeit.
  • Symbolverwendung: Verwenden Sie Symbole nur, wenn sie helfen, zwischen verschiedenen Kategorien von Metriken zu unterscheiden (z. B. ein „Benutzer“-Symbol vs. ein „Umsatz“-Symbol). Verwenden Sie Symbole nicht nur zur Dekoration.
  • Label-Platzierung: Oben ausgerichtete Labels eignen sich besser zum Scannen eines Rasters ähnlicher Metriken; unten ausgerichtete Labels eignen sich besser für „Helden“-Statistiken, bei denen die Zahl die Hauptattraktion ist.

Einschränkungen

  • Zugänglichkeit: Verwenden Sie aria-label, um den vollständigen Kontext bereitzustellen (z. B. „Umsatz: 12.000 Euro, 5 % gestiegen im Vergleich zum Vormonat“). Stellen Sie sicher, dass der Farbkontrast für Trendindikatoren WCAG AA (4,5:1) erfüllt.
  • Responsivität: Metrikwerte dürfen niemals ihre Container überlaufen. Verwenden Sie flüssige Typografie (CSS clamp()) oder „Shrink-to-Fit“-Logik für sehr große Zahlen.
  • Konsistenz: Alle Metriken in einer Gruppe müssen die gleiche Rundung, Ausrichtung und Trenddarstellung verwenden.

Häufige Fehlermuster

  • Die „Nackte Zahl“: Anzeigen eines Werts ohne Label oder Kontext, sodass der Benutzer rät, was er bedeutet.
  • Farbüberbetonung: Nur Rot/Grün zur Angabe des Trends ohne Symbole (↑/↓), was es für farbenblinde Benutzer unzugänglich macht.
  • Hierarchie-Umkehrung: Das Label größer oder fetter als den Wert machen, was den „Scannen und Verstehen“-Prozess verlangsamt.
  • Metrik-Überfüllung: Zu viele Metriken in einer einzigen Zeile platzieren, wodurch die Zahlen ineinander übergehen.
  • Präzisionsüberladung: Anzeigen von 4 Dezimalstellen auf einer Marketing-Landing Page, was unnötige kognitive Belastung erzeugt.

Validierungskriterien

  • Jede Metrik hat ein klares, sichtbares Label.
  • Werte verwenden eine eigene „Anzeige“-Typografiegröße (größer als Fließtext).
  • Trends (Auf/Ab) werden durch SOWOHL Farbe ALS AUCH ein Symbol/Zeichen angezeigt.
  • Vergleichskontext (z. B. Zeitraum) wird explizit angegeben.
  • Semantische Farben (Grün/Rot) werden nur für bewertete Änderungen verwendet.
  • Das Raster-Layout bleibt auf Mobilgeräten lesbar (keine Überläufe).
  • Barrierefreiheit: Der vollständige Kontext ist über ARIA für Screenreader verfügbar.

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