Communitygithub.com

1345AbhishekKumar/starter-supabase

一般的なWebサイト/URLをキャプチャし、HyperFrames動画(サイトツアー、ショーケース、ソーシャルクリップ)に変換します。ヘッドレスChromeのスクリーンショットとブランドアセットを使用します。

starter-supabase とは?

このスキルは、任意のWebサイトのURLを受け取り、そのサイトのビジュアルを活用してプロフェッショナルな動画を自動生成するHyperFramesワークフロー全体を実装したものです。ユーザーは「このサイトを15秒のIGクリップに」「ホームページから動画を作って」といった指示を出すだけで、キャプチャ→ブランド分析→デザイン定義→戦略立案→ストーリーボード→ナレーション生成→コンポジション構築→検証・納品という7ステップの工程をエージェントが自律的に(あるいは協調的に)実行します。各ステップには成果物ゲートがあり、品質を担保しながら進行します。このスキルはClaude Codeなどのエージェント向けに設計されており、特に「プロダクトローンチ動画」や「フェイスレス解説動画」など他の明確なユースケースと区別するためのルーティングロジックを備えています。また、HeyGen(TTS・BGM・画像)やElevenLabs、Kokoroといった外部サービスとの統合、ブランドカラー・フォントの自動抽出、ヘッドレスChromeによるサイトキャプチャ、HTML/Canvasベースのコンポジションなど、HyperFramesの全機能を活用します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/1345AbhishekKumar/starter-supabase/tree/HEAD/.agents/skills/website-to-video

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

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

ドキュメント

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

WebサイトからHyperFrames動画へ

Webサイトをキャプチャし、そこからプロフェッショナルな動画を制作します。

ステップ0の前にルートを確認してください。 このスキルは 一般的なサイトの/から 動画を作成します。ユーザーが本当に 製品をマーケティング/ローンチ/プロモーション している場合(このURLからであっても、「弊社サイトのプロモーション」であっても)→ /product-launch-video。サイトのないトピック解説 → /faceless-explainer。GitHub PR → /pr-to-video。既存動画ファイルの再カット/再着色/並び替え → 対象外です。「動画を作って」という曖昧な指示、またはローンチか一般サイトか不明な場合? まず /hyperframes を読んでください(完全なルーティング表 + § HyperFramesができないこと)。

ユーザーは次のように言います:

  • 「このWebサイトをInstagram用の15秒ソーシャルクリップにして」
  • 「https://... から30秒のサイトツアー/ショーケースを作って」
  • 「ホームページをキャプチャして、そのビジュアルから動画を構築して」

ワークフローは7つのステップで構成されています。各ステップは次のステップへのゲートとなるアーティファクトを生成します。デフォルトでは協調的であり、ゲート 💬 はユーザーに停止して確認を求めます。ユーザーが自律モード(「決めて」「驚かせて」)を指示した場合、💬 のユーザー設定ゲートはスキップされます。その伝播方法については step-2-brief.md を参照してください。

自律モードは「すべてのゲートをスキップする」ではありません。 自動モードはユーザー設定に関する質問(TTSプロバイダー、音声、強調色、ビート数、音楽の有無、キャプションの有無など、エージェントがユーザーに代わって決定するもの)をカバーします。品質検証ゲートはカバーしません。自動モードでも以下はスキップできません:

  • アセット監査(ステップ3) — コンタクトシートを確認し、各アセットのUSE/SKIPを正当化する
  • ビートごとのHTML読み取り(ステップ5) — ビートごとの構造化エビデンスブロック
  • DoDチェックリスト(ステップ6) — アニメーションマップ、警告ごとのWCAG検証、オーディオ/モーションプレビューを含む
  • 正直な開示セクション(ステップ6) — 「検証しなかったこと」が最終サマリーに含まれなければならない

「自動モードは行動を優先するからXをスキップしよう」と考える場合、そのXが検証ゲートであり設定質問でないなら、その推論は誤りです。行動優先は 何を構築するか の決定に適用され、 検証するかどうか の決定には適用されません。


ステップ0: キャプチャとブランド理解

読む: references/step-0-capture.md

サイトをキャプチャし、抽出されたデータを読んで ブランドと製品 — 何をしているのか、誰のためのものか、どのような声で話すのか、どのような雰囲気なのか — を理解します。キャプチャされたアセットは後で使用するブランドツールキットであり、動画の構成要素そのものではありません。

ブリーフの前にサインイン状況を表示してください — npx hyperframes auth status を実行し、その出力をそのまま中継してください(言い換えたり書き換えたりしないでください)。 これは、音声/BGMがHeyGenを使用するかローカルエンジンを使用するか、またサインインしていない場合のサインイン方法を報告します。サインインしていない場合は、停止してユーザーが選択するのを待ってください — サインインするか、「go」/「offline」と言ってローカルエンジンで続行するか — ブリーフやその他のことを尋ねる前に。これを単なる通過点ではなく、実際の決定点として扱ってください。選択をブリーフの質問に折り込んだり、リポジトリ内の .env にキーを書き込んだりしないでください。(自律モードでは、ステータスをメモしてオフラインで続行します。)../hyperframes-media → プリフライトの正規のガイダンスを参照してください。

ゲート: サイトサマリーが印刷されていること — アセット/色/フォントのインベントリの前に、戦略ファースト(製品が何をするか、誰のためのものか、ブランドボイス)であること。サインイン状況が表示されていること(サインイン済み、またはオフラインで続行)。


ステップ1: ブランドアイデンティティ

読む: references/step-1-design.md

DESIGN.md を作成します — 視覚的アイデンティティ(色、タイポグラフィ、コンポーネントスタイル、レイアウト原則)をカバーするブランドチートシートです。正確な計算値には design-styles.json を使用します。

高速オプション: 高速テンポの動画(ビルボード形式のビートごと)の場合、DESIGN.md は色 + フォント + すべきこと/すべきでないことの50行サマリーで十分です — 300行のドキュメントは不要です。ステップ5のサブエージェントプロンプトがブランド値を直接貼り付けるため、DESIGN.md の深さは複雑なコンポジションの場合にのみ重要です。

ゲート: DESIGN.md が存在すること(任意の長さ)で、最低限:カラーパレット、フォントの選択、すべきこと/すべきでないこと。


ステップ2: 戦略とメッセージング

読む: references/step-2-brief.md、references/capabilities.md(目次をスキャン — 詳細セクションは必要な場合のみ深掘り)

ビジュアルやアセットの話をする前に、ユーザーと 動画が伝えるべきこと を一致させます。ユーザーのプロンプトを解析します — おそらくユーザーはすでに動画の種類とスタイルを指定しています。不足しているものだけを尋ねます:この動画が必ず伝えるべき唯一のこと、ナラティブアーク、そして視聴者。

ゲート: 動画の種類、 duration、フォーマット、そして — 重要なのは — メッセージとナラティブアークが確定していること。これらがなければ、ステップ3はコンセプトファーストのストーリーボードを書けません。


ステップ3: ストーリーボード + スクリプト 💬

読む: references/step-3-storyboard.md

コンセプトファーストでストーリーボードを書きます:メッセージ → ナラティブアーク → そのアークを支えるビート → ビートごとのテクニック → 最後にブランドアクセントを追加。次に、それに合わせてナレーションスクリプトを書きます。両方をビートごとのサマリーとともにユーザーに提示します。ユーザーが承認するまで反復します。

ゲート: STORYBOARD.md + SCRIPT.md が存在し、ユーザーが計画を承認していること。


ステップ4: VO、タイミング + キャプション 💬

読む: references/step-4-vo.md

ステップ2でナレーションなしと指定された場合 — 背景音楽について尋ね、ステップ5にスキップします。そうでない場合:ユーザーにTTSプロバイダー(HeyGen TTS、ElevenLabs、Kokoro)を尋ね、オーディオを生成し、文字起こしし、タイムスタンプをビートにマッピングします。次にキャプションについて尋ねます。

ゲート: (a) ナレーションが要求されず、ストーリーボードに手動のビートタイミングがある、または (b) narration.wav + transcript.json が存在し、ビートタイミングが実際のdurationで更新されている。


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

読む: hyperframes スキル(ロードしてください — すべてのルールが重要です) 読む: references/step-5-build.md

ストーリーボード(ステップ3)で選択されたアーキテクチャとテンポに従って、index.html とコンポジションを構築します。サブエージェントは各ビートについて hyperframes lint と hyperframes snapshot を実行してから報告します。

ゲート: すべての compositions/beat-N.html がメインエージェントによって DESIGN.md と STORYBOARD.md に対して最初から最後まで読まれていること。ビートごとのチェックリストは step-5-build.md にあります。


ステップ6: 検証と納品

読む: references/step-6-validate.md

Lint、検証、動画の長さにスケーリングされたスナップショットの取得(計算式:max(beats × 3, ceil(duration_seconds / 2))、そして各スナップショットを確認します。問題を修正してから納品します。localhost StudioプロジェクトURLを納品します — MP4へのレンダリングは明示的なユーザー要求があった場合のみ行います。そのStudio URLは 引き継ぎ時のみ 表示します — これが最終的な安定したプレビューです。ビルドフェーズのスナップショットはヘッドレスであるため、ビルド中にプレビューをポップアップ表示しないでください。

誇れるものを納品してください。 引き継ぐ前に自問してください:これをソーシャルメディアに自分の名前で投稿しますか? そうでない場合、問題を修正してください。

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


クイックリファレンス

動画タイプ

動画タイプ別の典型的な制約 — 公式としてではなく、出発点として使用してください。ビート数は、目標範囲からではなく、コンテンツとナレーションに従うべきです。

タイプ標準的なdurationdurationの決定要因ナレーション
ソーシャル広告 (IG/TikTok)10–15秒プラットフォーム制限任意
製品デモ30–60秒スクリプトの長さフルナレーション
機能発表15–30秒機能の複雑さフルナレーション
ブランドリール20–45秒音楽トラック任意、音楽重視
ローンチティーザー10–20秒フックのエネルギー最小限

ビート数は意図的にこの表に含めていません — ビート数は「ソーシャル広告 = 3-4ビート」からではなく、ストーリーボードから導き出すべきです。複雑な製品のソーシャル広告には、タイミングの良い5ビートが必要かもしれません。1つの強力なビジュアルテーゼを持つブランドリールには、3ビートで十分かもしれません。

フォーマット

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

リファレンスファイル

ファイルいつ読むか
step-0-capture.mdステップ0 — キャプチャ、ブランドと製品の理解、戦略ファーストのサイトサマリーの作成
step-1-design.mdステップ1 — DESIGN.md ブランドチートシートの作成(5セクション、250-350行;ビルボードスタイルのソーシャル広告向け50行高速パス)
step-2-brief.mdステップ2 — メッセージ、ナラティブアーク、視聴者をユーザーと一致させる
capabilities.mdステップ2 & 5 — HyperFramesができることの完全なインベントリ(24セクション)。ブリーフ中に目次をスキャンし、ビルド中に特定のセクションを深掘り
step-3-storyboard.mdステップ3 — ストーリーボード + スクリプト(統合)、ユーザーレビューゲート付き
step-4-vo.mdステップ4 — TTSプロバイダーの選択、生成、タイミング
step-5-build.mdステップ5 — index.html + コンポジションの構築
step-6-validate.mdステップ6 — lint、検証、スナップショット(動画の長さにスケーリング)、プレビュー
techniques.mdステップ3 & 5 — 13の基本アニメーションテクニックとコードパターン(コピーペーストではなく適応)
html-in-canvas-patterns.mdステップ5 — HTMLインキャンバスエフェクトの完全なコードパターン(hyperframesスキルにあり)

Individual skills in this repo

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

1345AbhishekKumar/starter-supabase

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 32 visual identities behind two engines: column-flow (captions composited INTO the scene — matte occlusion + mix-blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) and themed constitutions (anchor/ordnance/terminal/neonsign/stardust/stomp/scoreboard/transit/vhs/arcade/dossier/laser/thunder/hologram/biolume/aurora/spectrum/papercut/popup/chalkboard/graffiti/brush/inkwater/ransom/lastpage/nightcity — e.g. a glyph-decode climax, a neon sign WRITTEN stroke by stroke, or the quiet `anchor` rail default). Route by identity, never by mode. Trigger on "captions/subtitles", "embed/cinematic captions", "VFX captions", "炸/特效/酷炫字幕", a named identity, or top-tier motion-graphics asks. Embedding every word is wrong for most talking-head content — `anchor` is the verbatim default. Pipeline: transcription → hyperframes remove-background matting → HTML render → ffmpeg overlay. Requires hyperframes and a single-subject clip.

1345AbhishekKumar/starter-supabase

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a website, a topic explainer, a GitHub PR, existing footage, a short motion graphic, or a Remotion port — prefer it (see /hyperframes); use this only as the general fallback when none fit.

1345AbhishekKumar/starter-supabase

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). HyperFrames-native: single paused timeline, seek-safe, deterministic.

1345AbhishekKumar/starter-supabase

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

1345AbhishekKumar/starter-supabase

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

1345AbhishekKumar/starter-supabase

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

1345AbhishekKumar/starter-supabase

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

1345AbhishekKumar/starter-supabase

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, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

1345AbhishekKumar/starter-supabase

Use when the user wants a short, design-led motion graphic where motion is the message: kinetic typography, stat or number count-up, chart/data-viz hit, logo sting, brand lockup, lower-third, callout, social overlay, animated headline/tweet/news item, motion poster, or quick captured-page highlight. Usually under 10s and up to ~30s, with no narration arc, voice-over, or live-action subject. Can render to MP4 or transparent overlay. Not for longer, multi-scene, narrated, or brand-reel pieces (use general-video), narrated website videos (website-to-video), topic explainers (faceless-explainer), product promos (product-launch-video), PR videos (pr-to-video), or captions on existing footage (embedded-captions). When unsure whether it's a quick motion-first piece or a longer / narrated treatment, see /hyperframes.

1345AbhishekKumar/starter-supabase

Use when the user has a music track (an audio file, or a video to pull audio from) and wants a beat-synced HyperFrames video, calm to hard-hitting. The music drives everything: one analyzer reads it once, the orchestrator lays out the frames and fills a per-frame plan, and one sub-agent builds each frame. Typography and templates are the floor — a complete video needs zero assets — but any images or videos the user supplies are cut into the frames on the same beat grid (beat-cut / ken-burns). The genre (lyric video, slideshow, kinetic promo) falls out of the per-frame choices; the pipeline never branches on it.

1345AbhishekKumar/starter-supabase

turn a product or marketing URL, pasted script, or brief into a product launch video, including SaaS promos, feature reveals, app launches, company promos, and product marketing videos. Use this skill when the user wants to market, launch, promote, or reveal a product. Do not use it for general non-launch website tours, non-product topic explainers, GitHub pull requests, captioning existing footage, or short unnarrated motion graphics. If the intent is unclear, route through /hyperframes first. This is the new shot-sequence architecture: every visual frame is authored as a time-coded shot sequence picked from a menu of golden blueprints, so frames develop over their full duration instead of freezing after entrance.

1345AbhishekKumar/starter-supabase

turn a GitHub pull request (a PR URL like github.com/<owner>/<repo>/pull/<N>, an <owner>/<repo>#<N> ref, or 'this PR' in a checked-out repo) into a code-change explainer video, up to ~3 min (sweet spot 30-90s) — changelog, feature reveal, fix, or refactor walkthrough, rendered from the diff / commits / files. The input is a CODE CHANGE read via the gh CLI; there is no website capture. Use this skill for a GitHub PR. Do not use it for a product launch/promo (use /product-launch-video), a tour of a real website (use /website-to-video), a topic explainer with no PR (use /faceless-explainer), captions on existing footage (use /embedded-captions), or a short unnarrated motion graphic (use /motion-graphics). If the intent is unclear, route through /hyperframes first.

1345AbhishekKumar/starter-supabase

Port an existing Remotion (React) composition to HyperFrames HTML. Use ONLY when the user explicitly asks to port/convert/migrate/translate a Remotion source. Do NOT use: (a) authoring a new HyperFrames composition; (b) Remotion mentioned in passing; (c) Remotion code shared as reference only; (d) "same video as my Remotion one" without explicit migrate request — treat as fresh build. Doubt → `/general-video`. One-way, Remotion-only: no reverse export (HyperFrames→Remotion or any framework), no non-Remotion source (After Effects, Framer Motion, plain React/CSS) → out of scope, re-create via `/general-video`. Flags unsupported patterns (useState, useEffect, async calculateMetadata, third-party React libs, `@remotion/lambda`) and recommends runtime interop over lossy translation. Unsure whether to port vs. build fresh, or only a passing Remotion mention? → /hyperframes.

関連スキル