Communitygithub.com

Web Video Presentation

一篇文章或口播稿を、クリック駆動の16:9ウェブプレゼンテーションに変換します。オプションで音声合成も可能。

Web Video Presentation とは?

このスキルは、テキストコンテンツ(記事や台本)をインタラクティブな「動画風ウェブページ」に変換するための包括的なフレームワークです。Vite + React + TypeScript をベースに、クリックごとに口調のビートを進める16:9のフルスクリーンプレゼンテーションを生成します。主なワークフローは、コンテンツ作成(スクリプトとアウトラインの生成)、ユーザーとの5項目(台本、アウトライン、テーマ、素材、開発モード)のアライメント、チャプター単位のウェブ開発(逐次確認/順次/並列)、そしてオプションの音声合成(MiniMax、OpenAI TTS、ElevenLabsなど複数プロバイダ対応)です。特筆すべきは、アニメーションはチャプター開発時に「コンテンツ駆動型」で設計され、事前にアウトラインで固定しない点です。これにより、各チャプターが真のビデオ感覚を備え、単なるスライドやPPTの枠を超えた表現が可能になります。教育、製品デモ、YouTube/Bilibili向け録画チュートリアルなど、動画コンテンツの制作効率を大幅に向上させます。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/YuukiMarine/websiteskills/tree/HEAD/skills/web-video-presentation

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Web Video Presentation は何をしますか?

記事や台本を、録画可能な「動画に偽装したウェブページ」に段階的に変換します。オプションで音声合成も可能。出力物 = Vite + React + TS プロジェクト + チャプターごとに分割された音声ファイル。

適用シーン

  • 「台本や記事を動画にしてほしい」—— ナレーションドリブンのコンテンツ
  • 「動的PPT」を作りたい
  • 16:9 横長録画、大きな文字、余白、各画面に動きが欲しい
  • 教育 / 製品デモ / Keynote に映画的な質感を求めたい
  • Bilibili / YouTube / TikTok 向け動画コンテンツ

本スキルは方法論とコラボレーションフローを中核としています。ひな形テンプレートはトークンとプリミティブを提供しますが、すべての美的判断(配色、フォント、アニメーションの雰囲気)は、あなたのテーマに合わせて再設計されるべきです。決してそのまま流用しないでください。


ワークフロー概要

Phase 1   コンテンツ作成
   1.1  ユーザー入力を認識
   1.2  一度に script.md + outline.md を生成
        (台本 + 開発計画)
   ▼
[Checkpoint Plan]      ← 必ず停止。5項目を一度にアライン:
                         台本 / アウトライン / テーマ / 素材 / 開発モード
   ▼
Phase 2   ウェブ開発
   2.1  スキャフォールディング(選択テーマに基づく)
   2.2  第1章 = メインスレッド + 完全版(強制アンカー)
        ▼
        [ハードノード] ユーザーによる第1章の承認 ← スキップ不可
        ▼
   2.3  第2〜N章(選択したモードに従う:A 逐次確認 / B 順次 / C 並列)
   ▼
[Checkpoint Audio]     ← 必ず停止。音声合成するか?
   ▼
Phase 3   音声合成(オプション)
   ▼
Phase 4   録画 + ポストプロダクション

作業ディレクトリの約束(エージェントはユーザーの現在のディレクトリに作成/編集します):

my-video/
├── article.md          # ユーザーが元記事を提供した場合に必須 — 削除しない!開発段階の画面情報源
├── script.md           # 必須:元の言語を保持したプラットフォーム向け台本(拍を決定)
├── outline.md          # 必須:開発計画(チャプター分割 + 各ステップの内容 + 情報プール)
└── presentation/       # スキャフォールディングで生成された Vite + React + TS プロジェクト
    ├── src/chapters/<NN>-<id>/
    │   ├── <Chapter>.tsx     # ビジュアル実装
    │   ├── <Chapter>.css
    │   └── narrations.ts     # ★ ステップ数 + 台本テキストの唯一の真実源
    ├── scripts/
    │   ├── extract-narrations.ts   # すべての narrations.ts をスキャン → audio-segments.json
    │   ├── synthesize-audio.sh     # provider-agnostic ランナー(segments をループ)
    │   └── tts-providers/          # プロバイダごとに 1 つの .sh(デフォルトで 2 つ内蔵)
    │       ├── README.md           # 3関数契約 + 5つの既製コードスニペット(11labs / edge-tts / say / azure / gcloud)
    │       ├── minimax.sh          # デフォルトプロバイダ、mmx-cli を使用
    │       └── openai.sh           # 内蔵 OpenAI TTS(curl + OPENAI_API_KEY)
    ├── audio-segments.json         # extract の出力(合成前にレビュー)
    └── public/audio/<id>/<N>.mp3   # オプション:合成された音声ファイル

重要:narrations.ts はステップ数と音声合成の唯一の真実源です。 チャプター .tsx 内の if (step === N) で出現する最大 N + 1 は、 narrations.length と等しくなければなりません。これにより、5箇所(script / outline / チャプターコード / chapters.ts / 音声ファイル)が決して乖離しないことが保証されます。


ハードな自己チェックプロトコル(スキル全体を通して)

以下の3つの成果物は、それぞれ完了後に必ず自己チェック → 修正 → 報告/進行を行わなければなりません:

成果物チェックリストの出典
script.mdSCRIPT-STYLE.md 3層チェック(形式 / 骨子 / 読み上げ)
outline.mdOUTLINE-FORMAT.md チェック
単一チャプター実装完了CHAPTER-CRAFT.md 完了時チェック

実行方法(能力の高い順、より分離された方法を優先):

  1. Agent Teams(最適):独立したレビューアエージェントを起動し、「成果物ファイルパス + 対応チェックリスト + 関連コンテキスト」を与え、各項目をチェックさせ、厳密に結論を報告させる(何が PASS / 何が FAIL + 証拠 + 書き換え提案)。
  2. subAgent(次善):Teams 機能がなくても subagent を起動できるなら、同様のプロセスで実行。
  3. 自己チェック(最終手段):現在のエージェントに上記の能力がどちらもない場合、自分で厳密に項目ごとにチェックする — 目視で確認してスルーすることは許されない。

鉄則:結論を得たらまず FAIL 項目を修正し終えてから、ユーザーに「完了しました + チェック結論 + 修正点」を報告してください。結論をそのまま報告して修正しない = 違反です。


各フェーズのファイル読み込みガイド

フェーズによって読むファイルが異なります。長いセッションではエージェントは原則を忘れがちです。特に Phase 2.4 の「単一チャプター実装」は N 回繰り返されるため — 毎回コア制約を再確認してください。

フェーズ必読(毎回読む)一度読んで / 必要に応じて参照
Phase 1.1-1.2 コンテンツ作成references/SCRIPT-STYLE.md + references/OUTLINE-FORMAT.md + article.md(ユーザー原文があれば)—
Checkpoint Plan テーマ選択—themes/*/theme.json(すべて動的に読み、一覧 + bestFor 推奨 + descriptionZh を提示);references/THEMES.md(ユーザーがテーマシステムを詳しく知りたい場合)
Phase 2.1 スキャフォールディング—SKILL.md 当該セクションを一度読む
Phase 2.4 単一チャプター実装(N 回、2.2 / 2.3 から呼ばれる)references/CHAPTER-CRAFT.md 単一エントリポイント — パート0 10原則 / パート1 着手時の5つの質問 / パート2 関係→アクション決定木 / パート3 ビジュアルツールボックス / パート4 時間配分の参考 / パート5 反AI臭アンチパターン / パート6 コードのハードルール(narrations.ts の強制制約を含む)/ パート7 完了時チェック / パート8 フィードバッククイックリファレンス + 現在のテーマ themes/<id>/theme.json + 現在のチャプターの outline.md 段落 + article.md の該当チャプター段落 + 素材一覧references/EXAMPLES/(構造の参考。コピーするテンプレートではありません);references/THEMES.md 完全なトークン契約
Phase 3 音声合成references/AUDIO.md(narrations.ts → segments.json → 任意のプロバイダフロー、minimax + openai 内蔵)templates/scripts/tts-providers/README.md(プロバイダ変更 / 独自 TTS 時)
Phase 4 録画 + ポストプロダクションreferences/RECORDING.md(?auto=1 自動録画を含む)—
テーマの選択 / 作成 / 切り替え—references/THEMES.md

チャプター作成時は CHAPTER-CRAFT.md だけを読んでください。10原則 / 着手時のセルフプロンプティング / 決定木 / 反AI臭アンチパターン / 完了時チェックがすべてこの単一エントリポイントに統合されています。EXAMPLES/ は必須ではありません — まずコンテンツに基づいて自由に設計し、行き詰まったら参照してください(アンカーとして「形」を参照し、そのままコピーしないでください)。


Phase 1 — コンテンツ作成(一度に生成)

1.1 ユーザー入力の認識

ユーザーが提供するものすべきこと
元記事(書き言葉 / WeChat公衆号 / 論文 / ブログ)一度に script.md + outline.md を生成(1.2)、Checkpoint Plan へ
直接の台本 / 動画スクリプトscript.md として保存、一度に outline.md を生成(1.2 簡略版)、Checkpoint Plan へ
何もなく、「Xというテーマの動画を作って」とだけ言う逆質問:最初に何らかの素材やアウトラインを提供してもらう。スキルはユーザーに代わってコンテンツを構想しない

1.2 一度に script.md + outline.md を生成

2つの成果物を一度の思考で完了:

  1. script.md を生成:references/SCRIPT-STYLE.md のルールに従い、記事を元の言語を保持したプラットフォーム向け台本に変換します。article.md は削除せず保持 — アウトラインの情報プールやチャプター実装時の画面詳細のソースとなります(二重ソース原則)。
  2. outline.md を生成:references/OUTLINE-FORMAT.md のルールに従い、チャプターを分割 + ステップを分割 + 各チャプターの最初の段落から情報プールを抽出します。

アウトラインの境界(重要):

アウトラインに書くことアウトラインに書かないこと
チャプター分割 / 各チャプターのステップ数 / 推定時間具体的なアニメーションタイプ(blur clear / wipe / スプリング)
各ステップの画面内容(ヒーロー / データ / キャッチコピー / リスト項目)CSS 実装手段(filter / SVG / clip-path)
チャプターレベルの情報プール:article から抽出した数字 / 引用 / 事例 / タグ時間数値(2.5s / 80120ms などは書かない)
ステップレベルの関係名プレフィックス(「コントラスト対照」 / 「段階的リスト」 / 「金言」など、オプションのヒント)持続的な微動 / オフセット量などの微細なリズム

アウトラインにアニメーションを書かない理由:アニメーションを固定すると、チャプターエージェントが翻訳機に退化します。 空白を残すことで、チャプターエージェントは各ステップの着手時に CHAPTER-CRAFT.md の「コンテンツ駆動型決定木」に従って自由に設計でき、真のビデオ感覚が生まれます。詳細は CHAPTER-CRAFT.md パート0 原則7 を参照。

保存後、Checkpoint Plan に進む前に必ず自己チェックを実行:上記「ハードな自己チェックプロトコル」に従い、 script.md / outline.md に対してそれぞれ実行し(優先順位 Agent Teams → subAgent → 自己チェック)、 結論に基づいて修正が完了してから Checkpoint Plan に進んでください。


Checkpoint Plan — 5項目を一度にアライン(ハードノード)

script.md + outline.md の作成後、必ず停止します。ユーザーはこの1つのノードで同時に5項目を確認します。

エージェントがこの時点で行うべき準備作業

  1. すべての themes/*/theme.json を読み、nameZh / descriptionZh / bestFor / mood を取得 — 一覧をハードコードしないでください
  2. script.md のコンテンツタイプ / キーワード / トーンに基づき、能動的にテーマから2〜3つ 最もマッチするおすすめを選びます(bestFor フィールドにマッチさせる)
  3. outline.md 末尾の「素材一覧」セクションをざっと確認

サマリーテンプレート(骨格。エージェントが状況に応じて埋める)

コンテンツ計画が完了しました。出力ファイル:
  📄 article.md     {ユーザーが元記事を提供した場合に保持}
  📄 script.md      {X} 文字 / 約{T} 分
  📄 outline.md     {N} チャプター / {M} ステップ + 各チャプター情報プール + 末尾素材一覧

チャプター概要:
  1. <id>     <チャプタータイトル>    <S> ステップ 約<T>s
  2. ...

次に、5項目を一度に確認します:

  1. 台本 (script.md) は修正しますか?
     ファイルを直接編集するか、口頭で修正の方向性をお知らせください。

  2. 開発計画 (outline.md) は修正しますか? 重点的に確認する点:
     - チャプター分割 / ステップ数 / 推定時間は妥当か(妥当の目安:各チャプター30〜60s)
     - 各ステップの画面内容は明確か
     - 各チャプター最初の段落の「情報プール」に、画面描写に十分な article の詳細があるか
     - 末尾の素材一覧は完全か

  3. どのテーマを選びますか? 私のおすすめ:
     ★ <おすすめ1:nameZh (id)> — <bestFor がマッチした理由>;<descriptionZh の概要>
     ★ <おすすめ2 / おすすめ3>
     その他のオプション:<残りのテーマ、nameZh + 一言説明>
     新しいテーマを作成することもできます(詳細は references/THEMES.md を参照)。

  4. 実際の素材はどう準備しますか? この動画に必要と思われる画像の大まかなリスト:<粗略なリスト>
     a) 私が <既存の素材パス> から選びます   b) ご自身でご提供ください   c) すべてプレースホルダー

  5. 開発モードはどれを選びますか?

     **第1章はどのモードでもメインスレッドで完了 + ユーザー承認が必要です**(強制アンカー)。
     違いは第2章以降にあります:

     A) デフォルト · 逐次確認(推奨)
        各チャプター完了ごとに停止して承認 → リスク管理可能 / リズムが最も安定
     B) 第1章後、順次開発(並列なし)
        第2〜N章をメインスレッドで順次完了後、一括で承認 → 速度は中程度 / エージェントが並列処理をサポートしない環境に適する
     C) 第1章後、並列開発(subagent)
        第2〜N章を subagent で並列処理 → 最速 / ユーザーが並列数を制御(一度に数チャプター)
        ⚠️ 各チャプターでスタイルにばらつきが出ます(これは想定内です。テーマトークンが下限を保証します)

フィードバック受領後:

  • 台本 / アウトラインを修正する場合:ファイルを直接編集し、編集後に pings する(または口頭で説明しエージェントが修正)
  • テーマは明確になっている必要がある。Phase 2 に進むには必須。ユーザーが「テーマはあなたが選んで」と言った場合 → あなたのおすすめの1番目を選択し、 何を選んだか、なぜかをユーザーに伝え、変更の機会を与える
  • モードが決定 → Phase 2 へ

Phase 2 — ウェブ開発

2.1 スキャフォールディング

bash <path-to-web-video-presentation>/scripts/scaffold.sh \
  ./presentation \
  --theme=<ユーザーが選んだテーマの id>

bash <path-to-web-video-presentation>/scripts/scaffold.sh --list-themes

カスタムテーマの場合 → まず references/THEMES.md 「新しいテーマの作成」フローに従い themes/<my-theme>/ を作成し、その後 --theme=<my-theme> を指定。

スキャフォールディングには 01-example デモが含まれています。最初のチャプターの実際の内容を書き始める前に削除してください:

rm -rf presentation/src/chapters/01-example

また、presentation/src/registry/chapters.ts から EXAMPLE_CHAPTER のインポートと配列要素を削除します。

2.2 第1章 — メインスレッド + 強制承認

コア:第1章 = 完全版を一度に作成(リズム + ビジュアル + 実際の素材がすべて揃っている)。 「スケルトン版」という概念はありません — 第1章でユーザーが直接承認できるサンプルを作る必要があります。

なぜ第1章はメインスレッドでなければならないのか:

  • これは CHAPTER-CRAFT.md のガイダンスを現在のテーマ + 現在の題材で初めて適用する場です
  • ガイダンスに盲点があったり、テーマの色 / フォントトークンが不十分だったりすると、第1章で必ず顕在化します — この時点で人間のフィードバックを受けてガイダンスを修正したりテーマを調整したりできます。早期発見が最もコストが低いです
  • 後続のチャプター(順次であれ並列であれ)は第1章のコードパターンを参考にするため、第1章 = 今回のプロジェクトの「スタイルアンカー」となります(チャプター間の完全な統一は強制しませんが、単一チャプター自体に完全な説得力が必要)

第1章完了後は必ず停止し、ユーザーの承認を待ちます:

第1章 <id> が完了しました。dev server は localhost:5173 で動作中です。

承認時の確認ポイント:
  □ ビジュアルの雰囲気は合っていますか? <theme nameZh> の期待に沿っていますか?
  □ リズムは適切ですか? 特定のステップが速すぎる / 遅すぎる / 情報が薄すぎることはありませんか?
  □ コンテンツ駆動型アニメーションは適切ですか? それとも、何も考えずにステップインアニメーションを使用しているステップはありませんか?
  □ 二重ソース原則:画面上に「ナレーションでは語られていないが article に基づいている」詳細はありますか?
  □ 反AI臭チェック:紫からピンクのグラデーション / 角丸カラーボーダー / フェイクイラスト / emoji は使用されていませんか?

問題があれば教えてください。ピンポイントで修正します。問題なければ「続けて」とお伝えください。選択されたモードに従い、第2章以降を作成します。

2.3 第2〜N章 — 選択されたモードに従う

すべてのモードに共通するルール:各チャプターは独立して CHAPTER-CRAFT.md に従い開発します。スタイルはチャプター間で完全に一致している必要はありません — テーマの色 / フォントトークンが視覚的な統一性を下限として保証し、 アニメーション / リズム / ビジュアルプレゼンテーションはチャプターが自由に創造することが設計上の意図です。

モード A · デフォルト · 逐次確認

第2章完了 → 停止して承認 → OK → 第3章 → 停止 → ... → 第N章。各チャプター を独立して承認、問題は随時修正。リスクが最も低く、リズムが最も安定です。ユーザーが明確にモードを選択しない場合、デフォルトでこれを使用します。

モード B · 第1章後、順次開発

第2章 → 第3章 → ... → 第N章をメインスレッドで順次完了し、最後に一括で承認します。 速度は中程度で、エージェントが並列タスクをサポートしない環境に適しています。

モード C · 第1章後、並列開発(subagent)

subagent を使用して第2〜N章を並列で完了します。最大並列数はユーザーが制御します(「一度に4チャプター」 / 「一度に2チャプター」)。最速ですが、各チャプターでスタイルにばらつきが出ます — これは想定内です。なぜなら:

  1. 各 subagent は他の subagent の出力を見ることができず、機械的に揃えることができない
  2. チャプターコードは物理的に分離されている(各チャプターが独自のフォルダ / 独自の CSS プレフィックスを持つ)、互いに破壊し合わない
  3. テーマトークンが視覚的な統一性を下限として保証する(色 / フォント / ヒーロー数字 / カード / 区切り線の性格 / 装飾)、雰囲気が大きく逸脱することはない
  4. スタイルの不一致 = 手書き動画の息遣い(複数の声 / 複数の視点)

並列 subagent のプロンプトには以下を含める必要があります:

  • 現在のチャプターの outline 段落(情報プールを含む)
  • references/CHAPTER-CRAFT.md のパス(単一必須読み物 — ビジュアルプレゼンテーション要件 + 段階的開示 + 二重ソース原則 + 反AI臭 + コードレッドライン + 完了時チェックがすべてこの1つに含まれている)
  • 現在のテーマ theme.json の descriptionZh / mood / bestFor(雰囲気の参考として。 アニメーション / 時間 / フォントサイズ / emoji はチャプターエージェントが自由に決定)
  • 第1章のコードを「コードスタイル」の参考として(「ビジュアルのコピー元」ではない)
  • ハードルール:各チャプターは独立した CSS プレフィックス(.cd- / .mg- / .pm- / ...)を使用すること; chapters.ts を変更しないこと;完了後に npx tsc --noEmit を実行すること

重要:どのモードを選択しても、ユーザーはいつでも途中でモードを切り替えることができます。第2章 がOKになった後、ユーザーが「残りは並列で」 / 「残りは逐次で」と言っても問題ありません。

2.4 単一チャプターの実装(各チャプターで必ず実行)

詳細なガイダンスは references/CHAPTER-CRAFT.md を参照 — 単一の必須エントリポイント、以下をカバー:ビジュアルプレゼンテーション要件 / 段階的開示 / コンテンツの取捨選択 / 二重ソース原則 / 動画プレゼンテーション基本美学 / 反AI臭 / コードレッドライン / 完了時チェック。

中核ポイント(CHAPTER-CRAFT.md で詳述):

  • 各チャプターには CSS / SVG / Canvas / JS によるビジュアルプレゼンテーションが必要、純粋なテキストチャプターは禁止
  • 段階的開示:リスト / 一覧は 1 項目 = 1 ステップとし、一度にすべて表示することを禁止
  • 二重ソース原則:リズムは台本に従う(順序を変えてはいけない)、詳細は元記事から引き出す(情報プール + 本章の article 段落)
  • 完了時チェックを項目ごとに行い、基準に達しなければ修正に戻る — 上記「ハードな自己チェックプロトコル」に従い実行 (優先順位 Agent Teams → subAgent → 自己チェック)、修正してからユーザーに本章の納品を報告する

2.5 大規模修正後の STORAGE_KEY のバンプ

chapters.ts を変更(チャプターの追加 / 削除 / 並べ替え、または特定のチャプターの narrations.ts の長さが変更)した後は、presentation/src/hooks/useStepper.ts の STORAGE_KEY をバンプします(例:v4 → v5)。これにより、永続化されたカーソルが存在しないステップにフォールするのを防ぎます。


Checkpoint Audio — 音声を合成するかどうか(ハードノード)

Phase 2 終了後は必ず停止し、ユーザーに尋ねます:

ウェブページが完成しました。{N} チャプター {M} ステップ、dev server は localhost:5173 で動作中です。

「自動再生録画」用に音声を合成しますか?
  ✓ 合成する → すべてのチャプターの narrations.ts をスキャンして audio-segments.json を生成、
           TTS プロバイダを呼び出して各ステップの mp3 を public/audio/ に合成します。
           合成後、?auto=1 モードで一発撮り録画が可能です(音声と映像は自然に同期)。
           内蔵プロバイダ:
             • minimax (mmx-cli)    — デフォルト、中国語の音声が安定
             • openai  (OPENAI_API_KEY) — curl ベース、多くのユーザーがすでにキーを所有
           その他のバックエンド (ElevenLabs / edge-tts 無料 / macOS say オフライン /
           Azure / Google) は scripts/tts-providers/README.md の既製スニペットを参照。
  ✗ 合成しない → Phase 3 をスキップし、直接 Phase 4 で手動録画 + 後編集でナレーションを追加します。

合成する場合 → Phase 3。合成しない場合 → 直接 Phase 4。


Phase 3 — 音声合成(オプション)

詳細なフローは references/AUDIO.md を参照。簡易版:

cd presentation
npm run extract-narrations   # すべての narrations.ts をスキャン → audio-segments.json
# ユーザーに audio-segments.json を一目確認させ、テキストが正しいか確認させる
npm run synthesize-audio                       # デフォルトの minimax プロバイダ、差分のみ合成
# または内蔵 openai を使用(OPENAI_API_KEY が必要):
PRESENTATION_TTS=openai npm run synthesize-audio
# またはカスタム:scripts/tts-providers/<name>.sh を作成、同ディレクトリの README.md を参照

合成が完了したらユーザーに伝える:出力場所 / 総セグメント数 / 異常な長さのセグメント(長すぎる = 当該ステップの分割が必要;短すぎる = テキストが薄すぎる)— 最後にリズムを調整する機会を与える。その後 Phase 4 へ。


Phase 4 — 録画 + ポストプロダクション

詳細は references/RECORDING.md を参照。2つのパス:

シナリオ推奨パス
Phase 3 で音声を合成済みAuto モード一発撮り:ブラウザで localhost:5173/?auto=1 を開く → SPACE キーを押す → 全体が自動再生される → 録画を停止 → 先頭と末尾をカットして完成、後編集で音声トラックを合わせる必要なし
Phase 3 をスキップデフォルト Manual モードで手動クリックして進行 → 後編集で任意の編集ツールを使用してナレーションを追加

エージェントは Phase 3 / Checkpoint Audio の後で、ユーザーに適切な録画パスを積極的に伝えてください。


10の原則(一言リスト)

完全版は references/CHAPTER-CRAFT.md パート0 を参照 — チャプター作成時はそちらを確認してください。以下はインデックスのみです。

#原則一言
116:9 固定ステージコンテンツは 1920×1080 + transform scale、レスポンシブはなし
2グローバル step カウンターチャプターは step の純粋関数、タイマーはなし
3各ステップが画面全体を占有if (step === N) return <FullScene />
4ナレーションの拍 = step一拍 = 一 step = 一つの焦点化されたアイデア
5隠れた隅のコントロールプログレスバー / ナビゲーションはデフォルトで opacity 0
6ステージにクロームは不要header / footer / ページ番号 / ブランドバーはなし
7コンテンツ駆動型アニメーションまず内在する動きを見つけ、見つからなければステップインアニメーションでカバー;持続的な微動は控えめに使用
8複数ポイントを一つずつ提示1 項目 = 1 step、N 項目を同時にスタガー表示することを禁止
9全体で同じテーマチャプター間で表面色を反転させない;色 / フォントはトークンを使用、他の尺度はチャプターが自由に決定
10二重ソース原則script が拍を決定、article が画面の密度を決定(情報プールにフォールする)

よくあるユーザーフィードバッククイックリファレンス

簡略表は references/CHAPTER-CRAFT.md パート8「よくあるフィードバッククイックリファレンス」を参照。重要:まず問題がどの層(リズム / ビジュアル / コンテンツ / コード)にあるのかを特定し、最小限の部分を修正すること。チャプター全体を作り直さないでください。


関連リソース

「いつ読むか」を明記し、一度にすべてを読まないようにします:

ファイルいつ読むか内容
references/SCRIPT-STYLE.mdPhase 1.2 必読記事 → 台本ルール、プラットフォームバリエーション
references/OUTLINE-FORMAT.mdPhase 1.2 必読outline.md フィールドスペック、命名規則、チャプター分割、情報プール
references/CHAPTER-CRAFT.mdPhase 2.4 各チャプターの単一必須エントリポイントパート0 10原則 / パート1 着手時の5つの質問 / パート2 関係→アクション決定木 / パート3 ビジュアルツールボックス / パート4 時間配分 / パート5 反AI臭アンチパターン / パート6 コードのハードルール / パート7 完了時チェック / パート8 フィードバッククイックリファレンス
references/EXAMPLES/オプション — 構造を確認チャプター構造の例(hook / list-reveal / case-tech-review);コピーするテンプレートではありません
references/THEMES.mdテーマの選択 / 作成 / 切り替え時完全なトークン契約 + 内蔵テーマ一覧 + 作成フロー
references/AUDIO.mdPhase 3 でのみ読むprovider-agnostic 音声合成フロー、内蔵 minimax の使用方法、プロバイダ変更手順、トラブルシューティング
templates/scripts/tts-providers/README.mdTTS プロバイダの変更 / 追加時3関数契約 + 内蔵2つ (minimax / openai) + 5種類の既製コードスニペット(ElevenLabs / edge-tts / macOS say / Azure / Google)
references/RECORDING.mdPhase 4 でのみ読む録画ツール + 後編集
themes/Checkpoint Plan / Phase 1.2 時に参照内蔵テーマ(各テーマは theme.json + tokens.css を含む)
scripts/scaffold.shPhase 2.1 で一度実行ワンコマンドプロジェクトスキャフォールディング

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル