Communitygithub.com

1345AbhishekKumar/starter-nextjs

短いモーション優先の動画制作スキル(キネティックタイポグラフィ、カウントアップ、データ可視化など)。ナレーション無し、10秒未満~最大30秒の動画をMP4または透明オーバーレイで生成します。

starter-nextjs とは?

このスキルは、ナレーションや実写を伴わない、短くデザイン主導のモーショングラフィックを生成するためのエージェントスキルです。キネティックタイポグラフィ、データのカウントアップ、グラフ、ロゴスティング、ロウワーサードなど、10秒未満から最大30秒程度の動画に適しています。対応プラットフォームはmacOS Apple SiliconとLinux x64で、`npx hyperframes`コマンドラインツールを中心に動作します。ワークフローは「初期化→計画(検索要否の判断)→アセット調達→デザイン→ビルド→レンダリング→検証」の順で進行し、アセットファーストのアプローチを採用することで、実際の素材に基づいた効率的な制作を実現します。出力形式はMP4または透過WebM/MOVです。

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

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

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

ドキュメント

モーショングラフィック — ディスパッチエントリ

Step 0の前にルートを確認してください。 このスキルは、短く、デザイン主導で、ナレーションのないモーショングラフィック(モーションがメッセージ;~10秒未満、ボイスオーバーなし)を制作します。より長く、マルチシーン、またはナレーション付きの作品は /general-video へ。Webサイトのナレーション付き動画は /website-to-video へ。トピック解説は /faceless-explainer へ。プロダクトプロモーションは /product-launch-video へ。既存映像へのキャプションは /embedded-captions へ。対象外: ライブ/レンダリング時のデータ、またはキャプチャできない映像。モーションファーストかナレーション付きか不明な場合? 最初に /hyperframes をお読みください。

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

フェーズ実行主要アーティファクト詳細な流れ
initBashhyperframes.jsonStep 0
planサブエージェント — 検索要否の判断 + 分類 + アセット戦略shot-plan.json(ドラフト: カテゴリ、asset_needs クエリ、ブリーフ)agents/director.md(パート1)
source ◇Bash — media-use resolve(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つのグループに分割されます。その後、特定のカテゴリが選択されます。検索駆動型の場合は、検索が返すコンテンツのタイプによって決まります。各カテゴリは1つの 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 resolve)生成をスキップ / 検索のみ
(asset_scout / 検索プロバイダー)webpage/news/tweet + asset-fusion 実際のアセット検索カテゴリはアセットなしに縮退

フロー

Step 0 — 初期化

カレントワーキングディレクトリはエージェントワークスペースルート。すべてのアーティファクトを 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 は決して使用しないでください。

Step 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; 2極クエリ)。特定の検索駆動型カテゴリ(webpage / news / tweet / asset-fusion)は、Step 2で返されるコンテンツタイプによって確定され、Step 3で最終決定されます。
  2. ドラフト shot-plan.json を書き込みます(エンベロープ + 選択されたフォームカテゴリ または 検索意図 + asset_needs + 1段落のショットブリーフ)。スキーマ: references/shot-plan-ir.md。

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

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

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

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

グレースフルデグラデーション: 検索/プロバイダーが利用できない場合、カテゴリはアセットなしにフォールバックします(context.log に記録)。

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

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

Step 4 — ビルド(サブエージェント: ビルダー、再利用優先)

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

Step 5 — レンダリング(Bash)

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

Step 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 なしStep 1(計画)
shot-plan.json に asset_needs あり、assets/ なしStep 2(ソース)
shot-plan.json 最終版、compositions/index.html なしStep 3/4(デザイン+ビルド)
compositions/index.html 存在、renders/video.mp4 なしStep 5(レンダリング)+ Step 6
renders/video.mp4 存在レポート + 停止

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

  • アセットファーストの根拠: ソーシングはフロントローディングされ、ショットデザインに情報を提供します(RWAフロー: 分析 → 検索 → レビュー → 構成)。検索駆動型カテゴリ(webpage/news/tweet)と asset-fusion はどちらも media-use 検索(ニュース/ウェブ/ツイート/画像)に依存しており、これは media-use の文書化されたRWA系統です。
  • 再利用優先: LLM生成テンプレートのエコシステム内でのアナロジーは「カタログブロック + hyperframes-animation ルールを構成する」です。HFの一時停止されたGSAPタイムラインは Remotion の useCurrentFrame に相当します。
  • カテゴリモジュール契約: 1つの categories/<id>/module.md(計画 + ビルド)。references/motion-vocabulary.md(+ オプションのeval)を共有します。カテゴリの追加 = フォルダをドロップ + 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-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 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.

1345AbhishekKumar/starter-nextjs

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.

関連スキル