mcpField
Y
yuv-decks

yuv-decks

github.com/hoodiniドキュメント29145 回インストール5 日前に更新
リポジトリ

yuv-decks について

yuv-decksは、Yuval Avidani風の講演スライドをopen-slideで作るスキルです。物語性とシネマティックな表現を求める登壇者向けに、4幕構成や各スライドのJourneyBarを定め、設計と執筆を関連スキルに委ねます。

主な機能

  1. 014幕構成の講演ナラティブ
  2. 02全スライドへのJourneyBar配置
  3. 03簡潔で専門用語を抑えた文章規則
  4. 04Fly Highとcinematic-flightのモード
  5. 05デザイン・スライド執筆スキルとの連携

活用シーン

  1. 01講演やプレゼンテーション資料の作成
  2. 02事例研究を物語として構成
  3. 03ブランドのビジュアル規則に沿ったスライド作成
  4. 04ページ数と言語の計画

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/hoodini/ai-agents-skills --skill yuv-decks

インストール後、Claude Code で/yuv-decksを入力して読み込まれたか確認します。

詳細

yuv-decks — Yuval Avidani 風のシネマティックなスライドデッキを構築

トーク用スライドデッキを構築するための、独自の方針に基づくプレイブックです。open-slide を基盤とし、次の内容を定めています。

  • Yuval らしい語り口 — 平易な言葉、専門用語を避け、ストーリーを軸にする
  • 4幕構成のナラティブアーク — 搭乗 → 上昇 → 巡航 → 降下
  • JourneyBar — すべてのスライドを統一する唯一のビジュアル
  • コンパニオンスキルのオーケストレーション — yuv-design-system、slide-authoring、nano-banana-pro、hyperframes、mermaid

ビジュアルパレットは、Decks モードの yuv-design-system から取得します。Fly High のパープル/イエロー/グレーは、スライド出力専用のパレットです。中心となるメタファーが文字どおりの飛行であるトークでは、このスキル独自のオプトインモードである cinematic-flight(スカイブルー+ホットピンク)を使用できます。詳しくはステップ 5 を参照してください。このモードはデザインシステムの Decks トークンより優先されます。スライドに Neon モードは使用しないでください。プレゼンテーションには Decks モードのみを使用します。

このスキルは、NICE のプレハッカソン(2026年5月)向けに「Build Agents That Ship」を制作した経験を凝縮したものです。スライドの下書きを始める前に、最後まで読んでください。

YUV.AI ピラミッドにおけるこのスキルの位置付け

yuv-decks は、YUV.AI スキルピラミッドの中間層にあります。最上位のオーケストレーター yuv-pilot は、ユーザーがスライドデッキを求めたときにここへ処理を振り分けます。また、ユーザーが yuv-pilot を介さずに「スライドデッキを作って」と言った場合、このスキルを直接呼び出すこともできます。

このスキルから yuv-design-system を呼び出す場合は、必ずモードを「Decks」に固定します。Neon(Web/アプリ用パレット)や Warm Editorial にフォールスルーさせないでください。スライドで使えるパレットモードは Decks のみです。

ピラミッド全体のマップとルーティングテーブルについては、yuv-pilot/SKILL.md を参照してください。

リファレンス実装:https://github.com/hoodini/build-agents-that-ship(非公開 — アクセスできる場合はクローンしてください。このスキルで説明しているパターン全体が実装されています)。


このスキルが基盤とするもの

yuv-decks は独自の方針に基づくレイヤーです。次のスキルに明示的に委任します。

スキル担当範囲参照するタイミング
yuv-design-systemパレット、タイポグラフィ、アニメーションライブラリ、ブランドアセット、シグネチャーコンポーネント(PurpleBar、YellowUnderline、FlightHUD、CompassDial、CounterUp、HeroBg)、公式ソーシャルリンク、Hyperframes のパターン常に参照します。ステップ 5、ステップ 6、およびパレット/文字/コンポーネントを扱うときはいつでも参照します。
slide-authoringOpen-slide のファイル規約、1920×1080 のキャンバス、文字サイズの既定値、縦方向の予算計算、アセットパス、フレームワークに関する厳格なルール各ページの JSX を記述するときに参照します(ステップ 6 以降)。
create-slide汎用の open-slide オーサリングツール(スコープを確認する質問を行い、テーマを選択)Yuval らしい語り口ではないデッキ(ほかの人物や一般的なコンテンツ)に使用します。Yuval らしいシグネチャーなトークスタイルでは、yuv-decks がこれに優先します。

yuv-decks のルールは、yuv-design-system と slide-authoring に追加するものであり、これらに優先することはありません。


このスキルを呼び出すタイミング

ユーザーがトーク用またはプレゼンテーション用のスライドデッキを求めている場合に使用します。呼び出しの例:

  • 「X についてのスライドデッキを作って」
  • 「Y に関するトーク用のスライドを作成して」
  • 「[company] のハッカソン用のプレゼンテーションを作って」
  • 「Z について発表するので、スライドデッキの作成を手伝って」
  • 「מצגת על...」/「שקפים על...」/「דק על...」

次の場合は呼び出さないでください:単一のランディングページ、動画、ドキュメント、Google Slide の PowerPoint エクスポート。このスキルは、シネマティックな動きを加えて 1920×1080 でレンダリングするopen-slide の React デッキ向けです。


ステップ 0 — プロジェクトを初期化する

既定の保存先: ~/Documents/yuv-projects/decks/<deck-slug>/ — 後から見つけられるよう、デッキは常にここに保存してください。このスキルは、親ディレクトリが存在しない場合に作成します。ユーザーが別の場所を明示的に希望した場合のみ、保存先を変更してください。

# Pick a slug. Lowercase, hyphenated, descriptive.
mkdir -p ~/Documents/yuv-projects/decks
cd ~/Documents/yuv-projects/decks
npx @open-slide/cli init <deck-slug>
cd <deck-slug>
npm install
npm run dev   # starts the preview at http://localhost:5173

最終パス:~/Documents/yuv-projects/decks/<deck-slug>/。各セッションの最後に、デッキの保存場所をユーザーに伝えてください。

スキャフォールドは slides/getting-started/(デモ)を作成します。独自のスライドは slides/<deck-id>/index.tsx に作成し、デモは削除するか無視してください。


ステップ 1 — デッキの範囲を決める(作成前に質問する)

草案を作る前に、1 回の AskUserQuestion(複数質問フォーム)で、次の 4 点を確定します。

  1. トピックと対象者 — デッキの目的は何で、どのような人が参加しますか?可能であれば、お客様の実際のアジェンダ(聞きたい内容をそのまま箇条書きにしたもの)を確認し、1 対 1 で一致させます。
  2. ページ数 — 短め(5–6)、標準(8–10)、深掘り(12–24)。
  3. 言語 — 英語/ヘブライ語/バイリンガル。Yuval はバイリンガルなので、対象者に合わせて選びます。
  4. 登壇者の状況 — Yuval が登壇しますか?特定の企業(NICE など)向けですか?主催者が分かれば、「……そう、皆さんが今いる会社のことです」のような呼びかけを盛り込めます。
  5. ビジュアルモード — Fly High(標準の紫)または cinematic-flight(空色+ホットピンク。講演の中心的な比喩が文字どおりの飛行である場合のみ)。迷ったら Fly High を選びます。

このステップを省略してはいけません。後工程での修正は、どれもここでの誤った前提に起因します。


ステップ 2 — Yuval の語り口(譲れないルール)

すべての文面で、次の 3 つのルールを守ります。

ルール 1 — 平易な言葉を使い、専門用語は避ける

一般に使われない用語は、すべて言い換えます。

使わない代わりに使う
EBIT実際の利益
PoCプロトタイプ/デモ段階
BYOC自社のクラウド
service-account-as-godすべてに使える管理者トークン
RAG回答前に検索すること
fine-tuning自社のデータでモデルをトレーニングすること
vLLMローカル LLM 実行環境

名称(LiteLLM、Bedrock、Anthropic、Cognigy など)を残す必要がある場合は、そのままにして、初出時に 3 語で定義します(「LiteLLM — AI ゲートウェイライブラリ」)。

ルール 2 — 短い文。歯切れのよい断片。たとえば、次のように。

箇条書きは最大 8~12 語にします。「したがって/ゆえに/しかし」はすべて削ります。文が 3 行にわたる場合は、分割するか短くします。

調整テスト — 草案を書く前に、次の例を変換します。

❌ 「Watson の推奨が間違っていても、そこから何も学びませんでした。同じ間違いを何年も繰り返しました。システムは使うほど改善することがありませんでした。」

✅ 「Watson は間違えました。何度も同じ間違いをしました。何年も。」

ルール 3 — 名称はすべて初出時に説明する

「Watson は IBM の AI です。2011 年に Jeopardy で優勝しました。その後、病院を対象にしました。」 「Klarna はスウェーデン最大のフィンテック企業です。後払いサービスを提供し、顧客は 1 億 5,000 万人です。」

対象者が名前や内容を知っていると決めつけてはいけません。


ステップ 3 — 物語の流れ(4 幕)

どのような対象者にも通用する構成です。

ACT I · BOARDING — The Stakes              (slides 1–4)
  Cover · Hook stat · Sources agree · Failure patterns

ACT II · ASCENT — The Stories              (slides 5–9)
  Failure case story · Why it failed (4 bullets) ·
  Success case story · Why it worked (4 bullets) ·
  Reference example (real product the audience knows)

ACT III · CRUISE — The Build               (slides 10–22)
  Anatomy · Agent types · MCP · Multi-agent · Where to apply ·
  Client stack · Server infra · Gateway · Routing · Tracking ·
  Optimization · Evals · MVP → Production

ACT IV · DESCENT — The Action              (slides 23–24)
  How to start tomorrow · Closing

構成のルール:

  • 事例紹介はまとめます(スライド 5~9)。検討事項の間に挟んではいけません。
  • 事例紹介はそれぞれ2 枚のスライドで構成します。ストーリーと教訓(具体的な失敗要因または成功のポイントを 4 つ)。「なるほど」と思わせるポイントが生まれるのは教訓のスライドです。
  • 検討事項より先にストーリーを提示します。どうすれば実現できるかの前に、なぜ重要なのかを理解してもらう必要があります。
  • お客様のアジェンダにない内容は、たとえ気に入っていても削ります。(NICE 向けデッキで削除した例:ROI の計算、経営陣向けの提案、スキル対エージェント対機能対製品、陳腐化チェック。)

ステップ 4 — ケーススタディのトリプレット(失敗+成功+参考例)

常に、実在し、公開され、検証可能な3つの事例を軸にします。

役割内容NICE のデッキで使用されている例
失敗最も資金を集め、最も注目を浴びたものの、頓挫した AI/エンタープライズプロジェクトです。具体的な失敗点を挙げます。IBM Watson Health(11年間で40億ドル、支援した患者は0人)
注意点のある成功実際に成功したものの、軌道修正が必要だった事例です。成功には謙虚さが必要だと示します。Klarna AI Assistant(正社員700人分を置き換えた後、一部を再雇用)
参考例聴衆がすでに知っている、または利用している現行の本番事例です。ボーナス:講演を主催する企業。NICE Cognigy(NICE が2024年に買収)

リスクを示す場面で使える検証可能な統計(実際の数値で、出典を示せます。覚えておきましょう):

  • MIT NANDA「State of AI in Business 2025」(2025年8月):生成 AI パイロットの**95%**が、測定可能な損益への影響をもたらせていません。
  • Gartner(2024年半ばの予測):2025年末までに、概念実証後に生成 AI プロジェクトの**30%**が中止されます。
  • BCG「Build for the Future 2024」:実際に AI から価値を生み出している企業は**26%**です。
  • McKinsey「State of AI 2024–2025」:生成 AI によって実際に利益を得ている組織は4社に1社です。
  • IBM Watson Health については、STAT NewsおよびUniversity of Texas System Audit(2017年)。
  • Klarna のプレスリリース(2024年2月27日)および Bloomberg/Fortune の報道(2025年5月)。

統計を捏造しないでください。 出典を示せない場合は、偽の出典を付けた数値ではなく、経験則を使います。


ステップ 5 — ビジュアル言語

デッキのすべての配色、タイポグラフィ、シグネチャーコンポーネント、アニメーションのデフォルト設定は、**yuv-design-system**を引き継ぎます。まず、以下のセクションを読んでください。

  • yuv-design-system §1 — 配色モード(デフォルトは Fly High、ブランドファミリー向けは Warm Editorial)
  • yuv-design-system §2 — タイポグラフィ(英語は Anton + Inter、ヘブライ語は Rubik + Assistant、デフォルトの文字間隔は0)
  • yuv-design-system §6 — シグネチャーコンポーネント(PurpleBar、YellowUnderline、FlightHUD、CompassDial、CounterUp、HeroBg)
  • yuv-design-system §7 — アニメーションのデフォルト設定と Hyperframes との互換性
  • yuv-design-system §3 — ブランドアセット(ウォーターマーク用のロゴワードマーク、自己紹介スライド用のプロフィール写真)

このスキルで独自に定めるのは、トークデッキ特有の要素、つまりナラティブの流れ、ジャーニーインジケーター、シネマティック・フライトのオプションモード、デッキ固有の登場アニメーションだけです。それ以外は、デザインシステムを参照してください。

デフォルトモード:Fly High(紫)

Fly High は、すべてのデッキのデフォルトです。yuv-design-system §1 より:

:root {
  --yuv-purple:      #5E17EB;   /* act-slide backgrounds, vertical accent bars, journey trail */
  --yuv-purple-dark: #3D0DA8;
  --yuv-yellow:      #FFEC00;   /* loud accent only — never a background */
  --yuv-grey:        #F1F2F2;   /* content-slide background */
  --yuv-white:       #FFFFFF;
  --yuv-black:       #000000;
}

背景色は2色のみのルール(yuv-design-system で定められた必須ルール):

  • アクトスライド(表紙、セクション区切り、ヒーロー統計、クロージング)— 紫の背景、白い見出し、大きな Anton 書体。
  • コンテンツスライド(情報、エビデンス、リストなど、それ以外のすべて)— ライトグレーの #F1F2F2 背景、黒い見出し。

3色目の背景色は使いません。例外はありません。黄色はアクセントであり、背景色にはしません。

yuv-design-system §6 の <PurpleBar>、<YellowUnderline>、<FlightHUD> コンポーネントは、デッキを象徴するビジュアル要素です。これらを使ってください。

オプションモード:cinematic-flight(スカイブルー+ホットピンク)

トークの中心的な比喩が文字どおりの飛行である場合に限り使用します(つまり、すべてのスライドが飛行の流れを取り入れる「Build Agents That Ship」NICE デッキのような場合です)。ほとんどのトークでは Fly High を使います。

const cinematicFlight = {
  bg: '#dceaf6',        // sky-blue base
  text: '#1a1814',      // charcoal
  accent: '#ff3b8a',    // hot pink — the trail color
  yellow: '#ffd76e',    // soft sun
  cloudWhite: '#ffffff',
  skyDeep: '#7ab0d4',
  warmGray: '#6b7a8a',
  red: '#c8403d',       // failure indicators
  green: '#2f7d4f',     // success indicators
  shadow: 'rgba(80, 120, 180, 0.20)',
  hairline: 'rgba(26, 60, 100, 0.18)',
};

cinematic-flight モードでは、JourneyBar の軌跡を --accent(ホットピンク)に変更し、アクトスライドの背景には紫の代わりにスカイブルーを使います。それ以外(Anton + Inter のタイポグラフィ、JourneyBar の構造、ナラティブの流れ、文体ルール、再利用可能なテンプレート)はすべて同じです。

JourneyBar — 統一感を生み出すシグネチャー要素

これは、すべてのスライドの上端に配置される、yuv-decks で最も強力な統一要素です。

DEPART · [host company] から ARRIVE · [outcome] までを結ぶ、細い破線の飛行ルートです。デッキの進行に合わせて実線の軌跡が伸びていきます(アクティブなパレットのアクセントカラーを使用します。Fly High では紫、cinematic-flight ではホットピンク)。現在位置には小さな ✈ 飛行機アイコンがあり、ピッチが動的に変化します。

  • Act I Boarding → 90°(水平、地上滑走中)
  • Act II Ascent → 58°(機首を上げ、上昇中)
  • Act III Cruise → 90°(水平、巡航中)
  • Act IV Descent → 115°(機首を下げ、降下中)

アクトの境界には3つの終端ドットを配置します。バーの下にはフェーズラベルを表示します:II · ASCENT 2/4。

映画のような背景(フルブリードの nano-banana)

動画以外のすべてのスライドに、不透明度100%のフルブリード nano-banana 画像を使用します。以下の要素を含みます。

  • Ken Burns パンアニメーション(yuv-cinematic-pan、22s、scale 1.04 → 1.06、translateX ±12px)
  • テキストの読みやすさを保つ方向性のある骨白色のグラデーション(textZone: 'left' | 'right' | 'bottom')
  • 映画のような画像の上に浮かぶ白いコンテンツカード
ページの登場アニメーション
@keyframes yuv-page-enter {
  0%   { opacity: 0; transform: scale(1.06); filter: blur(10px); }
  60%  { opacity: 1; }
  100% { opacity: 1; transform: scale(1); filter: blur(0); }
}

すべてのスライドは、0.65秒の拡大・焦点ぼかし効果で登場します。映画のカットのような印象です。


Step 6 — 連携スキル(どのスキルをいつ呼び出すか)

このスキルは、ほかのスキルをオーケストレーションします。適切なタイミングで呼び出してください。

スキル呼び出すタイミングできること
yuv-design-system常時 — Step 5 およびパレット、書体、コンポーネントに関する判断時ビジュアルブランドの信頼できる情報源です。ここからパレットのトークン、書体のルール、シグネチャーコンポーネント、ブランドアセット、ソーシャルリンクのフッターを取得します。
slide-authoringStep 6 以降 — JSX を記述するときオープンスライドの必須ルール:ファイルの契約、1920×1080 のキャンバス、縦方向の予算計算、アセットのパス。
nano-banana-pro(または anthropic-skills:nano-banana-2)Step 5 の後 — 主要な各スライド向けに、映画のようなヒーロー画像や雰囲気画像を生成するとき。GEMINI_API_KEY が必要です。画像生成。以下のプロンプトテンプレートを使用してください。
hyperframesインパクトの大きい動画演出を4〜5箇所入れるとき(カバーのイントロ、ビッグナンバーの登場、ケーススタディのタイムライン、締めくくりの演出など)HTML/CSS/GSAP による動画構成から MP4 をレンダリングし、スライド内に <video> として埋め込みます。
mermaid-diagramsSVG を使うほどではない技術アーキテクチャ図を作成するとき見やすいフローチャートやシーケンス図。
Excalidraw MCP(create_view)デザインの相談中に、チャット内でユーザーに見せる手描き風のワークフロー図を作成するときインタラクティブな Excalidraw レンダリング。
video-edit / yuv-viral-video講演に埋め込みが必要な、事前収録の自撮り映像が含まれる場合動画編集パイプライン。
nano-banana プロンプトテンプレート

アクティブなビジュアルモードに合わせて、2つのスタイルから選びます。

Fly High モードの場合(デフォルト):

[Scene description — 1–2 sentences, 16:9 cinematic frame, single focal subject]

STYLE: Cinematic editorial poster, electric-optimism dev-keynote aesthetic.
Vibrant. Luminous. Deep purple (#5E17EB) primary tones, electric yellow (#FFEC00)
warm accent lighting, near-black (#000000) shadows, soft grey (#F1F2F2) negative
space. Sharp lighting contrast. Generous space for typography overlay.
Movie poster, not infographic. NO TEXT. NO LOGOS. NO READABLE LETTERS.

cinematic-flight モードの場合:

[Scene description — 1–2 sentences, 16:9 cinematic frame, single focal subject]

STYLE: Cinematic editorial poster meets aviation-noir aesthetic. Vibrant. Luminous.
Dark moody background with neon-glow accents. Hot pink (#ff3b8a) as primary luminous
accent, soft sun yellow (#ffe066) as warm glow, sky blue (#7ab0d4) deep tones,
charcoal (#1a1814) shadows. Sharp lighting contrast. Generous space for typography
overlay. Movie poster, not infographic. NO TEXT. NO LOGOS. NO READABLE LETTERS.

常に、焦点となる被写体は1つだけにします(モンタージュにはしません)。フレームの3分の1はタイポグラフィ用の静かな空にし、テキストを入れないよう明示します。


Step 7 — open-slide フレームワークのルール

open-slide フレームワークのルールはすべて slide-authoring に記載されています。

  • ファイルの契約(export default [Page, …] satisfies Page[])
  • 1920×1080 のキャンバス、絶対 px 値のみ
  • デッキごとに index.tsx は1つ、アセットは slides/<id>/assets/ 以下に配置
  • 新しい依存関係は禁止(react と標準 Web API のみ)
  • 縦方向の予算計算(すべてのページを 1080px に収める必要があります — 箇条書きは改行してはいけません)
  • overflow: auto は使用しない

ページの JSX を記述する前に、slide-authoring を最初から最後まで読んでください。yuv-decks のルールはフレームワークのルールに追加されるものであり、これらを上書きすることはありません。


Step 8 — 再利用可能なテンプレート(これらのパターンをコピー)

build-agents-that-ship デッキには、再利用可能なコンポーネントテンプレートが4つあります。新しいデッキにコピーしてください。

UseCase — ピル、見出し、箇条書き、指標カードを含む検討スライド

Act III の検討スライド(10–22)で使用します。2カラムのグリッドで、左側にテキスト、右側に影をずらした指標カードを配置します。映画のような見た目にするための、任意の bgImage と cinematicBg に対応しています。

CaseStudy — 失敗/成功/参考事例を伝えるストーリーアークスライド

3つの事例紹介に使用します。上部にはステータスピルと期間を配置します。会社名を大きく表示します。その下にタグライン(「Klarnaはスウェーデン最大のフィンテック企業です……」)を置きます。左側に4つのファクト行、右側に画像/動画、重要な転換点のボックス、教訓カード、出典ストリップを配置します。

LessonsGrid — 「失敗/成功した理由」を示す4枚カードのパターン

各事例紹介の直後に使用します。見出し、2×2のグリッドに並べた番号付きカード4枚、色付きの要点ストリップ(「ここで覚えておきましょう · …」)で構成します。

JourneyBar — 各スライド上部の飛行経路インジケーター

全体をまとめる要素です。破線の全経路、現在の%まで塗りつぶされた実線の軌跡(Fly Highでは紫、cinematic-flightではホットピンク)、3つの終点ドット、フェーズに応じた角度の飛行機アイコンを描画します。

AtmosphericBg — cinematic モードの背景
<AtmosphericBg src={img} cinematic textZone="left" />

これらのテンプレートの完全なソースは、参照リポジトリの slides/claude-cowork-enterprise/index.tsx にあります。そのままコピーしてから調整してください。


Step 9 — 12ステップの構築ワークフロー

1.  Get the customer's agenda (literal bullets). Map slides 1:1.
2.  Bootstrap: npx @open-slide/cli init <slug> && cd <slug> && npm install && npm run dev
3.  Ask the 5 scoping questions (Step 1). Lock in answers — including visual mode.
4.  Draft the 4-act outline (Step 3). Confirm with user before writing JSX.
5.  Write all slide components in a single index.tsx under slides/<deck-id>/.
    Use the reusable templates (UseCase, CaseStudy, LessonsGrid).
    Pull palette tokens + signature components from yuv-design-system.
6.  Add JourneyBar with PHASES matching your 4 acts.
7.  Invoke nano-banana-pro: generate ~10 cinematic atmospheric images
    (one per major slide, using the mode-appropriate prompt template).
    Save to slides/<deck-id>/assets/.
8.  Invoke hyperframes for 4–5 video moments (cover intro, hook reveal,
    case-study timelines, closing). Render to MP4, drop into assets/.
9.  Wire images and videos into slides. Use AtmosphericBg cinematic for
    images, full <video> for the dramatic moments.
10. Verify in browser: walk every slide. Check vertical budget. Check
    that no bullet wraps. Check that fonts loaded.
11. Iterate with the customer. EXPECT 5+ redirects. Don't fight them —
    each one improves the deck.
12. Push to a private GitHub repo BEFORE the talk so it survives a
    laptop failure. Include a README with clone-and-run instructions.

Step 10 — 反パターン(見栄えはよくても失敗するもの)

  • ❌ 割り算の式を使ったROI計算 → 平易な言葉で表現します(「元は取れましたか?=得られたもの ÷ かかった費用」)。
  • ❌ 「構築すべきですか?」を4つの箇条書きで示す → 2×2の象限マトリックスを使います(ボリュームの高低 × 反復的/創造的)。視覚的なマトリックスは、文章より10倍明快です。
  • ❌ ハッカソンのデッキに経営陣向けの提案スライドを入れる → 削除します。対象者が違います。
  • ❌ 飛行の比喩を使わない講演にcinematic-flightを使う → デフォルトではFly Highの紫を使います。cinematic-flightは、文字どおりの飛行がストーリー展開となる講演に限って使用します。
  • ❌ すべてのスライドに同じテンプレートを使う → 統一感は出ますが、退屈です。スライドごとにシネマティックな背景を加え、多様性のある統一感を出します。
  • ❌ 開発者向けの講演で、捏造した統計を引用する → 経験則を使うか、その数字を完全に削除します。
  • ❌ EBIT、PoC、RAG、BYOCを定義なしで並べる → 聴衆は30秒以内に話についていけなくなります。
  • ❌ 「Watsonが失敗したのは、方向性が一致していなかったからです」 → 抽象的すぎます。具体的に説明します。「教科書の事例でトレーニングされていました。実際の患者は教科書には載っていません。」
  • ❌ 箇条書きのテキストが折り返されるレイアウト → 短くするか、分割します。
  • ❌ はみ出したコンテンツを隠すためにoverflow: autoを使う → キャンバスはスクロールしません。切り取られたコンテンツは表示されません。
  • ❌ 1枚のスライドに複数のAnton要素を重ねる → yuv-design-system §6「スライド/セクションにつきAnton要素は1つ」を参照してください。

Step 11 — DECK-PLAYBOOK.mdファイル

足場を作った後、プロジェクトのルートにDECK-PLAYBOOK.mdを配置し、登壇者が個人的なメモを追加できるようにします。プレイブックのセクション10は、講演後に登壇者が記入するためのTODOチェックリストになっています。

  • 会場でうまくいったことは?
  • 次回は何を変えたい?
  • 意外だったことは?

各デッキが次のデッキへのフィードバックになります。10回のセッションを終える頃には、プレイブックのほうが登壇者の意識的な記憶より正確になっています。


Step 12 — リポジトリ構成(成果物)

<deck-slug>/
├── package.json               # @open-slide/core ^1.1.0
├── package-lock.json          # locks exact versions (commit this)
├── README.md                  # clone-and-run instructions
├── DECK-PLAYBOOK.md           # this skill, distilled for the speaker
├── AGENTS.md / CLAUDE.md      # symlinked open-slide rules + playbook link
├── open-slide.config.ts
├── slides/
│   └── <deck-id>/
│       ├── index.tsx          # ALL slides in one file (typically 22–24)
│       └── assets/            # *.mp4 (videos) + *.png (nano-banana images)
└── .gitignore                 # node_modules, .env*, .DS_Store

講演の前に非公開のGitHubリポジトリへプッシュします。

gh repo create <user>/<deck-slug> --private --source=. --remote=origin --push \
  --description "..."

参照実装

このスキルで説明するパターンは、以下に実装されています。

https://github.com/hoodini/build-agents-that-ship(非公開 — アクセス権がある場合はクローンしてください)

このリポジトリには以下が含まれています。

  • 1つのindex.tsx内に本番用スライド24枚(約3000行)
  • HyperFramesでレンダリングしたMP4動画5本
  • nano-bananaによるシネマティックな背景14点
  • 再利用可能なテンプレート(UseCase、CaseStudy、LessonsGrid、JourneyBar、AtmosphericBg)
  • このスキルの基になったDECK-PLAYBOOK.md

このスキルで説明されているパターンの実装方法がわからない場合は、そのリポジトリ内の対応するファイルを読んでください。

締めくくりの原則

スライドは聴衆のためのものであり、話し手のためのものではありません。

声、ストーリー、ビジュアル、動き――あらゆる磨き込みは、聴衆に旅をしていると感じてもらい、教訓を自分のものとして持ち帰ってもらい、話し手が聴衆の時間と知性を尊重していると伝えるためにあります。

「聴衆の心にひらめきの種を落とせるか」というテストに合格しないスライドは、削るか書き直してください。企業のプレゼンではなく、ハリウッド映画を。要約ではなく、ストーリーを。箱ではなく、飛翔を。

コメント