Communitygithub.com

1345AbhishekKumar/starter-nextjs

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

starter-nextjs とは?

このスキルは、HyperFramesプラットフォーム上でカスタム動画合成を作成するための汎用フォールバックワークフローを提供します。製品ローンチ、ウェブサイト解説、GitHub PR、既存映像のキャプション追加など、特定の用途に特化したワークフローが存在する場合はそちらを優先するよう設計されており、このスキルはそれらに当てはまらない自由形式の動画制作(タイトルカード、モンタージュ、ブランドリール、静的ループなど)に使用します。スキルは、ビジュアルアイデンティティの確立(house-style.mdとvideo-composition.mdの必須参照)、コンセプトアングルの特定、フォントの選定、前景密度計画など、厳格な設計プロセスを要求します。また、レイアウトより先にアニメーションを実装しない「レイアウトファースト」のアプローチを重視し、GSAPによるアニメーション前に静的HTML/CSSで最終状態を構築します。マルチシーン作品ではプロンプト拡張を実行し、音声・BGM・効果音の生成には統合オーディオエンジン(hyperframes-media)を使用します。このスキルは、Claude Code、Cursor、CodexなどのAIエージェントツールで動作するよう設計されています。

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

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

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

ドキュメント

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

general-video — 汎用動画ワークフロー

ルートを確定してからビルドしてください。 これはカスタム合成オーサリングのためのフォールバックです。入力が特定のワークフローに明確に適合する場合は、そちらを優先してください:販売製品 → /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要素」)を提供し、これによって「プロデュースされた」出力と「生成された」出力が区別されます。片方だけを読むのは最も一般的なミスです。video-composition.md はエージェントが飛ばしがちなものであり、フラットで中央寄せのウェブページ的な出力を防ぐためにまさに必要なものです。パレットを自己発明してこれらをスキップしないでください。hyperframes-creative への移行はここでは必須であり、オプションの分岐ではありません。そこから、必要に応じて名前付きスタイル/ムード → references/visual-styles.md、またはインタラクティブピッカー → references/design-picker.md も取得してください。スペック/スタイルはブランドを定義するものであり、構成ルールを定義するものではありません。

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

<ハードゲート> 構成HTMLを記述する前に、以下の4つすべてを確認したか検証してください:

  1. ビジュアルアイデンティティ — スペックまたは house-style.md に基づいており、その場で発明されたものではないこと。(#333、#3b82f6、Roboto に手を伸ばしていますか? スキップしています。)
  2. 1文のコンセプトアングル(「アングルを見つける」ステップ) — 些細な編集を超えるものについて、プロンプトの単語を文字通りに再構成したものではないこと。
  3. 埋め込みリストからのフォントペアリング(hyperframes-creative/references/typography.md → 「埋め込まれるフォント」) — 意図的に選択されていること。デフォルトで Inter/Helvetica Neue/system-ui ではなく、埋め込まれていない表示用フォントをレンダリングされることを期待して使用しないこと(バンドルされていない名前は、ローカルで自動キャプチャされた場合のみ埋め込まれます。クラウドレンダリングではキャプチャされません)。
  4. video-composition.md からの前景/密度計画 — エッジアンカー、8〜10要素、前景メタデータ、背景テクスチャのルール。(フラットカラー上の中央スタックで、要素が6つ未満で、エッジアンカーのディテールがない? スキップしています — それが汎用的な兆候です。) </ハードゲート>

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

すべてのマルチシーン構成で実行します(シングルシーン作品と些細な編集はスキップ)。リクエストをデザインスペックとハウススタイルに基づいて、下流の作業が同じ方法で読み取る一貫した中間表現に落とし込みます。hyperframes-creative/references/prompt-expansion.md を参照してください。

ステップ3 — 計画

HTMLを記述する前に、高いレベルで考えてください:

  1. 何を — 視聴者体験:ナラティブアーク、キーモーメント、感情的なビート。
  2. 構造 — いくつのコンポジションか、サブコンポ vs インラインか、どのトラックがビデオ / オーディオ / オーバーレイ / キャプションを運ぶか。モノリシック単一ファイル vs モジュラーサブコンポの判断については、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 / ハードゲートでも条件付けられている。「生成された」ではなく「プロデュースされた」前景ディテーリング)
キネティックタイポグラフィ / テキスト主体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(事前にバンドを抽出し、モーションにマッピング)
ナレーション / ボイスオーバー / 音楽 / 効果音 / キャプション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": "穏やかなシネマティックアンダースコア" }, // "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-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

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

関連スキル