Communitygithub.com

9018/mychat

任意のWebサイト/URLをキャプチャし、HyperFramesを使用してプロフェッショナルな動画(サイトツアー、ショーケース、ソーシャルクリップ)に変換します。

mychat とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)向けに設計された、Webサイトを高品質な動画に変換するワークフローです。ユーザーが指定したURLのサイトをヘッドレスChromeでキャプチャし、ブランドアセット(色、フォント、レイアウト)を抽出。その後、7段階のステップ(ブランド理解、デザイン設計、ストーリーボード作成、ナレーション生成、コンポジション構築、検証・納品)を経て、プロ仕様の動画を生成します。対応プラットフォームはHyperFramesで、MP4レンダリングやスタジオプレビューが可能。特に「製品ローンチ動画」や「GitHub PR動画」など、他の専用ルートと区別するための明確なルーティングテーブルを持ち、曖昧なリクエストに対しては`/hyperframes`スキルでルートを確認するよう促します。協調モードと自律モードの両方をサポートし、自律モードでも品質検証ゲート(アセット監査、ビートごとのHTML確認、DoDチェックリストなど)はスキップされません。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/9018/mychat/tree/HEAD/OpenMontage/.agents/skills/website-to-video

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

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

ドキュメント

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

ウェブサイトからHyperFramesへ

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

ステップ0の前にルートを確認してください。 このスキルは_一般的なサイトの_ 動画を作成します。ユーザーが実際に製品をマーケティング/ローンチ/宣伝している場合(このURLからでも、「私たちのサイトのプロモーション」であっても)→ /product-launch-video。サイトなしのトピック解説 → /faceless-explainer。GitHub PR → /pr-to-video。既存動画ファイルの再編集/再カラーリング/再順序付け → 対象外。漠然とした「動画を作って」というリクエスト、またはローンチか一般サイトか不明な場合 → まず** /hyperframes を読む**(完全なルーティングテーブル + § HyperFramesでできないこと)。

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

  • 「このウェブサイトを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 → Preflight を参照してください。

ゲート: サイトサマリーが出力されていること — アセット/色/フォントのインベントリの前に、戦略ファースト(製品の機能、ターゲットユーザー、ブランドボイス)で記述すること。サインインステータスが表示されていること(サインイン済み、またはオフラインで続行)。


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

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

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

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

ゲート: DESIGN.md が存在すること(任意の長さで)最低限: カラーパレット、フォントの選択、Do's/Don'ts を含むこと。


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

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

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

ゲート: 動画タイプ、尺、フォーマット、そして重要なのはメッセージとナラティブアークが確定していること。これらがないと、ステップ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-in-Canvasエフェクトの完全なコードパターン(hyperframesスキルに存在)

Individual skills in this repo

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

9018/mychat

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

9018/mychat

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.

9018/mychat

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

9018/mychat

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

9018/mychat

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

9018/mychat

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.

9018/mychat

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.

9018/mychat

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

9018/mychat

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.

9018/mychat

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

9018/mychat

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.

9018/mychat

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

9018/mychat

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.

9018/mychat

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

9018/mychat

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.

9018/mychat

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.

9018/mychat

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.

9018/mychat

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.

9018/mychat

Animate SVG character rigs with GSAP, CSS transforms, Remotion frame control, and HyperFrames-compatible browser previews.

9018/mychat

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

関連スキル