Communitygithub.com

samyakiasonline-ctrl/hyperframe

短くデザイン主導のモーショングラフィック——動きそのものがメッセージ。キネティックタイポグラフィ、統計カウントアップ、チャート/データ可視化、ロゴスティング/ブランドロックアップ、ローワーサード/コールアウト/ソーシャルオーバーレイ、アニメーション地図(地域ハイライト、場所の接続、ズームイン)、アニメーションツイート/ニュース記事/見出し、ウェブページ/UIアニメーション(スクロール、カーソル、コールアウト)、または実画像のジオメトリをチャートに融合。通常10秒以下(最大約30秒)、ナレーションや実写被写体なし。MP4または透明オーバーレイでレンダリング。長時間/ナレーションあり/マルチシーンは/general-videoへ。不明な場合は/hyperframesへ。

hyperframe とは?

これは、短くデザイン主導のモーショングラフィックを作成するためのAIエージェントスキルです。動きそのものがメッセージであり、ナレーションは不要です。キネティックタイポグラフィ、統計カウントアップ、チャート、ロゴアニメーション、ローワーサード、マップアニメーション、ツイートのアニメーション、ウェブページ/UIアニメーション、画像融合チャートなど、幅広いカテゴリをサポートします。このスキルは自律的に動作し、1回の確認質問の後、計画、ソーシング、設計、構築、検証、承認、レンダリングの各フェーズを中断することなく実行します。主にFigmaからのアセットを活用し、再利用を重視したビルド戦略により、短い動画を効率的に生成します。macOS Apple SiliconまたはLinux x64上で動作し、最終出力はMP4または透明オーバーレイ形式でレンダリングされます。

対応~Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/samyakiasonline-ctrl/hyperframe/tree/HEAD/.claude/skills/motion-graphics

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

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

ドキュメント

プラグインインストール: セットアップまたは更新コマンドの前に、このスキルがHyperFramesプラグイン内にある場合は、プラグイン実行ルールに従ってください。スタンドアロンインストールの場合は、以下の更新手順を維持してください。

最初に、このスキルを最新に保つためにユーザーに確認してから実行: npx hyperframes skills update motion-graphics。すべてが最新の場合は高速なno-op。そうでなければ、このスキルとそれが依存するコアドメインスキルを、それらに依存する前に更新します。

figmaソース: 構築元のロゴ/アセット/アニメーションがfigma.comのURLから来る場合は、最初に/figmaを実行してください。アセットのエクスポート、ブランドトークン、およびグラフィックがFigma Motionのインポートである場合はMotion→GSAP変換を行い、その出力から構築します。生のMCPツールで直接Figmaを操作しないでください。SVGサニタイゼーション、.media/manifest.jsonlの来歴、ブランドトークンvar()バインディングがスキップされ、後でブランド変更があっても完全な再インポートなしでは伝播できなくなります。

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

玄関は/hyperframesです。 このスキルは短く、デザイン主導で、ナレーションのないモーショングラフィック(動きがメッセージ、約10秒未満、音声なし)を作成します。これより長い、ナレーション付き、マルチシーン、または不確かな場合は、最初に/hyperframesを読んでください:インテントレイヤーがすべてのルート決定を所有します。

このワークフローは設計上自律的です。最大1つの確認質問(agents/director.md)の後、中間レビューなしで検証まで構築します。インテントレイヤー(/hyperframes → references/intent-interview.md)は、実行形状に関する質問なしでここに直接ルーティングします。このような短い作品にストーリーボードやコンパニオンセッションを追加しても意味はほとんどありません。レンダリングは依然としてユーザーゲートです:チェックとプルーフスナップショットが合格した後、Studioプレビューを開き、../hyperframes/references/brief-contract.mdにある標準的な「今レンダリングしますか、それとも変更しますか?」の質問をします。BRIEF.mdが存在する場合は、ディレクターの質問の前にそれを読んでください。

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

フェーズ実行主要アーティファクト詳細フロー
初期化Bashhyperframes.jsonステップ0
計画サブエージェント — 検索するか決定 + 分類 + アセット戦略shot-plan.json(ドラフト:カテゴリ、asset_needsクエリ、概要)agents/director.md(パート1)
調達 ◇Bash — media-useリゾルブ(asset_needsが空の場合はスキップ)assets/ + assets/index.mdphases/source/guide.md
デザインサブエージェント — 解決済みアセットを中心としたショットデザインshot-plan.json(最終:ブロック + レイアウト + モーション + 位置)agents/director.md(パート2)
構築サブエージェント — 再利用優先の構成compositions/index.htmlagents/builder.md
検証Bash — lint、check、プルーフスナップショット;失敗時に修復snapshots/contact-sheet.jpgステップ5
承認プレビューを開く;レンダリングか変更かを尋ねる;回答を待つ明示的なレンダリング承認ステップ6
レンダリングBash — hyperframes render(MP4、または透明オーバーレイの場合は--format webm/mov)renders/video.mp4 または透明オーバーレイステップ6

◇ 調達は、選択されたカテゴリがアセットを宣言している場合にのみ実行されます。純粋なコード/テキストカテゴリ(例: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-* + レジストリオーバーレイブロック
maps地理的モーション — 地域のハイライト、場所の接続、場所へのズームイン(ベクターレーン、または焼き込みベースマップレーン)us-map / world-map ファミリー + bake-basemap.mjs

検索駆動カテゴリ — まず検索し、次にコンテンツタイプでアニメーション化(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 --skill=motion-graphics

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 / maps)。コンテンツはユーザー提供。asset_needs: []。
    • はい → 検索計画をasset_needs[]に出力(ニュース/ウェブ/ツイート/画像、2極クエリ)。具体的な検索駆動カテゴリ(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をラップ。検索駆動カテゴリはニュース/ウェブ/ツイート/画像検索を使用)を参照してください。asset_needsが空の場合は、ステップ3にスキップします。

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

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

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

ステップ 4 — 構築(サブエージェント:ビルダー、再利用優先)

共有のモーション原則をビルダーのディスパッチコンテキストに含めてください。charts と stat については、データ in モーションも含めてください。ビルダーはタイムラインを書く前にこれらのガイドを読みます。

サブエージェントをディスパッチ。プロンプト = 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を出力します(window.__timelines上の一時停止GSAPタイムライン、class="clip" + 安定したID、tl.seek(0)、決定論的)。

ステップ 5 — 検証(Bash → 失敗時に修復サブエージェント)

(cd "$PROJECT_DIR" && npx hyperframes check .)
(cd "$PROJECT_DIR" && npx hyperframes snapshot --at <proof-times>)

開始状態、特徴的な動き、最終ホールドを示すプルーフタイムを選択します。続行する前に、生成されたコンタクトシートまたはスナップショットシートを検査します。lint、check、またはスナップショットの失敗時に、その場で1回修正するために修復サブエージェント(agents/finalize.md)をディスパッチし、失敗したゲートを再実行します。欠陥を隠すためだけに固定期間を変更しないでください。

ステップ 6 — 承認とレンダリング(Bash)

Studioを開き、1つの質問をします:「今レンダリングしますか、それとも変更しますか?」。修正後、同じゲートに戻ります:

(cd "$PROJECT_DIR" && npx hyperframes preview --background)

明示的なレンダリング回答があった場合のみレンダリング:

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

出力が存在し、空でなく、意図した長さであることを確認します。最終的な引き渡しでは、アーティファクト名、実際の長さ、コンポジションまたはフレームID、プルーフタイム、および検査されたコンタクトシートまたはスナップショットシートを明記します。フラグは/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 存在、プルーフスナップショットなしステップ5(検証)
チェックとプルーフスナップショット合格、承認されたレンダリングなしステップ6(承認)
承認されたレンダリング存在出力を確認し、報告

設計ノート(メンテナー向け — 実行時はこれを読まない)

  • アセットファーストの配給

…[翻訳用に切り詰め]

Individual skills in this repo

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

samyakiasonline-ctrl/hyperframe

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

samyakiasonline-ctrl/hyperframe

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

samyakiasonline-ctrl/hyperframe

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

samyakiasonline-ctrl/hyperframe

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). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

samyakiasonline-ctrl/hyperframe

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

samyakiasonline-ctrl/hyperframe

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, timeline, history, clean, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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

samyakiasonline-ctrl/hyperframe

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

samyakiasonline-ctrl/hyperframe

Search, install, and wire registry blocks and components into HyperFrames compositions. Use BEFORE hand-building any named visual — whenever a brief, a user, or a storyboard names a look, effect, treatment, or transition such as CRT scanlines, glitch, chromatic aberration, film grain, a shimmer sweep, a chart, a code or terminal window, a map, or a confetti burst — because roughly 400 hosted items already cover many of them and the search ranks all of them with nothing installed, no project, and no account. Also use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

samyakiasonline-ctrl/hyperframe

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

samyakiasonline-ctrl/hyperframe

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

samyakiasonline-ctrl/hyperframe

Agent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal.

samyakiasonline-ctrl/hyperframe

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

Port an existing Remotion (React) composition''s source to HyperFrames HTML. Use ONLY on an explicit ask to port/convert/migrate/translate a Remotion source — one-way, Remotion-only. A passing Remotion mention, reference-only code, or "make something like my Remotion video" is a fresh build (/general-video). Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

Author a HyperFrames slideshow — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching, hotspot navigation, and built-in presenter mode with speaker notes; also converts an existing page into a deck. Output is a navigable deck, not a rendered MP4. If the user didn't explicitly ask for a slideshow, confirm before authoring. Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

Package an existing talking-head / interview / podcast video with timed, designed GRAPHIC OVERLAY cards — kinetic titles, lower-thirds, data callouts, quotes, side panels, picture-in-picture — synced to the transcript, on a 16:9 / 9:16 / 4:5 canvas of your choice; the clip plays untouched underneath. Trigger on "graphic overlays", "on-screen graphics", "package / dress up my video". Not plain subtitles (/embedded-captions). Unclear → /hyperframes.

関連スキル