Communitygithub.com

lzcjsyr/Book2Video

カスタムHyperFramesビデオコンポジションを作成するための汎用フォールバックワークフロー。長尺・マルチシーン、ブランド/シズルリール、モンタージュ、タイトルカード、静止ループ、自由形式のコンポジションに対応。入力と長さに依存しません。特定のワークフロー(製品、ウェブサイト、トピック解説、GitHub PR、既存映像、モーショングラフィック、Remotionポート)が明確に適合する場合はそちらを優先してください。

Book2Video とは?

このスキルは、HyperFramesプラットフォーム上でカスタムビデオコンポジションを作成するための汎用的なフォールバックワークフローを提供します。特定の入力タイプ(製品、ウェブサイト、GitHub PRなど)に特化したワークフローが存在する場合はそちらを優先し、このスキルはどの専門ワークフローにも当てはまらない場合にのみ使用します。ワークフローは、デザインシステムの確立、プロンプトの拡張、計画、レイアウト、アニメーションという明確なステップに従い、`hyperframes-creative`、`hyperframes-animation`、`hyperframes-core`、`hyperframes-media`といった関連ドメインスキルに処理を委譲します。特に、レイアウトをアニメーションよりも先に構築する「Layout Before Animation」アプローチと、タイトルセーフマージンを確保するためのパディング指定が重要です。また、音声(TTS、BGM、SFX)は`hyperframes-media`の統合オーディオエンジンを使用して処理されます。このスキルは、Claude Code、Cursor、CodexなどのAIエージェントと連携して動作し、ユーザーの指示に基づいて高品質なビデオコンテンツを生成します。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/lzcjsyr/Book2Video/tree/HEAD/skills/step4/general-video

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

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

ドキュメント

media-use: オーディオ/画像を調達する前に、/media-useを呼び出してHeyGenカタログからBGM/SFX/画像を取得してください。既存のアセットを登録するには、最初に--adoptを実行します。/media-useスキルを参照してください。

general-video — 汎用ビデオワークフロー

ビルドを開始する前にルートを確認してください。 これはカスタムコンポジション作成のためのフォールバックです。入力が特定のワークフローに明確に適合する場合は、そちらを優先してください:製品販売 → /product-launch-video;一般的なサイト → /website-to-video;トピック解説 → /faceless-explainer;GitHub PR → /pr-to-video;既存映像 → /embedded-captions · /talking-head-recut;短いナレーションなしモーショングラフィック → /motion-graphics;Remotionポート → /remotion-to-hyperframes。対象外:ライブ/レンダリング時データ、完成したビデオのNLEスタイル編集、またはHyperFramesがキャプチャできない映像の制作。不明な場合は、最初に/hyperframesを読んでください。

要求されたものを正確に構築します。 タイトルカードはタイトルカードです — タイトルカード+3つの補助シーン+環境音楽+キャプションではありません。追加のシーンや要素が作品を真に向上させる場合は、それらを_提案_してください。黙って追加しないでください。小さな編集(色の修正、1つの長さの調整、1つの要素の追加)の場合は、計画ステップをスキップして直接ビルドに進みます。

アプローチ

ディスカバリー — オープンエンドのリクエストのみ

漠然とした探索的なリクエスト(「ブランドのための何かを作って」「かっこいいイントロ」)の場合 — 色を選ぶ前に意図を理解します:

  • オーディエンス — 誰が見るのか? 開発者 / 経営者 / 一般消費者?
  • プラットフォーム — どこで再生されるのか? ソーシャル(15秒) / ウェブサイトヒーロー / 製品デモ / 社内用?
  • 優先順位 — 何が最も重要か? モーション品質 / コンテンツの正確さ / ブランドの忠実度 / 速度?
  • バリエーション — 1つのベストショットか、または意味のある異なる2〜3のオプション(単なる色の変更ではなく、異なるペース、エネルギー、または構造)か?

具体的なリクエスト(「タイトルカードを追加して」「シーン3のタイミングを修正して」)の場合は、ディスカバリーをスキップします。

ステップ 1 — デザインシステム → hyperframes-creative

まず視覚的アイデンティティを確立します。プロジェクトにデザイン仕様がある場合は、それを読みます(優先順位 frame.md → design.md → DESIGN.md;それをブランドの真実として扱います — 正確な色、フォント、制約)。

仕様がない場合、色やフォントを選択する前に、hyperframes-creative/references/house-style.md と hyperframes-creative/references/video-composition.md の両方を読む必要があります。 house-style.md は「プロンプトを解釈して実際のコンテンツを生成する」オープナー、遅延デフォルトリスト、レイヤーレシピを提供します。video-composition.md は、「プロデュースされた」出力と「生成された」出力を区別するビデオメディアの密度/スケール/前景ディテール(データバー、登録マーク、等幅メタデータ、「ユーザーが要求していない2つの要素を含む8〜10要素」)を提供します。片方だけを読むことは最も一般的なミスです — video-composition.md はエージェントがスキップするものであり、まさに平らで中央揃えのウェブページ的な出力を防ぐものです。パレットを自己発明してこれらをスキップしないでください。hyperframes-creative に入ることはここでは必須であり、オプションの分岐ではありません。そこから、必要に応じて名前付きスタイル/ムード → references/visual-styles.md、またはインタラクティブピッカー → references/design-picker.md も取得します。仕様/スタイルはブランドを定義し、コンポジションルールを定義するものではありません。

アングルを見つける(漠然とした概要、仕様なし): 色を選ぶ前に、1文を書きます — この名前/単語/トピックは何を呼び起こし、どのような視覚的_世界_(比喩、設定、楽器、モチーフ)がそれを表現するのか? 例:サイバーセキュリティツール → 金庫のドア / 境界スキャンライン / ロックタンブラー;瞑想アプリ → 潮の満ち引き、呼吸、ゆっくりとした光の広がり。対象の_意味_を読み、単なる文字ではありません。文字通りのリスタイルではなく、具体的なアングルを選びます。これは、シングルシーン作品でプロンプト拡張(ステップ2)の代わりとなる安価な代替手段であり、拡張が正しくスキップされる場合に使用します — これが、デザインされたコンセプトとグラデーション上の一般的なロゴとの違いです。

ステップ 2 — プロンプト拡張 → hyperframes-creative

すべてのマルチシーンコンポジションで実行します(シングルシーン作品と些細な編集ではスキップします)。リクエストをデザイン仕様+ハウススタイルに基づいて、ダウンストリームの作業が同じ方法で読み取る一貫した中間形式に変換します。hyperframes-creative/references/prompt-expansion.md を参照してください。

ステップ 3 — 計画

HTMLを記述する前に、高いレベルで考えます:

  1. 何を — 視聴者体験:物語の弧、重要な瞬間、感情的なビート。
  2. 構造 — いくつのコンポジションか、サブコンポ vs インラインか、どのトラックがビデオ/オーディオ/オーバーレイ/キャプションを運ぶか。モノリシックな単一ファイル vs モジュラーサブコンポの判断については、hyperframes-core/references/composition-patterns.md § 2つのアーキテクチャを参照してください(経験則:≥3のハードシーンカット、または再利用されるシーンがある場合 → モジュール化;短いシングルシーン作品は1ファイルのまま)。
  3. リズム — 実装する前にパターンに名前を付けます(例:fast-fast-SLOW-SHADER-hold);hyperframes-creative/references/beat-direction.md を参照してください。
  4. タイミング — どのクリップが長さを決定するか、トランジションがどこに配置されるか、ペーシング。
  5. レイアウト — 最初に最終状態を構築します(以下を参照)。
  6. アニメーション — その後、hyperframes-animation を介してモーションを追加します。

アニメーションの前にレイアウト

すべての要素を、最も見える瞬間に配置します — 完全に入力され、正しく配置され、まだ終了していない状態。まずそれを静的HTML + CSSとして記述します。GSAPはまだ使用しません。

理由: アニメーションの開始状態(画面外、スケール0、不透明度0)で要素を配置し、_着地する_と思われる場所にトゥイーンすると、最終的なレイアウトを推測していることになります — 重なりはレンダリングまで見えません。最初に最終状態を構築すると、モーションを追加する前にレイアウトの問題を確認して修正できます。

  1. 各シーンのヒーローフレームを特定します — 最も多くの要素が同時に見える瞬間。それが構築するレイアウトです。
  2. そのフレームの静的CSSを記述します。コンテンツコンテナは、絶対オフセットではなくパディングでシーンを埋める必要があります:
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px; /* パディングがコンテンツを配置します;任意のシーンサイズにフィット */
  gap: 24px;
  box-sizing: border-box;
}

コンテンツコンテナに position: absolute; top: Npx を使用しないでください — コンテンツがスペースより高い場合にオーバーフローします。絶対配置は装飾用に予約します。

⚠ 上記の width/height: 100% は、すべての祖先が解決された高さを持っている場合にのみ機能します。 ルート <div data-composition-id> とそれと .scene-content の間のラッパーはサイズ設定が必要です(ルートに position: relative; width: 1920px; height: 1080px — hyperframes-core → 「ルートはサイズ設定が必要」を参照)。これをスキップすると、フレックスコンテナは約0にcollapseし、コンテンツは左上隅に山積みになり、最初のグリフはx=0でクリップされます — その間 lint/inspect は0問題を報告します。そして、.scene-content に padding(≥80px)を常に保持します:それはタイトルセーフマージンです。決して単なる gap に置き換えないでください。

  1. エントランスを追加します — 画面外/非表示からCSS位置へ gsap.from() でアニメーションします(サブコンポジションでは、開始状態が明示されるように gsap.fromTo() を優先します;hyperframes-core/references/sub-compositions.md を参照)。CSS位置がグラウンドトゥルースであり、トゥイーンはそこへの旅です。
  2. 終了はトランジションで処理されます — hyperframes-animation/transitions/ のシーントランジションルールに従い、最終シーンのみが要素をアニメーションアウトします;シーン間ではトランジション自体が終了です。

時間を超えた共有スペース: 要素Aが同じエリアで要素Bが入る前に終了する場合でも、それぞれのヒーローフレームに対して正しいCSS位置が必要です — タイムラインの順序付けによりそれらが共存するのを防ぎ、レイアウトステップが偶発的な重なりをキャッチします。レイヤードグロー/シャドウとzスタックの深さは_意図的な_重なりです;ステップは_意図しない_衝突(2つの見出しが互いに重なる、コンテンツがフレームからはみ出す)をキャッチすることです。

ビルド — ドメインスキルに委譲する

これは、スキルの全表面(description を参照)をその参照にマッピングします — 網羅的ではありません;意図がリストされていない場合は、hyperframes-creative(外観/コンセプト)、hyperframes-animation(モーション)、hyperframes-core(契約)、hyperframes-media(オーディオ/キャプション)を経由します。最初の行は追加です — それと意図行の両方を読み、どちらか一方だけではありません。

構築するもの…最初に読むもの(順序順)
常に — すべての非自明な作品で、以下の意図行に加えてhyperframes-creative/references/house-style.md + references/video-composition.md(ステップ1 / HARD-GATEでもゲートされています;「プロデュースされ、生成されていない」前景ディテール)
キネティックタイポグラフィ / テキスト主体hyperframes-animation/techniques.md(キネティックタイプ)+ adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md
タイトルカード / ローワーサード / オーバーレイ / PiP / テキストビハインドサブジェクトhyperframes-creative/references/composition-patterns.md + (中央揃え/サイズ調整フレームの場合) hyperframes-core → 「ルートはサイズ設定が必要」
ロゴ / ブランドマークリビールhyperframes-animation/rules/svg-path-draw.md(描画)+ rules/3d-text-depth-layers.md + rules/scale-swap-transition.md
データ / 統計 / 数字hyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md
製品 / アプリ / UIデモhyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md
オーディオリアクティブ / 音楽駆動hyperframes-creative/references/audio-reactive.md(事前バンド抽出;モーションにマッピング)
ナレーション / ボイスオーバー / 音楽 / SFX / キャプションhyperframes-media → 共有オーディオエンジン scripts/audio.mjs(1回の呼び出しでTTS + BGM + SFX → audio_meta.json);キャプション作成 + アセット配置は hyperframes-core を経由。以下のオーディオを参照してください。
マルチシーン / トランジションhyperframes-animation/transitions/overview.md その後 transitions/catalog.md(概要だけでは終わりではありません — GSAPレシピはカタログにあります)
モジュラー / サブコンポジションhyperframes-core/references/composition-patterns.md + references/sub-compositions.md

オーディオ:1つのエンジン(TTS · BGM · SFX)

作品が必要とする場合のみ(「要求されたものを正確に構築する」に従い — タイトルカードに環境音楽は不要)。TTSを手動で実装したり、コピーをベンダー調達したりしないでください:ニュートラルな audio_request.json を書き、hyperframes-media の共有エンジンを呼び出します。1つのスイッチで自動的にグレードダウンします — HeyGen認証情報あり → HeyGen TTS + 音楽/SFX 取得;なし → ElevenLabs/Kokoro TTS、Lyria/MusicGen BGM 生成、およびバンドルされたSFXライブラリ。完全なフラグリスト + リクエスト/メタスキーマ:hyperframes-media/scripts/audio.mjs のヘッダーコメントを参照してください。

// audio_request.json — ナレーションセグメントごとに1行;`id` はあなたのもの(audio_metaを結合)
{
  "lines": [
    { "id": "s1", "text": "オープニングライン。", "sfx": ["whoosh"] },
    { "id": "s2", "text": "次のビート。" },
  ],
  "bgm": { "query": "穏やかなシネマティックアンダースコア" }, // "mode" を省略 → 自動(HeyGenの場合は取得、それ以外は生成);無効にするには "none"
}
# <MEDIA_DIR> = インストールされたhyperframes-mediaスキルディレクトリ(このスキルの兄弟)
node <MEDIA_DIR>/scripts/audio.mjs --request ./audio_request.json --hyperframes . --out ./audio_meta.json

その後、audio_meta.json を読み取ります:各 voices[].path +(bgm.path、sfx[])を <audio> トラックとしてマウントし、voices[].words をキャプションに使用します。すべて hyperframes-core に従います(オーディオトラック + キャプション作成)。BGMが生成パスをたどった場合(bgm_pending: true)、最終レンダリングの前に hyperframes-media/scripts/wait-bgm.mjs を実行します。

出力チェックリスト → hyperframes-cli

Individual skills in this repo

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

lzcjsyr/Book2Video

将 PDF、EPUB、DOCX 等书籍或长文档一次性转成约 4 分钟的中文读书带货短视频口播稿,以情绪共鸣、观看留存和购买欲为核心,直接输出 Book2Video 后续流程可读取的 raw JSON。用户提到读书带货、图书推广、卖书口播、商品卡、走心书单视频、情绪型读书文案或要求生成可直接进入视频流水线的带货稿时使用。

lzcjsyr/Book2Video

将长书、长文档转成中文视频号读书解说稿;先抽取文本并建立可恢复覆盖台账,覆盖自检通过后再按入口定义的正文长度生成初稿、多轮修订和最终 raw JSON。

lzcjsyr/Book2Video

将长书、长文档、PDF、EPUB、读书资料、思想经典、社科著作、商业书或研究型长文转成更有传播感的中文视频号/抖音读书口播稿,并输出项目可用的 raw JSON。只要用户提到“读书解说”“拆书稿”“视频号口播”“把这本书做成短视频”“长文档转视频脚本”“生成标题/封面/金句/raw JSON”,都应使用此 skill。

lzcjsyr/Book2Video

Cody的公众号长文写作skill。当用户需要撰写公众号文章、写稿子、续写文章、根据素材产出长文时使用。触发词包括但不限于:写文章、写稿子、帮我写、续写、扩写、公众号文章、长文、出稿、按我的风格写。即使用户只是说"帮我把这个写成文章"或"用我的风格写一下",只要上下文涉及内容创作和公众号输出,都应该触发。也适用于用户丢过来一个PDF、brief、新闻链接、语音转文字或任何素材说"帮我写篇文章"的场景。不要用于短内容(小红书帖子、推特、朋友圈)或纯标题摘要生成。

lzcjsyr/Book2Video

将中短篇专业报告、公司财报、券商研报、招股书、宏观经济分析及含有较多表格和数据的PDF文档,转化为高品质、数据精准的中文视频号/抖音口播解说稿。只要用户提到“研报”、“财报”、“商业分析报告”或需要“解读数据”、“把报告/PDF做成短视频”,务必使用此 Skill。

lzcjsyr/Book2Video

简化版的文稿生成技能。能够直接读取图书/文档,提取核心论点,生成高品质、口语化的视频号/抖音读书解说文稿并输出标准 JSON 格式。

関連スキル