Communitygithub.com

Aseel1600/Edit01

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

Edit01 とは?

このスキル(Aseel1600/Edit01)は、任意のWebサイトのURLを受け取り、HyperFramesプラットフォームを使用してプロフェッショナルな動画に変換するための包括的なワークフローを提供します。ポートフォリオ、ブログ、ランディングページのショーケースや、ソーシャルメディア向けのクリップ作成に最適です。ワークフローは7つのステップで構成され、各ステップは前のステップの成果物に依存します。具体的には、サイトのキャプチャとブランド理解(ステップ0)、デザインアイデンティティの確立(ステップ1)、戦略とメッセージングの策定(ステップ2)、ストーリーボードとスクリプト作成(ステップ3)、ナレーションとタイミング調整(ステップ4)、コンポジションの構築(ステップ5)、そして最終的な検証と納品(ステップ6)です。このスキルは、製品の発売やプロモーション動画、GitHub PRの動画化、既存動画へのキャプション追加など、特定のユースケースには対応していないため、適切なルーティングが重要です。デフォルトではユーザーとの協調作業を前提としていますが、完全自動モードもサポートしており、その場合でも品質検証ゲートはスキップされません。対応プラットフォームはHyperFramesとHeyGenで、CLIツール(npx hyperframes)を通じて認証状態やアセット管理、ビルド、検証を行います。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Aseel1600/Edit01/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サイトを15秒のInstagram用ソーシャルクリップに変換して」
  • 「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(目次をスキャン — 詳細セクションは必要な場合のみ深掘り)

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

ゲート: 動画タイプ、長さ、フォーマット、そして — 最も重要な — メッセージとナラティブアークが確定していること。これらなしでは、ステップ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(ビート数 × 3, ceil(長さ_秒 / 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セクション)。ブリーフ中に目次をスキャンし、ビルド中に特定のセクションを深掘り
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 20 individual skills — each has its own dedicated page.

Aseel1600/Edit01

Generate AI videos from text prompts using multiple provider gateways. Use when: (1) Generating videos from text descriptions, (2) Creating AI-generated video clips for content production, (3) Image-to-video generation with a reference image, (4) Choosing between video generation providers (VEO, Kling, Sora, Runway, Seedance, MiniMax, Gemini Omni). Supports gateways: HeyGen API, fal.ai API, Kling official direct API, and the Gemini API (Gemini Omni Flash).

Aseel1600/Edit01

Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API. Use when: (1) Choosing a specific avatar and voice for a video, (2) Writing exact scripts for an avatar to speak, (3) Building multi-scene videos with different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control.

Aseel1600/Edit01

Use p5.js/canvas for local procedural character effects: particles, weather, squash/stretch, walk cycles, and environmental motion.

Aseel1600/Edit01

Review local character animation with schema checks, Playwright browser previews, frame sampling, and FFmpeg/ffprobe final output checks.

Aseel1600/Edit01

Create videos from a text prompt using HeyGen's Video Agent. Use when: (1) Creating a video from a description or idea, (2) Generating explainer, demo, or marketing videos from a prompt, (3) Making a video without specifying exact avatars, voices, or scenes, (4) Quick video prototyping or drafts, (5) One-shot prompt-to-video generation, (6) User says "make me a video" or "create a video about X".

Aseel1600/Edit01

Generate Mandarin and multilingual narration with Volcengine Doubao Speech 2.0. Use when creating Chinese voiceovers, when the user prefers Doubao/Volcengine/火山引擎/豆包 TTS, or when narration needs character-level timestamp metadata for subtitles.

Aseel1600/Edit01

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Aseel1600/Edit01

Generate expressive, multilingual narration with fish.audio (S1 / S2-generation models) and reuse cloned voices via reference_id. Use when the user prefers fish.audio/Fish Audio TTS, wants a specific playground voice model, or needs high-emotion voice-clone narration.

Aseel1600/Edit01

Use when implementing Disney's 12 animation principles with Framer Motion in React applications

Aseel1600/Edit01

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.

Aseel1600/Edit01

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`).

Aseel1600/Edit01

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.

Aseel1600/Edit01

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`.

Aseel1600/Edit01

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.

Aseel1600/Edit01

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).

Aseel1600/Edit01

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.

Aseel1600/Edit01

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.

Aseel1600/Edit01

Best practices for Remotion - Video creation in React

Aseel1600/Edit01

Toolkit-specific Remotion patterns — custom transitions, shared components, and project conventions. For core Remotion framework knowledge (hooks, animations, rendering, etc.), see the `remotion-official` skill.

Aseel1600/Edit01

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.

関連スキル