Communitygithub.com

1345AbhishekKumar/starter-supabase

ユーザーが短い、デザイン主導のモーショングラフィックを必要とする場合に使用します。モーションそのものがメッセージとなるもの(キネティックタイポグラフィ、数字のカウントアップ、チャート/データ可視化、ロゴスティング、ブランドロックアップ、ローワーサード、コールアウト、ソーシャルオーバーレイ、アニメーションヘッドライン/ツイート/ニュース、モーションポスター、キャプチャしたページのハイライトなど)に適しています。通常10秒未満、最大約30秒で、ナレーションアーク、ボイスオーバー、実写被写体はありません。MP4または透明オーバーレイとしてレンダリングできます。長いもの、複数シーンのもの、ナレーションのあるもの、ブランドリール(→ general-video)、ナレーション付きウェブサイト動画(→ website-to-video)、トピック解説(→ faceless-explainer)、商品プロモーション(→ product-launch-video)、PR動画(→ pr-to-video)、既存映像へのキャプション追加(→ embedded-captions)には使用しません。モーションファーストか、長め/ナレーションありかの判断に迷う場合は、/hyperframes を参照してください。

starter-supabase とは?

これは、短くデザイン主導のモーショングラフィックを作成するためのスキルです。キネティックタイポグラフィ、数字のカウントアップ、シンプルなチャート/データ可視化、ロゴスティング、ローワーサード、ソーシャルオーバーレイ、アニメーションヘッドラインなど、モーションそのものがメッセージとなる動画に特化しています。通常10秒未満、最大30秒程度で、ナレーションやボイスオーバーは含まれません。出力はMP4または透明なオーバーレイ(WebM/MOV)形式に対応しており、特に短尺でインパクトのあるビジュアルコンテンツに適しています。このスキルは、「hyperframes」CLIツールを中心に構築されており、サブエージェントがアセットの調達、ショットの設計、ビルド、レンダリング、検証を段階的に実行します。ワークフローはアセットファーストで、実際の素材を取得してからデザインを行うRWA(Real Web Asset)アプローチを採用しており、再利用可能なカタログブロックとモーションルールを優先的に使用することで効率的な制作を実現します。サポートプラットフォームはmacOS Apple SiliconまたはLinux x64で、Node.js、ffmpeg、およびhyperframes CLIが必要です。

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

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

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

ドキュメント

motion-graphics — ディスパッチエントリ

ステップ0の前にルートを確認してください。 このスキルは、短く、デザイン主導で、ナレーションのないモーショングラフィック(モーションがメッセージ。約10秒未満、ボイスオーバーなし)を作成します。より長く、複数シーン、またはナレーションのある作品 → /general-video。ウェブサイトのナレーション付き動画 → /website-to-video。トピック解説 → /faceless-explainer。商品プロモーション → /product-launch-video。既存映像へのキャプション追加 → /embedded-captions。適用範囲外: ライブ/レンダリング時のデータ、またはキャプチャできない映像。モーションファーストかナレーションありか不明な場合?最初に /hyperframes を読んでください。

デザイン主導の短いモーショングラフィックです。アセットファースト: ショットをデザインする前にアセット戦略を決定し実際の素材を入手し、その素材に基づいてショットをデザインし、カタログ機能を再利用して構成します。すべてのアーティファクトは PROJECT_DIR = videos/<project-name>/(ステップ0で作成)に配置され、以下のすべてのパスはこれに対する相対パスです。

フェーズ実行主要アーティファクト詳細フロー
initBashhyperframes.jsonStep 0
planサブエージェント — 検索が必要か判断 + 分類 + アセット戦略shot-plan.json(ドラフト: カテゴリ、asset_needs クエリ、ブリーフ)agents/director.md(パート1)
source ◇Bash — media-use 解決(asset_needs が空の場合はスキップ)assets/ + assets/index.mdphases/source/guide.md
designサブエージェント — 解決済みアセットに基づくショットデザインshot-plan.json(最終版: ブロック + レイアウト + モーション + 位置)agents/director.md(パート2)
buildサブエージェント — 再利用ファーストの構成compositions/index.htmlagents/builder.md
renderBash — hyperframes render(MP4、またはオーバーレイの場合は --format webm/mov)renders/video.mp4Step 5
verifyBash — lint / inspect -> 障害時に修復サブエージェント(修正はその場で)agents/finalize.md

◇ source は、選択されたカテゴリがアセットを宣言している場合にのみ実行されます。純粋なコード/テキストカテゴリ(例: kinetic-type、ほとんどの charts/stat)は asset_needs: [] であり、プランからデザインに直接進みます。

カテゴリ — 検索判断による分割

plan の最初の判断は「これには検索が必要か?」 です。この分岐でカテゴリは2つのグループに分かれます。その後、特定のカテゴリが選択されます — 検索駆動型の場合は、検索が返すコンテンツのタイプによって。各カテゴリは categories/<id>/module.md(計画 + ビルドルール)に対応します。共有モーションボキャブラリは references/motion-vocabulary.md(→ hyperframes-animation ルール/ブループリント + レジストリブロック)にあります。

フォームカテゴリ — 検索不要。ユーザーがコンテンツを提供:

カテゴリ意図依存するもの
kinetic-type印象的なライン/引用/タイトル、モーションファーストテキストcaption-* ブロック + アニメーションルール
stat単一のヒーロー数字/カウントアップ + リングapple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills}
chartsデータからの棒/折れ線/円/レース/%グラフdata-chart ブロック
logo-revealロゴスティング/ブランドロックアップ(ユーザーロゴ)logo-outro / rules/svg-path-draw
lower-thirds名前/タイトルバー、コールアウト、ソーシャルオーバーレイcaption-* + レジストリオーバーレイブロック

検索駆動型カテゴリ — 最初に検索し、次にコンテンツタイプに応じてアニメーション(RWAパス):

返されるコンテンツカテゴリアニメーション
ウェブページ/リンクwebpageウェブページ/UIアニメーション(スクロール、表示、カーソル、コールアウト)
ニュース記事newsヘッドライン表示 + ソースカード + キーファクトコールアウト
ツイートtweetアニメーションツイートカード
画像/エンティティasset-fusionアセットのジオメトリがチャートになる(RWAダイジェティックフュージョン)

ビルド順: 一度に1つ、カバレッジファースト(ラフで可)。kinetic-type はプロトタイプから移植。残りは追従します。

前提条件

macOS Apple Silicon または Linux x64。システムツール: brew install node ffmpeg。npx hyperframes doctor を一度実行。macOS GPUレンダリング: export PRODUCER_BROWSER_GPU_MODE=hardware。

オプションのキー(設定されていない場合はローカルフォールバック)— media-use を介してアセットをソース/生成するカテゴリでのみ必要:

キー使用目的フォールバック
GEMINI_API_KEY / GOOGLE_API_KEY画像生成(media-use 解決)生成をスキップ/検索のみ
(asset_scout / 検索プロバイダー)webpage/news/tweet + asset-fusion 実際のアセット検索カテゴリはアセットフリーに劣化

フロー

ステップ 0 — 初期化

cwd はエージェントワークスペースルート。すべてのアーティファクトを PROJECT_DIR = videos/<project-name>/ 以下に書き込みます。<project-name>: ユーザーから指定されたディレクトリを使用するか、それ以外の場合はインテントから短いケバブケース名を使用します(<subject>-motion)。ワークスペースのベース名やタイムスタンプは使用しません。

$PROJECT_DIR/hyperframes.json が存在しない場合のみ:

PROJECT_DIR="${MOTION_GRAPHICS_DIR:-videos/<project-name>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank

init はインストールされているスキルをGitHubの最新版と比較し、古いものがあればグローバルセットを更新します。

制約: ワークスペースルートで hyperframes init を決して実行しないでください。PROJECT_DIR 内に別の hyperframes/ をネストしないでください。すべてのBashコマンド(マスター + サブエージェント)は (cd "$PROJECT_DIR" && ...) サブシェルで実行します — 裸の cd は絶対に使用しません。

ステップ 1 — 計画(サブエージェント: ディレクター パート1)

1つのサブエージェントをディスパッチ。プロンプト = agents/director.md 全文 + ## Dispatch context(SKILL_DIR / PROJECT_DIR / ユーザーのリクエスト / Schema: <SKILL_DIR>/references/shot-plan-ir.md)。これにより以下が実行されます:

  1. 判断: これには検索が必要か?(最初の分岐)
    • いいえ → フォームカテゴリ(kinetic-type / stat / charts / logo-reveal / lower-thirds)を選択。コンテンツはユーザー提供。asset_needs: []。
    • はい → 検索計画を asset_needs[] に出力(news / web / tweet / image; 二極クエリ)。具体的な検索駆動型カテゴリ(webpage / news / tweet / asset-fusion)はステップ2で返されるコンテンツタイプによって確認され、ステップ3で確定します。
  2. ドラフト shot-plan.json を書き込みます(エンベロープ + 選択されたフォームカテゴリ または 検索インテント + asset_needs + 1パラグラフのショットブリーフ)。スキーマ: references/shot-plan-ir.md。

検証: [ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo missing

ステップ 2 — ソース ◇(Bash: media-use、条件付き)

shot-plan.json.asset_needs が空でない場合、アセットを解決します(検索/生成/取得 → 固定されたプロジェクトローカルパス + 台帳)。詳細は phases/source/guide.md(media-use resolve をラップ。検索駆動型カテゴリはnews/web/tweet/image検索を使用)を参照。asset_needs が空の場合、ステップ3にスキップします。

# 参考 — phases/source/guide.md を参照
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/source/resolve.mjs --plan ./shot-plan.json --out ./assets)

優雅に劣化: 検索/プロバイダーが利用できない場合、カテゴリはアセットフリーにフォールバックします(context.log に記録)。

ステップ 3 — デザイン(サブエージェント: ディレクター パート2)

サブエージェントをディスパッチ(プロンプト = agents/director.md パート2 + ディスパッチコンテキスト(ステップ2が実行された場合は解決済み assets/index.md を含む)+ catalog-map.md)。ショットを利用可能なアセットに基づいてデザインします: カタログブロック + hyperframes-animation ルール/ブループリント、レイアウト、モーション、ビート、(asset-fusion の場合は)element_positions + スポイトパレットを選択。shot-plan.json を確定します(content.block + content.customize + カテゴリごとのコンテンツ)。

ステップ 4 — ビルド(サブエージェント: ビルダー、再利用ファースト)

サブエージェントをディスパッチ。プロンプト = agents/builder.md 全文 + ディスパッチコンテキスト(shot-plan.json、catalog-map.md、カテゴリの module.md、references/motion-vocabulary.md、references/builder-contract.md)。再利用ファースト: npx hyperframes add <block> + その場でカスタマイズ。ギャップとアセットフュージョンアフォーダンスのみ手動で作成。出力は compositions/index.html で、HFコントラクト(一時停止されたGSAPタイムライン window.__timelines、class="clip" + 安定したID、tl.seek(0)、決定論的)に準拠します。

ステップ 5 — レンダリング(Bash)

(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q draft -o ./renders/video.mp4)
# 透明オーバーレイバリアント: --format webm (または mov)

ステップ 6 — 検証(Bash → 障害時に修復サブエージェント)

(cd "$PROJECT_DIR" && npx hyperframes lint . && npx hyperframes inspect .)

exit 0 → 完了。lint/inspect エラーが発生した場合、修復サブエージェントをディスパッチします(agents/finalize.md: スナップショットQA + 1回のその場修正パス + 再レンダリング)。修復中に固定期間を変更しないでください。

レポート + オプションのプレビュー

最終出力(renders/video.mp4、または .webm / .mov オーバーレイバリアント)+ 期間を報告します。実行中にプレビューを開かないでください。 要求があった場合にのみ、レンダリング後に開始して最終ファイルを提供します:

(cd "$PROJECT_DIR" && npx hyperframes preview)   # Studio UI。または共有可能なリンク用に `npx hyperframes play`

フラグは hyperframes-cli スキル(references/preview-render.md)にあります。

再開テーブル

状態続行箇所
shot-plan.json がないステップ1(計画)
shot-plan.json に asset_needs があるが、assets/ がないステップ2(ソース)
shot-plan.json 最終版だが、compositions/index.html がないステップ3/4(デザイン+ビルド)
compositions/index.html は存在するが、renders/video.mp4 がないステップ5(レンダリング)+ ステップ6
renders/video.mp4 が存在するレポート + 停止

デザインノート(メンテナー向け — 実行時は読み込まれません)

  • アセットファーストの根拠: 調達は先行して行われ、ショットデザインに情報を提供します(RWAフロー: 分析 → 検索 → レビュー → 構成)。検索駆動型カテゴリ(webpage/news/tweet)と asset-fusion はどちらもmedia-use検索(news/web/tweet/image)に依存しており、これはmedia-useの文書化されたRWA系統です。
  • 再利用ファースト: エコシステム内のLLM生成テンプレートに相当するものは、「カタログブロック + hyperframes-animation ルールを構成する」です。HFの一時停止されたGSAPタイムラインは、Remotionの useCurrentFrame に相当します。
  • カテゴリモジュールコントラクト: 1つの categories/<id>/module.md(計画 + ビルド)。references/motion-vocabulary.md(+ オプションの評価)を共有します。カテゴリの追加 = フォルダをドロップ + agents/director.md に分類子行を登録 + catalog-map.md に行を追加。フェーズパイプラインは変更されません。
  • ディレクトリ構造:
    videos/<project-name>/
      hyperframes.json  context.log
      shot-plan.json            # IR(ディレクター出力)
      assets/  assets/index.md  # media-use出力(ソースされた場合)
      compositions/index.html   # ビルダー出力
      renders/video.mp4
    
  • 登録: hyperframes ルーター内 — 「デザイン主導のショートモーショングラフィック」インテント + ワークフローの説明を追加。/general-video からモーショングラフィックトリガーを切り出し。逆の「使用禁止」エッジを追加。詳細は motion-graphics-genre.md §§5-7 を参照。

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

関連スキル