Communitygithub.com

deck-visuals

Genera representaciones 3D personalizadas con marca (Three.js), visualizaciones editoriales de datos (D3/SVG) y clips de movimiento en bucle deterministas (MP4) 100% localmente mediante Playwright/Chromium y ffmpeg.

¿Qué es deck-visuals?

Deck Visuals es un skill para generar activos visuales de alta calidad, como renders 3D heroicos (Three.js), diagramas de arquitectura, gráficos editoriales (D3/SVG) y fondos animados en bucle, todo con un enfoque 'código primero' que garantiza determinismo, seguridad de marca y funcionamiento 100% local. Se integra con otros skills del ecosistema DeckCraft: lee tokens de marca desde deck-brand, recibe datos opcionales mediante --data y produce PNG transparentes 2x o MP4 en bucle listos para insertar en diapositivas con deck-builder. El skill aprovecha un servidor local estático para importar bibliotecas como three y d3 sin dependencias externas, y utiliza Playwright headless y ffmpeg para renderizar y codificar localmente. Su guía de selección visual ayuda a elegir la receta adecuada según la narrativa de la diapositiva (esferas 3D, capas isométricas, terrazas ascendentes, volantes orbitales o gráficos de barras), y enfatiza la inspección manual de cada render para verificar transparencia, nitidez y armonía cromática con los tokens de marca.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Deck Visuals (Estudio Visual 100% Local, Primero el Código)

Cada visual generado aquí es primero el código, determinista y con tokens de marca:

  • Lee window.BRAND_TOKENS (inyectados automáticamente desde tokens.json de deck-brand) y opcionalmente window.VISUAL_DATA (desde --data data.json).
  • Importa paquetes locales (three, d3) desde el servidor estático efímero local—cero llamadas externas a redes o CDN.
  • Genera PNG transparentes retina 2x (--mode png) o clips H.264 MP4 en bucle sin costuras (--mode mp4) listos para insert.picture o insert.video en deck-builder.

Guía de Selección Visual (Narrativa Primero)

Necesidad NarrativaMejor Herramienta / Receta IncorporadaSalida
Recorrer un diagrama o acercarse a un pilarDeckCraft Morph (deck-builder)Formas vectoriales nativas
Portada icónica / ancla conceptual / héroe 3DThree.js (three-hero-orb.html)PNG transparente 2x o MP3 en bucle de 3–4 s
Sistema en capas / arquitectura de plataformaThree.js Isométrico (three-isometric-layers.html)PNG transparente 2x
Escala de esfuerzo / madurez / hoja de ruta por fasesThree.js Terrazas (three-ascending-steps.html)PNG transparente 2x
Volante reutilizable / modelo operativo en NThree.js Volante (three-orbital-flywheel.html)MP4 en bucle sin costuras o PNG 2x
Prueba cuantificada, tendencias, rankings, comparacionesD3 / SVG (editorial-chart.html)PNG transparente 2x
Recorrido de producto / UIEscenario 3D en Perspectiva HTML/CSS (Playwright)PNG transparente 2x
Fotografía real genuinaFoto proporcionada por el usuario (o hook opcional futuro en la nube)Imagen recortada

Renderizar un Activo Visual

1. PNG Retina Transparente (3D estático, gráfico D3, diagrama 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 en Bucle Determinista (tornamesa 3D, diagrama animado, shader)

Exponga window.renderFrame = (t) => { ... } donde t se ejecute suavemente de 0 a 1 (cierre sin costuras para que t=0 y t=1 coincidan!). Luego ejecute:

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. Pasar Datos Personalizados a Gráficos/Diagramas

Pase --data ruta/a/datos-grafico.json—el ejecutor lo inyecta como window.VISUAL_DATA antes de que se ejecute el script de la escena.

Regla de Calidad: Inspeccionar Antes de Insertar

Inspeccione siempre cada PNG renderizado (o fotograma intermedio de video) de forma aislada antes de colocarlo en una diapositiva de DeckCraft:

  • Verifique la transparencia y el antialiasing de bordes (sin costura abrupta del cuadro delimitador contra el fondo de la diapositiva).
  • Verifique que las etiquetas del gráfico sean nítidas, sin superposición y al menos equivalentes a 11–12pt en el tamaño rect objetivo de la diapositiva.
  • Verifique que todos los colores armonicen con tokens.json.

Individual skills in this repo

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

Skills relacionados