Communitygithub.com

deck-visuals

ブランドトークン化された3Dレンダリング(Three.js)、エディトリアルデータ可視化(D3/SVG)、決定論的ループモーションクリップ(MP4)を100%ローカルで生成します。NARRATIVE.mdでヒーロー3Dビジュアル、カスタムアーキテクチャ図、出版品質のチャート、または微妙なループモーション背景が必要なときに使用してください。

deck-visuals とは?

Deck Visualsは、コードファーストで決定論的、ブランドトークン化されたビジュアルアセットを生成するスキルです。Three.jsを使った3Dヒーローオーブやアイソメトリックレイヤー、D3/SVGを使った高品質なチャート、ffmpegを使ったシームレスループMP4クリップを、すべてローカルのヘッドレスPlaywright/Chromium環境でレンダリングします。ブランドトークン(tokens.json)を自動的に注入し、外部ネットワークやCDNに依存しないため、再現性が高く、セキュアです。主にDeckCraftのスライドに組み込むための透明PNGやループ動画を生成するために使用し、生成されたビジュアルは常に検査してからスライドに配置します。

対応~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経由)を読み取ります。
  • ローカルなephemeral静的サーバーからローカルパッケージ(three、d3)をインポートします—外部ネットワークやCDN呼び出しはゼロです。
  • 2x Retinaの透明PNG(--mode png)またはシームレスループH.264 MP4クリップ(--mode mp4)をレンダリングし、deck-builderのinsert.pictureまたはinsert.videoで使用できる状態にします。

ビジュアル選択ガイド(ナラティブ優先)

ナラティブのニーズ最適なツール / 組み込みレシピ出力
図を段階的に表示、または1つの柱にズームインDeckCraft Morph(deck-builder)ネイティブベクターシェイプ
象徴的なカバー / コンセプトアンカー / 3DヒーローThree.js(three-hero-orb.html)透明2x PNGまたは3〜4秒のループMP4
レイヤードシステム / プラットフォームアーキテクチャThree.js Isometric(three-isometric-layers.html)透明2x PNG
努力規模 / 成熟度 / フェーズ化されたロードマップThree.js Terraces(three-ascending-steps.html)透明2x PNG
再利用可能なフライホイール / Nパターン運営モデルThree.js Flywheel(three-orbital-flywheel.html)シームレスループMP4または2x PNG
定量化された証拠、トレンド、ランキング、比較D3 / SVG(editorial-chart.html)透明2x PNG
製品 / UIウォークスルーHTML/CSS 3D Perspective Stage(Playwright)透明2x PNG
本物の現実世界の写真ユーザー提供の写真(または将来のオプションクラウドフック)トリミングされた画像

ビジュアルアセットのレンダリング

1. 透明Retina 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.

関連スキル