CommunityBildgithub.com

dataviz

Verwandelt Datenzeilen in ein ehrliches Diagramm. Wählt den Diagrammtyp basierend auf der zu beantwortenden Frage, erstellt es als Inline-SVG oder CSS ohne Diagrammbibliothek und hält es lesbar: eine Akzentfarbe, dezenten Raster, monospace tabellarische Beschriftungen, eine Null-Baseline, echte Einheiten und einen Vergleichswert für jede Kennzahl.

Was ist dataviz?

Dataviz ist ein Skill für KI-Assistenten wie Claude Code oder Cursor, der aus tabellarischen Daten (CSV/JSON) ein einzelnes, aussagekräftiges Diagramm erzeugt. Der Skill orientiert sich an der Prämisse, dass ein gutes Diagramm eine präzise Frage beantwortet. Er wählt den Diagrammtyp (Linie, Balken, gestapelt, Sparkline, Fortschrittsbalken) basierend auf der Art der Frage, nicht auf Wunsch des Nutzers. Das Diagramm wird als reines Inline-SVG oder CSS ohne Abhängigkeiten oder Diagrammbibliotheken gerendert, was Ladezeit spart und Barrierefreiheit verbessert. Die Ausgabe folgt strengen Designregeln: eine einzige Akzentfarbe, ein dezenter Raster, Null-Baseline für alle flächenbasierten Diagramme, monospace tabellarische Ziffern, echte Einheiten und Vergleichswerte bei Änderungen. Der Skill eignet sich für Dashboards, Berichte, KPI-Kacheln oder jede Situation, in der Platzhalter-Diagramme durch echte ersetzt werden sollen. Er unterstützt die Ausgabe als SVG-Datei (`chart.svg`) und bietet eine Checkliste zur Qualitätssicherung.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/itsdanylol/claude-sitecraft/tree/HEAD/skills/dataviz

Installed? Explore more Bild skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht dataviz?

Ein Diagramm ist die Antwort auf eine Frage. Kannst du die Frage nicht in einem Satz formulieren, kannst du das Diagramm nicht auswählen, und ein Diagramm, das nichts beantwortet, ist Dekoration mit Zahlen.

Was gut aussieht

  • Eine Frage pro Diagramm. Der Titel ist die Frage oder ihre Antwort. „Läufe pro Monat“, nicht „Analytics“.
  • Der Typ folgt der Frage. Trend = Linie, Vergleich = Balken, Anteil = ein gestapelter Balken, ein einzelnes Ziel = Fortschrittsbalken, ein Ranking = Liste mit dünnen Balken.
  • Eine Akzentfarbe. Die relevante Sache bekommt sie. Alles andere ist neutrale Abstufung einer Farbpalette. Nie ein Regenbogen innerhalb einer Serie.
  • Null-Baseline für alles mit Fläche. Balken und gestapelte Balken beginnen immer bei Null. Eine Linie darf woanders beginnen, wenn die Abschneidung sichtbar und angegeben ist.
  • Dezente Chromatik. Raster, Achsen und Beschriftungen sind leise. Die Daten sind das Einzige, das laut ist, und nur eine Serie davon ist laut.
  • Lesbare Zahlen. Einheiten in der Beschriftung, ein Format, tabular-nums, keine nachgestellten Dezimalstellen, die über die Genauigkeit täuschen.

Ausführung

  1. Schreibe die Frage. Ein Satz: Welche Entscheidung hilft dieses Diagramm jemandem zu treffen? Wenn es „Zeige die Daten“ ist, streiche es oder mache eine Tabelle daraus.
  2. Wähle den Typ aus references/charts.md. Dort steht auch der Name des Diagramms, das richtig aussieht und falsch ist – meistens ein Donut.
  3. Forme die Zeilen. Eine Tabelle, eine Zeile pro Kategorie, eine Spalte pro Serie, Zahlen bereits in der anzuzeigenden Einheit. CSV oder JSON, nichts doppelt voraggregiert.
  4. Erstelle es.
    • Schnellpfad: node <skill folder>/scripts/chart.mjs data.csv --type line --title "Läufe pro Monat" --unit Läufe --accent "#e0a458" --out chart.svg
    • Typen: line, bar, stacked, sparkline, progress. Optionen: --width --height --theme dark|light --subtitle --xlabel --ylabel --decimals --max.
    • Es schreibt ein eigenständiges SVG mit role="img", einem <title>, einem <desc>, monospace tabellarischen Beschriftungen und einem dezenten Raster. Füge es so wie es ist in die Seite ein oder bette es inline ein, um es mit den Tokens der Seite zu gestalten.
    • Handgebaut, wenn das Diagramm in einer Komponente leben muss: Die Rezepte in references/charts.md sind reines SVG und CSS, keine Abhängigkeit.
  5. Überprüfe es anhand der Checkliste unten, in der Größe, in der es tatsächlich gesehen wird. Ein bei 720 Pixeln Breite lesbares Diagramm ist bei 280 Pixeln nicht lesbar.

Regeln, die kein Geschmack sind

  • Keine Diagrammbibliothek für ein einfaches Diagramm. Vier Balken und eine Linie sind 30 Zeilen SVG. Eine Bibliothek kostet 40 bis 120 KB, bringt Standardstyling mit, das rückgängig gemacht werden muss, und liefert meist eine Leinwand, die Screenreader nicht lesen können.
  • Kodiere nicht eine Serie in vielen Farben. Eine Akzentfarbe, eine Serie, die führt. Mehr als drei Serien in einem Diagramm bedeuten zwei Diagramme oder eine Tabelle.
  • Farbe ist nie das einzige Signal. Direkte Beschriftungen, Position oder eine Formunterscheidung. Ein Diagramm, das in Graustufen versagt, versagt bei einem von zwölf Männern.
  • Text ist echter Text. SVG <text>, keine Pfade, damit es mit den Einstellungen des Lesers skaliert. Keine in ein Bild eingebackenen Beschriftungen.
  • Respektiere den Container. viewBox plus width:100%, height:auto, ein max-width und ein min-width, wo die Beschriftungen nicht mehr passen. Weniger Ticks und weniger Balken bei 375 Pixeln Breite, kein verkleinertes Diagramm.
  • Keine falschen Daten. Wenn die Zahlen Platzhalter sind, sagt das Diagramm das neben dem Titel und der Bericht listet es auf. [benötigt: echte Laufanzahl] schlägt eine plausible Fiktion.
  • Einheiten und Vergleiche. „47 Läufe“ oder „48.210 €“, niemals „47“. Eine Änderung trägt immer den Vergleich mit: „+12 % vs. letzten Monat“.
  • Diagramme haben Hierarchie. Ein Hauptdiagramm pro Bildschirm, deutlich das größte. Ein zweites Diagramm derselben Größe bedeutet, dass keines den Punkt trifft.

Checkliste

  • Das Diagramm beantwortet eine benannte Frage, und der Titel sagt sie
  • Der Typ passt zur Frage; kein Donut, keine Torte mit sechs Stücken, kein 3D, keine doppelten Achsen
  • Balken und gestapelte Balken beginnen bei Null; jede abgeschnittene Linie sagt dies
  • Eine Akzentfarbe auf der Serie oder dem Punkt, der zählt; alles andere neutral
  • Mehr als drei Serien aufgeteilt in zwei Diagramme oder eine Tabelle
  • Raster und Achse dezent, kein Diagrammrand, kein Schlagschatten
  • Beschriftungen in Monospace, tabellarische Ziffern, ein Zahlenformat, Einheiten vorhanden
  • Legende vorhanden, wenn es mehr als eine Serie gibt, und nicht benötigt, wenn es eine gibt
  • Jede Kennzahl hat ihren Vergleich, wenn eine Änderung gezeigt wird
  • role="img", <title> und <desc> sagen, was das Diagramm zeigt, in Worten
  • Lesbar bei 375 Pixeln Breite und bei 200 Prozent Zoom; nichts abgeschnitten, keine Beschriftungskollisionen
  • Funktioniert in Graustufen; Farbe ist nicht der einzige Unterschied zwischen Serien
  • Platzhalterdaten sind in der Seite markiert und im Bericht aufgelistet
  • Die Zahlen lassen sich auf eine Quelle zurückführen, die du benennen kannst

Tabelle der Diagrammtypen, die falschen, aber üblichen Entscheidungen sowie die handgebauten SVG- und CSS-Rezepte: references/charts.md.

Individual skills in this repo

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

Verwandte Skills