Communitygithub.com

laviedezidane/hyperframes-skill

短く、デザイン主導のモーショングラフィック — 動きがメッセージそのもの。キネティックタイポグラフィ、統計カウントアップ、チャート/データ可視化、ロゴスティング/ブランドロックアップ、L3/コールアウト/ソーシャルオーバーレイ、アニメーション地図、アニメーションツイート/ニュース/ヘッドライン、Webページ/UIアニメーション、実画像の形状をチャートに融合。10秒未満(最大〜30秒)、ナレーションや実写はなし。MP4または透明オーバーレイでレンダリング。

hyperframes-skill とは?

このスキルは、短いデザイン主導のモーショングラフィックを作成するためのエージェントワークフローです。動きそのものがメッセージとなる、キネティックタイポグラフィ、統計カウントアップ、チャートやデータ可視化、ロゴスティング、L3/コールアウト、アニメーション地図、アニメーションツイートやニュース記事、Webページ/UIアニメーション、さらには実画像の形状をチャートに融合するアセットフュージョンなど、さまざまなカテゴリに対応しています。通常は10秒未満(最大約30秒)で、ナレーションや実写の被写体は含まれず、MP4または透明オーバーレイとしてレンダリングされます。より長い動画やナレーション付き、複数シーンの場合は、別のスキル(/general-video)にルーティングされます。このスキルは、Claude CodeやCursor、CodexなどのAIエージェントで使用するように設計されており、macOS Apple SiliconまたはLinux x64上で動作します。自律的に動作し、アセットファーストのアプローチで、検索、デザイン、ビルド、検証、レンダリングの各フェーズを経て、最終的な動画を生成します。

対応~Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/laviedezidane/hyperframes-skill/tree/HEAD/.agents/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で作成)に配置されます。以下のすべてのパスは、それに対する相対パスです。

フェーズ実行主要成果物詳細フロー
initBashhyperframes.jsonステップ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
verifyBash — lint、check、プルーフスナップショット;失敗時は修復snapshots/contact-sheet.jpgステップ5
approveプレビューを開く;レンダリングか変更かを尋ね、回答を待つ明示的なレンダリング承認ステップ6
renderBash — hyperframes render(MP4、またはオーバーレイの場合は --format webm/mov)renders/video.mp4 または透明オーバーレイステップ6

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

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

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

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

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

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

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

ステップ 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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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

laviedezidane/hyperframes-skill

Agent Media OS for 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. When the host app provides its own music or sound-effect tools, use those for music and sound effects; `resolve --type bgm|sfx` needs the heygen CLI. When `HEYGEN_API_BASE` is set, HeyGen calls go through that host with no CLI sign-in.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

関連スキル