Communitygithub.com

1345AbhishekKumar/starter-supabase

任意の長さやフォーマットのカスタムHyperFramesビデオ構成を作成するためのフォールバックワークフロー。長編・マルチシーンピース、ブランド/シズルリール、モンタージュ、タイトルカード、静的ループ、自由形式の構成に対応。入力や長さに依存しません。専門ワークフローが入力に明確に適合する場合(マーケティング製品、ウェブサイト、トピック解説、GitHub PR、既存映像、短いモーショングラフィック、Remotionポート)は、そちらを優先してください。

starter-supabase とは?

このスキルは、HyperFramesフレームワークでカスタムビデオ構成を作成するための汎用的なフォールバックワークフローを提供します。これは、製品マーケティングビデオ、ウェブサイト解説、GitHub PR説明など、特定のユースケースに特化したワークフローが存在しない場合にのみ使用されるべきです。このスキルは、デザインシステムの確立、プロンプトの拡張、計画、レイアウト、アニメーションの各ステップをガイドし、一貫性のあるプロフェッショナルな出力を保証します。主な機能には、ハードゲートによるビジュアルアイデンティティの検証、エンドステートファーストのレイアウトアプローチ、GSAPアニメーションの統合、TTS、BGM、効果音の一元管理されたオーディオエンジンが含まれます。このスキルは、HyperFramesエコシステム内のClaude CodeやCursorなどのAIエージェント向けに設計されており、特にクリエイティブ、アニメーション、コア、メディアなどのドメイン別スキルと連携して、複雑なビデオ制作タスクを処理します。

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

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

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

ドキュメント

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

一般ビデオ — 一般的なビデオワークフロー

構築する前にルートを確認してください。 これはカスタム構成作成のためのフォールバックです。入力が専門ワークフローに明確に適合する場合は、そちらを優先してください。マーケティング製品 → /product-launch-video;一般的なサイト → /website-to-video;トピック解説 → /faceless-explainer;GitHub PR → /pr-to-video;既存映像 → /embedded-captions · /talking-head-recut;短いナレーションなしモーショングラフィック → /motion-graphics;Remotionポート → /remotion-to-hyperframes。対象外: ライブ/レンダリング時のデータ、完成したビデオのNLEスタイル編集、HyperFramesがキャプチャできない映像の生成。不明な場合?最初に/hyperframesを読んでください。

依頼されたものを正確に構築してください。 タイトルカードはタイトルカードです — タイトルカード+3つのサポートシーン+アンビエントミュージック+キャプションではありません。追加のシーンや要素が作品を真に向上させる場合は_提案_してください。ただし、黙って追加しないでください。小さな編集(色の修正、1つの継続時間の調整、1つの要素の追加)の場合は、計画ステップをスキップして直接構築に進んでください。

アプローチ

発見 — オープンエンドなリクエストのみ

漠然とした探索的なリクエスト(“ブランドのための何かを作って”、“クールなイントロ”)の場合 — 色を選ぶ前に意図を理解してください:

  • オーディエンス — 誰が見ますか? 開発者/経営者/一般消費者?
  • プラットフォーム — どこで再生されますか? ソーシャル(15秒) / ウェブサイトヒーロー / 製品デモ / 社内?
  • 優先順位 — 最も重要なのは何ですか? モーションの品質 / コンテンツの正確さ / ブランドの忠実度 / 速度?
  • バリエーション — 1つのベストショット、または2〜3の意味的に異なるオプション(異なるペース、エネルギー、または構造 — 単なる色の変更ではない)?

具体的なリクエスト(“タイトルカードを追加”、“シーン3のタイミングを修正”)の場合は、発見をスキップしてください。

ステップ1 — デザインシステム → hyperframes-creative

最初にビジュアルアイデンティティを確立してください。プロジェクトにデザインスペックがある場合は、それを読んでください(優先順位はframe.md → design.md → DESIGN.md。ブランドの真実として扱ってください — 正確な色、フォント、制約)。

スペックがない場合、色やフォントを選ぶ前に、hyperframes-creative/references/house-style.mdとhyperframes-creative/references/video-composition.mdの両方を読む必要があります。 house-style.mdは、“プロンプトを解釈し/実際のコンテンツを生成する”開始点、レイジーデフォルトリスト、レイヤーレシピを提供します。video-composition.mdは、“生成された”ものから“制作された”ものを区別する、ビデオメディアの密度/スケール/前景の詳細化(データバー、レジストレーションマーク、モノスペースメタデータ、“8〜10要素、そのうちユーザーが要求していない2つ”)を提供します。片方だけ読むのは最も一般的なミスです — video-composition.mdはエージェントがスキップするものであり、平らで中央揃えのウェブページのような出力を防ぐまさにそのものです。自分でパレットを発明してこれらをスキップしないでください。hyperframes-creativeへの移行はここでは必須であり、オプションの分岐ではありません。そこから、必要に応じて、名前付きスタイル/ムード → references/visual-styles.md、またはインタラクティブピッカー → references/design-picker.mdも取得してください。スペック/スタイルはブランドを定義し、構成ルールを定義するものではありません。

アングルを見つける(曖昧なブリーフ、スペックなし): 色を選ぶ前に、一文を書いてください — この名前/単語/トピックは何を連想させ、どのようなビジュアル_世界_(比喩、設定、楽器、モチーフ)がそれを表現しますか? 例:サイバーセキュリティツール → 金庫の扉 / 境界線スキャンライン / ロックタンブラー;瞑想アプリ → 潮、呼吸、ゆっくりと広がる光。テーマの_意味_を読み取り、単なる文字ではありません。文字通りの再スタイリングよりも具体的なアングルを選んでください。これは、拡張が正しくスキップされる単一シーンピースのための、プロンプト拡張(ステップ2)の安価な代替であり、グラデーション上の一般的なロゴとデザインされたコンセプトの違いです。

ステップ2 — プロンプト拡張 → hyperframes-creative

すべてのマルチシーン構成に対して実行してください(単一シーンピースおよび些細な編集ではスキップ)。リクエストをデザインスペック+ハウススタイルに基づいて、ダウンストリームの作業が一貫して読み取る一貫した中間表現に接地させてください。hyperframes-creative/references/prompt-expansion.mdを参照してください。

ステップ3 — 計画

HTMLを書く前に、高レベルで考えてください:

  1. 何を — 視聴者体験:物語の弧、重要な瞬間、感情的なビート。
  2. 構造 — いくつの構成、サブコンポーネント対インライン、どのトラックがビデオ/オーディオ/オーバーレイ/キャプションを運ぶか。モノリシック単一ファイル対モジュラーサブコンポーネントの判断については、hyperframes-core/references/composition-patterns.mdの§ 2つのアーキテクチャ(経験則:ハードシーンカットが3つ以上、または再利用されるシーンがある → モジュール化;短い単一シーンピースは1ファイルのまま)を参照してください。
  3. リズム — 実装前にパターンに名前を付けてください(例:fast-fast-SLOW-SHADER-hold)。hyperframes-creative/references/beat-direction.mdを参照してください。
  4. タイミング — どのクリップが継続時間を決定し、トランジションがどこに配置され、ペーシングはどうか。
  5. レイアウト — 最初にエンドステートを構築してください(以下を参照)。
  6. アニメート — 次にhyperframes-animationを介してモーションを追加してください。

アニメーションの前にレイアウト

すべての要素を、最も見える瞬間にある位置に配置してください — 完全に入り、正しく配置され、まだ退出していない状態。それを最初に静的HTML+CSSとして書いてください。まだGSAPは使わないでください。

理由: アニメーションの開始状態(画面外、スケール0、不透明度0)で要素を配置し、_着地する_と思う場所にトゥイーンすると、最終的なレイアウトを推測していることになります — 重なりはレンダリングまで見えません。最初にエンドステートを構築すれば、モーションを追加する前にレイアウトの問題を見て修正できます。

  1. 各シーンのヒーローフレームを特定してください — 最も多くの要素が同時に見える瞬間。それが構築するレイアウトです。
  2. そのフレームの静的CSSを書いてください。コンテンツコンテナは、絶対オフセットではなくパディングでシーンを埋める必要があります:
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px; /* パディングがコンテンツを配置;任意のシーンサイズを埋める */
  gap: 24px;
  box-sizing: border-box;
}

コンテンツコンテナにposition: absolute; top: Npxを使用しないでください — コンテンツがスペースよりも高い場合にオーバーフローします。絶対配置は装飾用に予約してください。

⚠ 上記のwidth/height: 100%は、すべての先祖が解決された高さを持つ場合にのみ機能します。 ルート<div data-composition-id>と.scene-contentの間のラッパーはサイズ設定される必要があります(ルートにposition: relative; width: 1920px; height: 1080px — hyperframes-core → “ルートはサイズ設定が必要”を参照)。これをスキップすると、フレックスコンテナは約0に縮小し、コンテンツは左上隅に積み重なり、最初のグリフはx=0でクリップされます — その間lint/inspectは依然として0件の問題を報告します。また、.scene-contentのpadding(≥80px)は常に保持してください。これはタイトルセーフマージンです。これを単なるgapに置き換えないでください。

  1. エントランスを追加 — gsap.from()を使用して、画面外/非表示からCSS位置へアニメートします(サブコンポーネントでは、開始状態が明示的になるようにgsap.fromTo()を優先。hyperframes-core/references/sub-compositions.mdを参照)。CSS位置がグラウンドトゥルースであり、トゥイーンはそれへの道のりです。
  2. 終了はトランジションで処理 — hyperframes-animation/transitions/のシーントランジションルールに従い、最後のシーンのみが要素をアウトにアニメートします。シーン間ではトランジション自体が終了です。

時間を超えた共有スペース: 同じエリアで要素Aが要素Bより先に終了する場合、両方ともそれぞれのヒーローフレームに対して正しいCSS位置が必要です。タイムラインの順序付けにより共存が防止され、レイアウトステップで偶発的な重なりをキャッチします。レイヤー化されたグロー/シャドウとzスタック深度は_意図的な_重なりであり、このステップは_意図しない_衝突(2つの見出しが重なる、コンテンツがフレームからはみ出す)をキャッチするためのものです。

構築 — ドメインスキルに委任

これはスキルの全表面(descriptionを参照)をそのリファレンスにマッピングします — 網羅的ではありません。意図がリストにない場合は、hyperframes-creative(ビジュアル/コンセプト)、hyperframes-animation(モーション)、hyperframes-core(契約)、hyperframes-media(オーディオ/キャプション)を介してルーティングしてください。最初の行は追加です — それをあなたの意図の行と一緒に読んでください。どちらか一方ではありません。

構築するもの…最初に読むもの(順序に従って)
常に — すべての非自明な作品において、以下の意図の行に加えてhyperframes-creative/references/house-style.md + references/video-composition.md(ステップ1 / HARD-GATEでもゲートされています。“生成されたものではなく制作された”前景の詳細化)
キネティックタイポグラフィ / テキスト主体hyperframes-animation/techniques.md(キネティックタイプ)+ adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md
タイトルカード / ローワーサード / オーバーレイ / PiP / テキスト背景hyperframes-creative/references/composition-patterns.md + (中央揃え/サイズ調整されたフレーム用)hyperframes-core → “ルートはサイズ設定が必要”
ロゴ / ブランドマークリビールhyperframes-animation/rules/svg-path-draw.md(描画)+ rules/3d-text-depth-layers.md + rules/scale-swap-transition.md
データ / 統計 / 数字hyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md
製品 / アプリ / UIデモhyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md
オーディオリアクティブ / 音楽駆動hyperframes-creative/references/audio-reactive.md(事前抽出バンド;モーションにマッピング)
ナレーション / ボイスオーバー / 音楽 / SFX / キャプションhyperframes-media → 共有オーディオエンジン scripts/audio.mjs(1回の呼び出しでTTS + BGM + SFX → audio_meta.json);キャプション作成+アセット配置はhyperframes-core経由。以下のオーディオを参照。
マルチシーン / トランジションhyperframes-animation/transitions/overview.md 次に transitions/catalog.md(概要だけで完了しないでください — GSAPレシピはカタログにあります)
モジュラー / サブコンポジションhyperframes-core/references/composition-patterns.md + references/sub-compositions.md

オーディオ:1つのエンジン(TTS · BGM · SFX)

作品がそれを要求する場合のみ(“依頼されたものを正確に構築”に従い — タイトルカードにアンビエントミュージックはなし)。TTSを手作りしたり、コピーを調達したりしないでください。中立的なaudio_request.jsonを書き、hyperframes-media内の共有エンジンを呼び出してください。1つのスイッチで自動的に劣化します — HeyGen資格情報あり → HeyGen TTS + 音楽/SFX 取得;なし → ElevenLabs/Kokoro TTS、Lyria/MusicGen BGM 生成、およびバンドルされたSFXライブラリ。完全なフラグリスト+リクエスト/メタスキーマ:hyperframes-media/scripts/audio.mjsのヘッダーコメントを参照。

// audio_request.json — ナレーションセグメントごとに1行;`id`はあなたのもの(audio_metaを結合)
{
  "lines": [
    { "id": "s1", "text": "開始ライン。", "sfx": ["whoosh"] },
    { "id": "s2", "text": "次のビート。" },
  ],
  "bgm": { "query": "calm cinematic underscore" }, // "mode"を省略 → 自動(HeyGenの場合は取得、それ以外は生成);無効にするには"none"
}
# <MEDIA_DIR> = インストールされたhyperframes-mediaスキルディレクトリ(このスキルの兄弟)
node <MEDIA_DIR>/scripts/audio.mjs --request ./audio_request.json --hyperframes . --out ./audio_meta.json

次にaudio_meta.jsonを読み取ってください:各voices[].path +(bgm.path、sfx[])を<audio>トラックとしてマウントし、voices[].wordsをキャプションに使用します。すべてhyperframes-core(オーディオトラック+キャプション作成)に従ってください。BGMが生成パスを取った場合(bgm_pending: true)、最終レンダリングの前にhyperframes-media/scripts/wait-bgm.mjsを実行してください。

出力チェックリスト → hyperframes-cli

…

(原文の残り部分がトランケーションのため省略されています)

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

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.

1345AbhishekKumar/starter-supabase

Capture a general website/URL and turn it into a HyperFrames video (site tour, showcase, or social clip from the site's own visuals). Uses headless Chrome screenshots + brand assets. Use when intent is general — portfolio/blog/landing-page showcase or social clip from the site. NOT for: product/SaaS launch or promo (→ /product-launch-video, even from a URL); topic explainer with no site (→ /faceless-explainer); GitHub PR (→ /pr-to-video); adding captions to existing video (→ /embedded-captions); short unnarrated page-highlight motion graphic (→ /motion-graphics). Unclear launch-vs-general-site? Ask one question or start at /hyperframes.

関連スキル