Communitygithub.com

deck-visuals

Génère des rendus 3D (Three.js), des visualisations de données éditoriales (D3/SVG) et des clips MP4 en boucle déterministe, 100 % en local via Playwright/Chromium et ffmpeg. À utiliser dès qu'une diapositive de NARRATIVE.md nécessite une 3D héroïque, un diagramme d'architecture personnalisé, un graphique de qualité publication ou un fond animé subtil — ne jamais utiliser d'images génériques par IA pour les diagrammes, graphiques ou textes.

Qu'est-ce que deck-visuals ?

Deck Visuals est un atelier de création visuelle 100 % local, piloté par le code, conçu pour produire des assets visuels déterministes et alignés avec la charte graphique du projet. Il s'intègre parfaitement à DeckCraft en lisant automatiquement les jetons de marque (`window.BRAND_TOKENS`) et les données optionnelles (`window.VISUAL_DATA`) pour générer des PNG 2x transparents ou des MP4 en boucle. L'outil utilise Three.js pour les rendus 3D héroïques, D3/SVG pour les graphiques éditoriaux, et HTML/CSS pour les perspectives 3D de produits. Chaque rendu est effectué en isolation via une instance headless de Playwright/Chromium, sans aucun appel réseau externe ni CDN, garantissant répétabilité et sécurité. Le guide de sélection visuelle aide à choisir la recette appropriée selon le besoin narratif : orbite 3D pour une couverture, diagramme isométrique pour une architecture, courbes d'effort pour une roadmap, etc. Les commandes de rendu sont simples et paramétrables, avec sortie en PNG ou MP4, et une vérification manuelle des assets est recommandée avant intégration dans les diapositives DeckCraft.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Deck Visuals (Atelier Visuel 100 % Local, Piloté par le Code)

Chaque visuel généré ici est piloté par le code, déterministe et aligné avec la charte graphique :

  • Lit window.BRAND_TOKENS (injecté automatiquement depuis tokens.json de deck-brand) et, en option, window.VISUAL_DATA (depuis --data data.json).
  • Importe les paquets locaux (three, d3) depuis le serveur statique éphémère local — zéro appel réseau externe ou CDN.
  • Produit des PNG transparents 2x retina nets (--mode png) ou des clips MP4 H.264 en boucle fluides (--mode mp4) prêts pour insert.picture ou insert.video dans deck-builder.

Guide de Sélection Visuelle (Narratif d'Abord)

Besoin NarratifMeilleur Outil / Recette IntégréeSortie
Parcourir un diagramme ou zoomer sur un pilierDeckCraft Morph (deck-builder)Formes vectorielles natives
Couverture / ancrage conceptuel / 3D héroïqueThree.js (three-hero-orb.html)PNG 2x transparent ou MP4 boucle 3-4s
Système en couches / architecture de plateformeThree.js Isométrique (three-isometric-layers.html)PNG 2x transparent
Échelle d'effort / maturité / roadmap par phasesThree.js Terrasses (three-ascending-steps.html)PNG 2x transparent
Volant réutilisable / modèle opérationnel en NThree.js Volant (three-orbital-flywheel.html)MP4 boucle fluide ou PNG 2x
Preuve quantifiée, tendances, classements, comparaisonsD3 / SVG (editorial-chart.html)PNG 2x transparent
Parcours produit / UIScène 3D HTML/CSS Perspective (Playwright)PNG 2x transparent
Photographie réelle authentiquePhoto fournie par l'utilisateur (ou hook cloud futur optionnel)Image recadrée

Rendu d'un Actif Visuel

1. PNG Retina Transparent (3D fixe, graphique D3, diagramme SVG)

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. MP4 Boucle Déterministe (table tournante 3D, diagramme animé, shader)

Exposez window.renderFrame = (t) => { ... } où t parcourt de 0 à 1 (boucle parfaitement : t=0 et t=1 identiques !). Exécutez ensuite :

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. Passage de Données Personnalisées aux Graphiques/Diagrammes

Passez --data chemin/vers/chart-data.json — l'exécuteur injecte les données dans window.VISUAL_DATA avant l'exécution du script de scène.

Règle de Qualité : Inspecter avant d'Intégrer

Inspectez toujours chaque PNG rendu (ou mi-trame vidéo) en isolation avant de le placer sur une diapositive DeckCraft :

  • Vérifiez la transparence et l'anti-crénelage des bords (pas de bordure de boîte englobante dure contre l'arrière-plan de la diapositive).
  • Vérifiez que les étiquettes du graphique sont nettes, non chevauchantes et d'au moins 11-12pt à la taille cible du rectangle de la diapositive.
  • Vérifiez que toutes les couleurs s'harmonisent avec tokens.json.

Individual skills in this repo

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

Skills associés