Communitygithub.com

deck-visuals

로컬 환경에서 Three.js, D3.js 및 Playwright를 사용하여 브랜드 토큰 기반의 3D 렌더링, 편집용 데이터 시각화, 반복 모션 클립을 생성하는 100% 코드 기반 비주얼 스튜디오입니다.

deck-visuals란 무엇인가요?

Deck Visuals는 프레젠테이션 슬라이드에 사용될 고품질의 시각 자료를 완전히 로컬에서 코드 기반으로 생성하는 AI 스킬입니다. NARRATIVE.md에서 요구하는 히어로 3D 비주얼, 아키텍처 다이어그램, 출판 수준의 차트, 부드러운 루핑 모션 배경 등을 제작할 때 사용하며, 일반적인 AI 이미지 생성과 달리 모든 요소가 결정론적이고 브랜드 토큰에 의해 일관된 색상 체계를 유지합니다. Three.js 기반의 3D 장면, D3/SVG 기반의 편집용 차트, HTML/CSS 3D 스테이지 등 다양한 레시피를 제공하며, Playwright와 Chromium을 헤드리스로 실행하여 2배 해상도의 투명 PNG 또는 루핑 MP4를 생성합니다. CLI 명령어를 통해 --tokens, --data, --mode, --width, --height, --scale 등의 옵션을 세밀하게 제어할 수 있어, 각 슬라이드에 최적화된 시각 자료를 반복 가능하고 예측 가능한 방식으로 제작할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SwePalm/deckcraft-skills/tree/HEAD/skills/deck-visuals

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Deck Visuals (100% 로컬 코드 우선 비주얼 스튜디오)

여기서 생성되는 모든 비주얼은 코드 우선, 결정론적, 브랜드 토큰 기반입니다:

  • window.BRAND_TOKENS 읽기 (deck-brand의 tokens.json에서 자동 주입됨) 및 선택적 window.VISUAL_DATA (--data data.json에서 전달).
  • 로컬 임시 정적 서버에서 제공되는 로컬 패키지 (three, d3) 가져오기—외부 네트워크 또는 CDN 호출 없음.
  • deck-builder의 insert.picture 또는 insert.video에 바로 사용할 수 있는 선명한 2배 레티나 투명 PNG (--mode png) 또는 매끄러운 루핑 H.264 MP4 클립 (--mode mp4) 렌더링.

시각 자료 선택 가이드 (내러티브 우선)

내러티브 필요최적 도구 / 내장 레시피출력 형식
다이어그램 단계별 탐색 또는 한 요소 확대DeckCraft Morph (deck-builder)네이티브 벡터 도형
상징적 커버 / 콘셉트 앵커 / 3D 히어로Three.js (three-hero-orb.html)투명 2배 PNG 또는 3–4초 루핑 MP4
계층형 시스템 / 플랫폼 아키텍처Three.js 아이소메트릭 (three-isometric-layers.html)투명 2배 PNG
노력 규모 / 성숙도 / 단계별 로드맵Three.js 테라스 (three-ascending-steps.html)투명 2배 PNG
재사용 가능한 플라이휠 / N-패턴 운영 모델Three.js 플라이휠 (three-orbital-flywheel.html)매끄러운 루핑 MP4 또는 2배 PNG
정량적 증명, 트렌드, 순위, 비교D3 / SVG (editorial-chart.html)투명 2배 PNG
제품 / UI 워크스루HTML/CSS 3D 원근 스테이지 (Playwright)투명 2배 PNG
실제 사진 (일반적인 실사 이미지)사용자 제공 사진 (또는 미래의 선택적 클라우드 훅)크롭된 사진

비주얼 자산 렌더링

1. 투명 레티나 PNG (3D 정지 이미지, D3 차트, 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 (3D 턴테이블, 애니메이션 다이어그램, 셰이더)

window.renderFrame = (t) => { ... }를 노출시키고, t가 0에서 1로 부드럽게 실행되도록 하십시오 (t=0과 t=1이 일치하도록 매끄럽게 연결!). 그런 다음 실행:

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. 차트/다이어그램에 사용자 정의 데이터 전달

--data path/to/chart-data.json을 전달하면 러너가 씬 스크립트가 실행되기 전에 window.VISUAL_DATA로 데이터를 주입합니다.

품질 규칙: 임베드 전 검사

렌더링된 모든 PNG (또는 비디오 중간 프레임)는 DeckCraft 슬라이드에 배치하기 전에 반드시 단독으로 검사하십시오:

  • 투명도와 가장자리 앤티앨리어싱 확인 (슬라이드 배경에 대해 거친 경계 상자 이음새 없음).
  • 차트 레이블이 선명하고 겹치지 않으며, 대상 슬라이드 사각형 크기에서 최소 11–12pt에 해당하는지 확인.
  • 모든 색상이 tokens.json과 조화를 이루는지 확인.

Individual skills in this repo

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

관련 스킬