Communitygithub.com

1345AbhishekKumar/starter-nextjs

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

starter-nextjs とは?

このスキルは、与えられたWebサイトのURLを分析し、そのビジュアルコンテンツとブランドアイデンティティをもとに、プロフェッショナルな動画(ソーシャルクリップ、サイトツアー、ショーケースなど)を自動生成するためのものです。HyperFrames プラットフォーム上で動作し、ヘッドレスChromeを使用してサイトをキャプチャし、ブランドカラーやフォントなどのアセットを抽出した後、7段階のワークフロー(キャプチャ、ブランド分析、戦略立案、ストーリーボード作成、音声合成、コンポジション構築、検証と納品)を実行します。各ステップは明確な成果物と確認ゲートを備えており、自動モードでも品質検証(アセット監査、ビートごとのHTMLレビュー、完成度チェック)はスキップされません。このスキルは、ポートフォリオ、ブログ、ランディングページなど、商品ローンチではなく一般的なサイト紹介やソーシャルメディア向けクリップに最適です。製品プロモーション動画やフェイスレス解説動画など、他の目的には専用のスキルが用意されています。

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

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

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

ドキュメント

media-use: 音声/画像を入手する前に、/media-use を呼び出してHeyGenカタログからBGM/SFX/画像を解決してください。最初に --adopt を実行して既存のアセットを登録します。詳細は /media-use スキルを参照してください。

ウェブサイトからHyperFramesへ

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

ステップ0の前にルートを確認してください。 このスキルは 一般的なサイト の動画を作成します。ユーザーが実際には 製品をマーケティング/ローンチ/プロモーション している場合(このURLからでも、「当サイトのプロモーション」でも) → /product-launch-video。サイトのないトピック解説 → /faceless-explainer。GitHub PR → /pr-to-video。既存の動画ファイルの再編集/再着色/再構成 → 範囲外。漠然と「動画を作って」と指示された場合、またはローンチか一般サイトか判断できない場合 → 最初に /hyperframes を読んでください(完全なルーティングテーブル + § HyperFramesでできないこと)。

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

  • 「このウェブサイトを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を使用するかローカルエンジンを使用するか、またサインインしていない場合のサインイン方法が報告されます。サインインしていない場合、STOPしてユーザーが選択するのを待ちます — サインインするか、ローカルエンジンで続行するために「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(目次をスキャン — 詳細セクションは必要な場合のみ深掘り)

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

ゲート: 動画タイプ、長さ、フォーマット、そして — 重要 — メッセージとナラティブアークが確定している。これらがなければ、ステップ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 が存在し、ビートタイミングが実際の長さで更新されている。


ステップ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が含まれている。


クイックリファレンス

動画タイプ

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

タイプ標準的な長さ長さの決定要因ナレーション
ソーシャル広告(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セクション)。ブリーフ中にTOCをスキャンし、ビルド中に特定セクションを深掘り
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-in-Canvasエフェクトの完全なコードパターン(hyperframesスキル内に存在)

Individual skills in this repo

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

1345AbhishekKumar/starter-nextjs

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-nextjs

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-nextjs

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-nextjs

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-nextjs

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-nextjs

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-nextjs

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-nextjs

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-nextjs

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-nextjs

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-nextjs

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-nextjs

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-nextjs

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.

関連スキル