CommunityCodierung & Entwicklunggithub.com

HTML-Ansicht

Erstellt, überprüft und exportiert eigenständige offlinefähige HTML-Dokumente, Datenberichte und UI-Entwürfe. Zeichnet SVG-Diagramme und Strukturgrafiken.

Was ist HTML-Ansicht?

Dieses Skill ermöglicht es dir, aus verschiedenen Quellen wie Markdown, CSV, JSON oder Rohdaten professionelle, offline-fähige HTML-Dokumente zu generieren. Es eignet sich für technische Konzepte, Rechercheberichte, Meeting-Protokolle, Dashboards, UI-Wireframes und klickbare Prototypen. Du kannst auch bestehende HTML-Dateien mit neuen Themes versehen, überprüfen, vergleichen, als PDF/PNG exportieren und SVG-Diagramme (z. B. Linien-, Balken-, Kreis-, Netzwerk- oder Flussdiagramme) rendern. Die Arbeit erfolgt hauptsächlich über die CLI `htmlview`, die Node.js 22+ und optional Chrome/Chromium für Exporte und Screenshots benötigt. Das Skill folgt einem klaren Workflow: Je nach Ziel wählst du eine Kategorie (Dokument, Datenbericht, UI-Entwurf oder Diagramm), liest die entsprechende Referenz, erstellst oder bearbeitest die Quelldateien und validierst das Ergebnis mit Befehlen wie `audit`, `check` und `shot`. Es unterstützt zwei Diagramm-Engines: KChart für datengetriebene Grafiken und Mermaid für Strukturdiagramme. Vor der Auslieferung ist eine Prüfung (Audit, Check, Screenshot) zwingend erforderlich.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/fengwk/html-view-skill/tree/HEAD/skills/html-view

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht HTML-Ansicht?

node <skill-dir>/scripts/htmlview ist der plattformübergreifende Befehlseinstieg; nachfolgend mit htmlview abgekürzt. Erfordert Node.js 22+; Browserprüfung, Screenshots, Export und eigenständiges Rendern von Grafiken benötigen zusätzlich Chrome oder Chromium. Wird kein Browser gefunden, erfolgt die Behandlung gemäß error.next.

Vorhandenes HTML: Nur das Theme wechseln

  • htmlview-Artefakte: Dokumente, Berichte oder einzelne Grafiken werden mit htmlview style file.html --theme cloudmusic gestylt (htmlview style --list zeigt verfügbare Themes); für UI-Entwürfe werden --scheme oder --brand verwendet. style aktualisiert direkt, nur das Gerüst und abgeleitete Grafiken werden neu zusammengesetzt. Für eine neue Datei kopiere zuerst eine unbenutzte Datei im selben Ordner, führe style auf der Kopie aus und vergleiche dann mit htmlview diff.
  • Normales HTML: style akzeptiert kein normales HTML. Wenn eine Skill-Hülle benötigt wird, erstelle ein neues Themendokument (siehe Dokument-Workflow und Dokument-Komponenten) und migriere den vorhandenen Inhalt in die neue Datei; übernimm nicht das CSS und die Skripte der alten Hülle. Wenn nur der Stil geändert wird, behalte die ursprünglichen Ziffern, Zeitgranularität und Schlussfolgerungen bei, berechne Daten nicht neu und entferne keine Details aus der ursprünglichen Grafik, um die Anzeigeprüfung zu bestehen.

Auswahl nach Aufgaben

Gewünschtes ErgebnisVorgehenWann erweitern
Leicht lesbare und annotierbare technische Konzepte, Berichte, Erläuterungen, Protokolle oder einseitige ZusammenfassungenBei vorhandenem Markdown: doc build; bei direkter HTML-Bearbeitung: doc newZuerst Dokument-Workflow lesen; beim händischen Schreiben von HTML-Komponenten, Hinzufügen von Querverweisen oder Verarbeiten von Kommentaren Dokument-Komponenten lesen
Zu prüfende Geschäftszahlen, Kennzahlen und Diagramme als Bericht oder DashboardAus Upstream-Zusammenfassungsdateien ein Datenpaket erstellen; nach data validate data build ausführenZuerst Bericht-Workflow lesen; beim Ändern von Feldern, Metriken, Grafiken oder Erläuterungen Datenpaket lesen; beim Erstellen eines Dashboards Dashboard-Design lesen
Wireframes, hochauflösende Entwürfe oder Prototypen zur Darstellung von Bildschirmen, Zuständen oder Interaktionsabläufenui new ausführen, dann jeden Bildschirm mit echten Steuerelementen ausfüllenZuerst UI-Workflow lesen; bei der Auswahl von Komponenten oder dem Schreiben von Interaktionen Komponentenindex lesen; bei der Festlegung von Layout, Farbpalette oder dem händischen Schreiben von Komponenten UI-Design lesen; bei der Erstellung eines Daten-Dashboards Dashboard-Design lesen
Einzelnes SVG oder offline-fähige GrafikseiteUntere Tabelle der Diagrammfamilie auswählen, Deklaration schreiben, dann viz renderBei Datengrafiken zuerst Allgemeine Deklaration lesen, dann die ausgewählte Diagrammfamilie; bei Strukturdiagrammen direkt die entsprechende Diagrammfamilie lesen
Lokales HTML lesen, prüfen, screenshoten oder exportierenread, check, shot, export oder embed verwendenParameter und Prüfergebnisse siehe Anzeige und Export
  • Wenn das Ausgangsmaterial keine fertige Seitenstruktur ist (z. B. lose Notizen, Besprechungsmitschriften, JSON, CSV, Logs oder umsortiertes Markdown), lies vor dem Schreiben des Inhalts Vom Material zur Seite.
  • HTML-Artefakte sind einzelne, offline-öffnbare Dateien. Beim händischen Schreiben nur den Titel und den Inhalt zwischen <!-- htmlview:content --> und <!-- /htmlview:content --> ändern; jede der beiden Markierungen bleibt einmal erhalten. Layout, Theme und Laufskripte werden von der CLI zusammengesetzt.
  • Ändere bei aus Markdown erstellten Dokumenten die Markdown-Quelle; bei Datenberichten das Datenpaket, nicht den generierten Text, die Grafiken oder Zahlen. Fehlt eine Quelle, dürfen keine Daten erfunden werden; Demodaten müssen als fiktive Beispiele gekennzeichnet sein.
  • Um bereits vorhandene eigenständige Ergebnisse zu überschreiben, muss --force nur nach Bestätigung des Ziels verwendet werden; bei Aktualisierungen desselben Quell-Dokuments ist --force nicht erforderlich.
  • Wird --lang nicht übergeben, leiten die Generierungsbefehle die Sprache für Hülsenelemente (Bildnummern, Inhaltsverzeichnis, Legenden) aus Titel und Fließtext ab: Die Sprache ist Englisch, wenn die Anzahl der englischen Wörter mindestens doppelt so hoch ist wie die Anzahl der chinesischen/japanischen/koreanischen Zeichen; andernfalls Chinesisch. Bei anderen Sprachen oder gemischtem Inhalt wird --lang explizit übergeben.

Auswahl des Diagramms nach Leserfrage

Standardmäßig werden statische Diagramme verwendet. Datengrafiken werden mit KChart JSON erstellt; Strukturbeziehungen mit Mermaid oder nativen Deklarationen. Lies zuerst Allgemeine Regeln für Konfiguration, Stil, Links und Diagnose, dann das entsprechende Diagramm; KChart übernimmt nicht das Aussehen von Mermaid. Gib nur Daten, Semantik und Leseabsicht an, keine Koordinaten, Schriftgrößen, Farben oder Zeichnungsskripte. Diagramme können bei Bedarf scrollbar sein; die Seite selbst sollte nicht horizontal überlaufen.

LeserfrageDiagrammtyp-EinstiegBei Bedarf lesen
Wie verändert es sich, wann ändert es sich?line, area, sparkline, small-multiples, stream, combo, bump, candlestick, launch-fanTrends
Welches ist größer, wie groß ist die Differenz, wie weit vom Ziel entfernt?bar, column, dumbbell, slope, bullet, gauge, interval, split-compareVergleich
Wie setzt sich die Summe zusammen, wie viel geht in den einzelnen Schritten verloren?share, pie, donut, radial-share, rose, funnel, waterfall, waffle, tally, treemap, sunburstZusammensetzung
Wie sind die Werte verteilt, gibt es Ausreißer oder Korrelationen?histogram, boxplot, violin, strip, scatterVerteilung
Wo gibt es Anomalien in einer mehrdimensionalen Matrix oder im Kalender?heatmap, bubble-matrix, calendar, radar, parallelMatrix
Wer ist mit wem verbunden, wie fließen die Mengen?network, sankey, threadsNetzwerk
Wo sind sie verteilt?choropleth, geo-scatterKarten
Wie klassifizieren, wie von einem Thema aus verzweigen?KChart tree, mindmap; Mermaid mindmap, ishikawa, treeView-betaHierarchie und Mindmap
Wie ist der Ablauf von wem zu wem, wie wechseln die Zustände?flowchart, stateDiagram-v2, journey, swimlane-beta, eventmodeling, agentflow-beta, nativ swimlaneAbläufe
Wer ruft in welcher Reihenfolge an und wer ist beteiligt?sequenceDiagram, usecase-betaSequenz
Wie planen, spalten oder nummerieren?gantt, timeline, gitGraph, kanban, packet, quadrantChartZeit und Raster
Wie hängen Entitäten, Klassen oder Anforderungen zusammen?erDiagram, classDiagram, requirementDiagramDatenmodell
Wie passt eine Syntaxregel zu Symbolen?railroad-beta, railroad-ebnf-beta, railroad-abnf-beta, railroad-peg-betaDatenmodell
Wie ist das System geschichtet, wo sind Container und Abhängigkeiten?C4Context, C4Container, C4Component, C4Dynamic, C4Deployment, architecture-beta, block, wardley-beta, nativ layers, blocksArchitektur
Einseitige Übersicht: Karten in Gruppen, Hauptablauf und Legende?Nativ blocks (Karten, Badges, Legenden, Hervorhebungslinien); bei vorhandenen Mermaid-Blockdiagrammen blockArchitektur
Vorhandene Mermaid-Datendiagramme?pie, xychart, sankey, radar-beta, treemapMermaid-Datendiagramme; für neue Datengrafiken die obigen KChart-Diagrammtypen verwenden
Wie überschneiden sich Mengen, wie werden Kontexte kategorisiert?venn-beta, cynefin-betaMengen, Kontexte
Aufrufdiagramm mit ZenUML-Syntax?zenuml (natives KChart-Rendering, kein externes Plugin erforderlich)ZenUML
Nur Rendering-Version prüfen?Mermaid info (nicht für die Auslieferung)Mermaid-Allgemeines

Markdown verwendet kchart, mermaid, layers, blocks, swimlane-Umgebungen; händisches HTML verwendet <pre data-viz="syntax">, wobei HTML-Sonderzeichen escaped werden. Diagrammtitel werden in der Deklaration geschrieben: KChart title, Strukturdiagramm-Prolog title: oder die von der Syntax unterstützte Titelaussage. Diagrammtitel und Text im Diagramm verwenden dieselbe Sprache wie der Fließtext. Wenn integrierte Diagrammfamilien nicht ausreichen oder sich nicht ausdrücken lassen (z. B. zu tiefe Verschachtelung, zu viele Beziehungen oder Mechanismus-Skizzen), zerlege zuerst in Gesamt- und Teildiagramme; wenn noch Handzeichnung erforderlich, lies Handgeschriebenes SVG.

Kurzbefehle

Was tunBefehl
Dokument entwerfen/aus Quelle generierenhtmlview doc new plan.html --type plan --title 'Kapazitätsplan' oder htmlview doc build spec.md --out spec.html --type tech-spec
Datenpaket und Berichthtmlview data init example → htmlview data validate example/report.json → htmlview data build example/report.json --out report.html
UI-Entwurf-Grundgerüsthtmlview ui new prototype.html --title 'Antragsbearbeitung' --device mobile --screens 'Liste,Details'
Statische Prüfung, Inhaltsvergleichhtmlview audit file.html; htmlview diff old.html new.html
Grafikmodule für Dokument oder UI-Entwurf neu ladenhtmlview style file.html (behält vorhandenes Theme und Inhalt)
Anzeigeprüfung, Screenshot, Exporthtmlview check file.html; htmlview shot file.html --select 'figure'; htmlview export file.html --format pdf; ganzseitiges Langbild htmlview export file.html --format png
Fließtext lesen, lokale Ressourcen einbettenhtmlview read file.html [--outline oder --section id]; htmlview embed file.html
Eigenständige Grafik, Feld-Einschränkungen, Theme-Farben, handgezeichnetes Diagramm-Maßhtmlview viz render spec.json --out chart.svg; htmlview viz schema bar; htmlview viz palette --theme paper; htmlview viz measure 'Auftragsservice' --size 13

Wenn der Benutzer eigene Farben mitbringt, verwende --theme-file <JSON>; Felder und Beispiele siehe Themendatei. Das Theme wird in HTML eingebettet; UI-Entwürfe verwenden eigenständige Markenfarben.

htmlview <Unterbefehl> --help gibt die genauen Parameter aus. pass:false bei Prüfbefehlen bedeutet, dass die Prüfung abgeschlossen wurde, aber Probleme festgestellt wurden; behebe sie gemäß failures[].fix. ok:false bedeutet, dass der Befehl nicht abgeschlossen werden konnte; behandele gemäß error.next.

Validieren vor Auslieferung

  1. Führe nach Erstellung oder Änderung eines Artefakts audit aus. Fehlt ein Grafikmodul, führe style zur Neuzusammenstellung aus und prüfe erneut; bei Inkonsistenzen im Beleg des Berichts korrigiere im Datenpaket.
  2. Führe bei änderungsrelevanten Anzeigeänderungen check und dann shot aus, um den tatsächlichen Screenshot zu öffnen. Prüfe Titel-Hierarchie, Text-Zuordnung, Leerraum und den ersten Bildschirm auf Mobilgeräten; öffne bei breiten Grafiken das vollständige SVG zur Überprüfung. Klicke bei Prototypen mit Interaktion tatsächlich die kritischen Pfade durch.
  3. Öffne bei PDF-Auslieferung das tatsächliche PDF und überprüfe, ob Bildtitel und Bild auf derselben Seite sind und die Ränder vollständig sind. Bei Druckhinweisen wähle ein geeignetes Papierformat oder passe das Layout an, behalte eine lesbare Schriftgröße bei; wenn ein vollständiger Druck nicht möglich ist, dokumentiere die Einschränkung.

Verwandte Skills