Communitygithub.com

WebサイトからHyperFrames動画作成

Webサイトをキャプチャし、HyperFramesを使用してプロフェッショナルな動画を生成します。ユーザーがURLを共有したり、「このサイトを動画にして」とリクエストした場合に使用します。

WebサイトからHyperFrames動画作成 とは?

TeamBrainスキルは、与えられたWebサイトのURLを解析し、その内容をもとにHyperFrames形式の動画を自動生成するエージェントスキルです。主に、ユーザーが「このサイトをキャプチャして」「動画にして」などと依頼した際に起動され、7つのステップからなるワークフローを実行します。まずサイトをキャプチャしてデザイン情報を抽出し、DESIGN.md(ブランドリファレンス)、SCRIPT.md(ナレーション台本)、STORYBOARD.md(ビートごとのクリエイティブ指示)を順に作成。その後、TTS音声を生成してタイミングをマッピングし、各コンポジションを構築。最後にlint・バリデーションをパスし、ローカルのStudioプロジェクトURLをユーザーに提供します。対応する動画タイプは、ソーシャル広告(10~15秒)、プロダクトデモ(30~60秒)、機能発表(15~30秒)、ブランドリール(20~45秒)、ローンチティーザー(10~20秒)など。アスペクト比はランドスケープ(1920x1080)、ポートレート(1080x1920)、スクエア(1080x1080)に対応しています。このスキルは、HyperFramesエコシステム上で動作し、各ステップで参照ファイル(references/以下)を指示に従って読み込みながら進行します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/libz-renlab-ai/TeamBrain/tree/HEAD/.agents/skills/website-to-hyperframes

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

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

ドキュメント

WebサイトからHyperFrames動画作成 は何をしますか?

Webサイトをキャプチャし、プロフェッショナルな動画を生成します。

ユーザーは次のように依頼します:

  • 「https://... をキャプチャして、25秒の製品ローンチ動画を作って」
  • 「このWebサイトを15秒のInstagramソーシャル広告に変換して」
  • 「https://... から30秒の製品ツアーを作成して」

ワークフローは7つのステップで構成されています。各ステップはアーティファクトを生成し、それが次のステップの開始条件となります。


ステップ1:キャプチャと理解

参照: references/step-1-capture.md

キャプチャを実行し、抽出されたデータを読み込み、「書き留めて忘れる」方法を使用して作業用サマリーを作成します。

ゲート: サイトのサマリー(名前、主要カラー、フォント、主要アセット、一言で表す雰囲気)を出力すること。


ステップ2:DESIGN.md の作成

参照: references/step-2-design.md

キャプチャしたWebサイトのシンプルなブランドリファレンスを作成します。6セクション、約90行。これはチートシートであり、クリエイティブプランではありません。クリエイティブプランはステップ4で作成します。

ゲート: プロジェクトディレクトリに DESIGN.md が存在すること。


ステップ3:SCRIPT の作成

参照: references/step-3-script.md

ナレーション台本を作成します。ストーリーの骨格。シーンの長さはナレーションから決定し、推測では決めません。

ゲート: プロジェクトディレクトリに SCRIPT.md が存在すること。


ステップ4:STORYBOARD の作成

参照: references/step-4-storyboard.md

ビートごとのクリエイティブ指示を作成します:ムード、カメラ、アニメーション、トランジション、アセット、深度レイヤー、効果音。これがクリエイティブの北極星であり、エンジニアが各コンポジションを構築する際の指針となります。

ゲート: ビートごとの指示とアセット監査テーブルを含む STORYBOARD.md が存在すること。


ステップ5:VO生成とタイミングマッピング

参照: references/step-5-vo.md

TTS音声を生成し、単語レベルのタイムスタンプを取得するために文字起こしを行い、タイムスタンプをビートにマッピングします。STORYBOARD.md を実際の尺で更新します。

ゲート: narration.wav(または .mp3)と transcript.json が存在すること。STORYBOARD.md のビートタイミングが更新されていること。


ステップ6:コンポジションの構築

参照: hyperframes スキル(読み込むこと — すべてのルールが重要です) 参照: references/step-6-build.md

ストーリーボードに従って各コンポジションを構築します。各コンポジションの後、レイアウト、アセット配置、アニメーション品質を自己レビューします。

ゲート: すべてのコンポジションが自己レビュー済みであること。要素の重なり、アセットの配置ミス、動きのない静止画像がないこと。


ステップ7:検証と納品

参照: references/step-7-validate.md

Lint、検証、スナップショット、プレビューを実行します。まずユーザーにローカルのStudioプロジェクトURL(http://localhost:<port>/#project/<project-name>)を提供します。MP4へのレンダリングは明示的なリクエストがあった場合のみ行います。index.html をプロジェクト受け渡しリンクとして扱わないでください。これはソースコードのコンテキストのみを提供するものです。

ゲート: npx hyperframes lint と npx hyperframes validate がエラー0でパスし、最終レスポンスにアクティブなStudioプロジェクトURLが含まれていること。


クイックリファレンス

動画タイプ

タイプ尺ビート数ナレーション
ソーシャル広告(IG/TikTok)10~15秒3~4オプションのフック文
プロダクトデモ30~60秒5~8フルナレーション
機能発表15~30秒3~5フルナレーション
ブランドリール20~45秒4~6オプション、音楽重視
ローンチティーザー10~20秒2~4最小限、ハイエナジー

フォーマット

  • ランドスケープ: 1920x1080(デフォルト)
  • ポートレート: 1080x1920(Instagramストーリーズ、TikTok)
  • スクエア: 1080x1080(Instagramフィード)

参照ファイル

ファイル読み取りタイミング
step-1-capture.mdステップ1 — キャプチャデータの読み取り
step-2-design.mdステップ2 — DESIGN.md の作成
step-3-script.mdステップ3 — ナレーション台本の作成
step-4-storyboard.mdステップ4 — ビートごとのクリエイティブ指示
step-5-vo.mdステップ5 — TTS、文字起こし、タイミング
step-6-build.mdステップ6 — コンポジション構築と自己レビュー
step-7-validate.mdステップ7 — lint、検証、スナップショット、プレビュー
techniques.mdステップ4と6 — 11のビジュアルテクニックとコードパターン(SVG描画、Canvas 2D、3D、タイポグラフィ、Lottie、動画、タイピング、可変フォント、MotionPath、トランジション、オーディオリアクティブ)

Individual skills in this repo

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

libz-renlab-ai/TeamBrain

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

libz-renlab-ai/TeamBrain

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

libz-renlab-ai/TeamBrain

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For CLI commands (init, lint, preview, render, transcribe, tts) see the hyperframes-cli skill.

libz-renlab-ai/TeamBrain

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames — for example "port my Remotion project to HyperFrames", "convert this Remotion code to HyperFrames", "migrate from Remotion", "translate this Remotion comp", or "rewrite this as HyperFrames HTML". Do NOT use when (a) the user is authoring a NEW HyperFrames composition, even if they have or are A/B-testing a similar Remotion video; (b) the user mentions Remotion in passing without asking for migration; (c) the user shares Remotion code as reference material rather than asking for a translation; (d) the user asks for "the same video as my Remotion one" without explicitly asking to migrate the source — treat that as a fresh HyperFrames build. When in doubt, default to authoring a native HyperFrames composition with the `hyperframes` skill instead. Skill detects unsupported patterns (use...

libz-renlab-ai/TeamBrain

HyperFrames CLI tool — hyperframes init, lint, inspect, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting, validating, inspecting visual layout in compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

関連スキル