Communitygithub.com

deck-visuals

Erstelle maßgeschneiderte, markenkonforme 3D-Renderings (Three.js), redaktionelle Datenvisualisierungen (D3/SVG) und deterministische Loop-Videos (MP4) – zu 100% lokal via headless Playwright/Chromium und ffmpeg.

Was ist deck-visuals?

Dieses Skill generiert hochwertige visuelle Assets für Folien, ohne auf KI-Bilder oder externe CDNs angewiesen zu sein. Es liest automatisch die Marken-Token (Farben, Schriften) aus `deck-brand` und erstellt entweder transparente PNGs oder nahtlos loopende MP4-Clips – alles deterministisch und lokal. Das Skill unterstützt vorbereitete Three.js-Rezepte (z.B. Helden-Orb, Isometrische Layer, Flywheel) sowie D3/SVG-Diagramme für Datenvisualisierungen. Es wird typischerweise zusammen mit `deck-builder` verwendet, um visuelle Assets in Folien einzufügen und ist für Claude Code, Cursor und andere KI-Agenten optimiert, die eine reproduzierbare, code-first Pipeline benötigen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SwePalm/deckcraft-skills/tree/HEAD/skills/deck-visuals

In Ihrer bevorzugten KI fragen

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

Dokumentation

Deck Visuals (100% lokale, code-first visuelle Werkstatt)

Jedes hier generierte Bild ist code-first, deterministisch und markenkonform:

  • Liest window.BRAND_TOKENS (automatisch aus tokens.json von deck-brand injiziert) und optional window.VISUAL_DATA (aus --data data.json).
  • Importiert lokale Pakete (three, d3) vom lokalen, ephemeren statischen Server – keine externen Netzwerk- oder CDN-Aufrufe.
  • Rendert gestochen scharfe 2x Retina-PNGs mit transparentem Hintergrund (--mode png) oder nahtlos loopende H.264-MP4-Clips (--mode mp4), bereit für insert.picture oder insert.video in deck-builder.

Visualauswahl-Leitfaden (Narrativ zuerst)

Narrativer BedarfBestes Werkzeug / Eingebautes RezeptAusgabe
Schrittweises Diagramm oder Zoom in einen BereichDeckCraft Morph (deck-builder)Native Vektorformen
Ikonischer Cover / Konzeptanker / 3D-HeldThree.js (three-hero-orb.html)Transparentes 2x-PNG oder 3–4 s Loop-MP4
Geschichtetes System / PlattformarchitekturThree.js Isometrisch (three-isometric-layers.html)Transparentes 2x-PNG
Aufwandsskala / Reifegrad / Phasen-RoadmapThree.js Terrassen (three-ascending-steps.html)Transparentes 2x-PNG
Wiederverwendbares Schwungrad / N-förmiges BetriebsmodellThree.js Schwungrad (three-orbital-flywheel.html)Nahtlos loopendes MP4 oder 2x-PNG
Quantifizierte Belege, Trends, Rankings, VergleicheD3 / SVG (editorial-chart.html)Transparentes 2x-PNG
Produkt / UI-DurchlaufHTML/CSS 3D-Perspektivenbühne (Playwright)Transparentes 2x-PNG
Echte Fotografie aus der realen WeltVom Benutzer bereitgestelltes Foto (oder optionaler zukünftiger Cloud-Hook)Zugeschnittenes Bild

Rendern eines visuellen Assets

1. Transparentes Retina-PNG (3D-Still, D3-Diagramm, SVG-Diagramm)

node skills/deck-visuals/scripts/render_visual.mjs \
  --scene skills/deck-visuals/references/recipes/three-hero-orb.html \
  --tokens build/brand/tokens.json \
  --width 600 --height 600 --scale 2 \
  --mode png --transparent \
  --out build/assets/hero-3d.png

2. Deterministisches Loop-MP4 (3D-Drehteller, animiertes Diagramm, Shader)

Lege window.renderFrame = (t) => { ... } offen, wobei t gleichmäßig von 0 bis 1 läuft (nahtloser Übergang, sodass t=0 und t=1 übereinstimmen!). Führe dann aus:

node skills/deck-visuals/scripts/render_visual.mjs \
  --scene skills/deck-visuals/references/recipes/three-hero-orb.html \
  --tokens build/brand/tokens.json \
  --width 600 --height 600 --scale 1 \
  --mode mp4 --fps 30 --duration 4 \
  --out build/assets/hero-3d-loop.mp4

3. Übergeben eigener Daten an Diagramme/Visualisierungen

Übergib --data pfad/zu/diagramm-daten.json – der Runner injiziert die Daten als window.VISUAL_DATA, bevor das Szenenskript ausgeführt wird.

Qualitätsregel: Vor dem Einbetten prüfen

Überprüfe jedes gerenderte PNG (oder Videobild) isoliert, bevor du es auf eine DeckCraft-Folie setzt:

  • Prüfe Transparenz und Kantenglättung (keine harten Rahmenkanten gegen den Folienhintergrund).
  • Prüfe, dass Diagrammbeschriftungen scharf, nicht überlappend und mindestens 11–12pt in der Zielfolienauflösung sind.
  • Prüfe, dass alle Farben mit tokens.json harmonieren.

Individual skills in this repo

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

Verwandte Skills