Communitygithub.com

1999AZZAR/designer-mcp

HyperFramesのエントリーポイント。ビデオ、アニメーション、モーショングラフィックの作成、編集、アニメート、レンダリングリクエストは最初にこれを読むこと。プロジェクトの状態を再開し、意図を捕捉し、ワークフローを選択・インストールし、ドメイン機能をルーティングします。

designer-mcp とは?

このスキルは、HyperFramesフレームワークにおけるすべてのビデオ制作リクエストの必須エントリーポイントです。HyperFramesはHTMLからビデオをレンダリングし、DOMの`data-*`属性でタイミングを宣言するコンポジションを使用します。このスキルは、新規作成、既存プロジェクトの編集、診断、プレビュー、公開、バッチレンダリングなど、あらゆる操作を処理します。状態テーブルを使用してプロジェクトのコンテキストを評価し、適切なアクション(例:意図インタビューの実行、既存のBRIEF.mdからの再開、特定の操作の直接実行)を決定します。また、新規作成をデリバラブルタイプ(例:スライドショー、モーショングラフィックス、商品ローンチビデオ)に基づいて10の専用ワークフローのいずれかにルーティングします。ワークフローをインストールして入力する前に、各ルートの契約を検証し、CLIのアップグレードを管理してプロジェクトの再現性を確保します。このスキルはファーストパーティエージェント(Claude Codeなど)とサードパーティのMCP互換ツールの両方で動作し、`/hyperframes-cli` CLIツールと連携してレンダリング、プレビュー、診断を実行します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/1999AZZAR/designer-mcp/tree/HEAD/skills/video/engine/hyperframes

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

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

ドキュメント

HyperFrames エントリーポイント

HyperFrames は HTML からビデオをレンダリング します。コンポジションは、data-* 属性でタイミングを宣言する HTML ファイルであり、そのアニメーションランタイムはシーク可能で、メディア再生はフレームワークが所有します。完全なオーサリング契約は /hyperframes-core にあります。コンポジション HTML を書く前にそれを読んでください。ブリーフ、ストーリーボード、レビュー、プロダクション、ディスパッチ、フレームワーカーの契約は、このスキルの references/ にあります。

1. プロジェクトの状態から開始する

最初に一致する行を適用し、それより下の状態行を評価しないでください:

状態アクション
既存の Remotion ソースから HyperFrames への明示的な移植references/routes/remotion-to-hyperframes.md を読み、そのワークフローに直接ルーティングします。インテント層をスキップします。
既存の HyperFrames プロジェクトに対する特定の操作:検査、診断、検証、プレビュー、レンダリング、公開、バッチレンダリングその操作のみを実行します。インテントとワークフロールーティングをスキップし、/hyperframes-cli と必要なドメインスキルをロードします。
既存のプロジェクトに対する特定の編集編集を行います。インテント層を実行しないでください。プロジェクトのタイムライン(トラック、クリップ、開始、終了、再生内容)を確認するには、index.html とすべてのサブコンポジションファイルを読む代わりに npx hyperframes timeline [--json] を実行します。
BRIEF.md が存在するworkflow と flow を読みます。そのワークフローを実行します。flow: companion は常に /general-video で実行されます。ブリーフに関する質問はしません。
ブリーフはないが、hyperframes.json または STORYBOARD.md が存在するプロジェクトファイルと記録された設定から再開します。既存のアーティファクトから所有するワークフローを推測します。一意に決定できない場合は、ルーティングのみの質問を1つ行います。インテントインタビューは実行しません。
新規作成インテント層(references/intent-interview.md)を実行し、§2のテーブルを使用して一度ルーティングします。

新規リクエストが主題や入力を特定しない場合、ルーティングの前にビデオの内容を質問します。何かを質問する前に、設定とレシピを確認します(references/intent-interview.md、ステップ1)。figma.com 入力または名前付きレシピは、インテークを変更しますが、ルーティングは変更しません。インタビューの「Adapt orthogonal inputs」セクションが両方を処理します。

プロジェクトの CLI を最新に保つ

スキャフォールドされたプロジェクトは、package.json スクリプトで hyperframes@<version> を固定するため、レンダリングは再現可能です。この固定は自動的に更新されることはなく、古いCLIの固定された実行は警告を出力しません。スクリプトに固定が含まれているプロジェクトを再開する場合、レンダリングに影響を与える最初のコマンドの前に一度だけプローブします:

npx hyperframes@latest upgrade --project . --check

プローブは読み取り専用で、固定を最新リリースと比較します。明示的な . を維持してください。古いCLIリリースでは、ベアな --project の後に別のフラグが続くと、そのフラグをディレクトリ値として消費します。プロジェクトが最新リリースより遅れていると報告された場合(またはCLI出力にその旨が既に表示されている場合 — 固定されたスクリプトからの stderr 通知 This project pins hyperframes@… (latest …) または --json 結果の _meta.updateAvailable: true)、npx hyperframes@latest upgrade --project . で適用し、その後 npx hyperframes check で確認します。チェックが成功すると、プロジェクトのコンポジションが新しいバージョンでも検証できることが確認されます(レンダリング出力が古い固定とフレーム同一であることを確認するわけではありません)。したがって、成功したバンプは決して黙って行われません。実行サマリーで古いバージョンと新しいバージョンを名前で示します。まだコンポジションがないプロジェクトは確認を必要としません。チェックが失敗した場合、package.json の変更を元に戻し、固定されたバージョンを継続し、プロジェクトがどのバージョンに留まるか、その理由を報告します。シグナルをユーザーに中継するのではなく、それに基づいて行動します。バンプされた固定を未確認のままにしないでください。

2. 新規作成をルーティングする

最初に一致する行を使用します。デリバラブルを、単に言及された単語やファイルタイプではなく、リクエストされたものと照合します。

優先度リクエストワークフロー
1既存の Remotion ソースの明示的な移植/remotion-to-hyperframes
2プレゼンテーション、ピッチデッキ、ナビゲート可能なインタラクティブデッキの作成/slideshow
3既存のトーキングヘッド映像に変更を加えずに、プレーンなキャプションや字幕を追加/embedded-captions
4既存のトーキングヘッド、インタビュー、ポッドキャスト映像に、映像を変更せずにデザインされたグラフィックオーバーレイを追加/talking-head-recut
5音楽トラックからビート同期ビデオを作成(ナレーションやウェブサイトキャプチャなし)/music-to-video
6明示的に短く、ナレーションなし、モーション優先の単位を作成(通常10秒未満)/motion-graphics
7GitHub プルリクエストまたはコード変更を PR 参照から説明/pr-to-video
8URL またはサイト固有のブリーフからウェブサイト、製品サイト、アプリ、会社をマーケティングまたは紹介/product-launch-video
9製品やサイトのキャプチャなしで、発明されたビジュアルでトピック、記事、メモを説明/faceless-explainer
10その他のカスタムビデオまたはコンポジション/general-video

ルートを確定する前に、references/routes/<workflow>.md を読んでください。ルートごとに1つの小さなファイルです。各ルートの正規の入出力/トリガー契約(遅延インストールされたワークフロースキルが利用可能になる前に利用可能)と、そのルートのインタビューエントリが含まれます。候補がその契約を満たさない場合は、強制的に一致させるのではなく、ルーティングを続行します。一致したルートのファイルのみを読みます。

一般的な曖昧さを解決する

  • 短いアニメーションタイトル、ロゴスティング、スタットヒット、チャートヒット、マップヒット、スタンドアロンの lower-third は、ナレーションがなくモーションがメッセージである場合、/motion-graphics です。静的タイトルカード、ナレーション付きシーケンス、長めのモンタージュ、カスタムループは /general-video です。
  • 明示的に短いモーショングラフィックは、URL、ツイート、記事、スクリーンショットをソース素材として使用する場合があります。「このサイトからビデオを作成する」という一般的なリクエストは /product-launch-video です。
  • キャプション付きの既存映像は /embedded-captions にルーティングされます。デザインされた情報カード付きの映像は /talking-head-recut にルーティングされます。映像のリタイミング、並べ替え、再着色、フレーム変更、リミックスはカスタム編集であり、/general-video にフォールスルーします。
  • 音楽ファイルが /music-to-video を選択するのは、そのビートグリッドが作品を駆動する場合のみです。BGM として使用される音楽は、主題に一致したルートをオーバーライドしません。
  • 「ストーリーボードが欲しい」は、ワークフローではなく、レビュープロセスを変更します。他にルーティングシグナルがない場合は、/general-video を使用します。確認されたスケッチ storyboard.html 自体がリクエストされたデリバラブルである場合があります。レビューループがその停止点を定義します。
  • 専門的なナラティブワークフローは約3分までをサポートし、30〜90秒で最も強力です。明らかに長い作品は /general-video にルーティングします。長さは、明示的な移植、デッキ、キャプション、オーバーレイ、または音楽駆動のデリバラブルを決してオーバーライドしません。

3. 一度ルーティングしたら、そのままにする

新規作成の場合、インテント層(references/intent-interview.md)が完全な会話(メモリ、トリアージ、ピッチラウンド、マストハブ、実行形状、ハンドオフ)を実行し、BRIEF.md を書き込んで終了します。ブリーフはワークフローが読み取る唯一のルーティングアーティファクトです。後でこのスキルやインタビューを再開することはありません。「ルートに必要なものは何か?」という後続の質問にはすべて BRIEF.md から答えます。

4. ワークフローをインストールして開始する

選択したワークフローを読む前に、ワークフローとコアドメインスキルをインストールまたは更新します:

npx hyperframes skills update <workflow-name>

/ なしのベア名を使用します。コマンドが失敗した場合はエラーを表示します。メモリからワークフローを再構築しないでください。インストールに関するその他のすべて(コアと遅延の分割、init が更新するもの、診断、CIオプトアウト、CLIがない場合のフォールバック)は references/skill-lifecycle.md にあります。

5. 必要に応じてドメインスキルをロードする

ニーズスキル
コンポジション構造、タイミング属性、トラック、変数、決定性/hyperframes-core
モーションルール、シーンブループリント、トランジション、ランタイムアダプター/hyperframes-animation
シークセーフな GSAP、CSS、Anime.js、WAAPI、FLIP、パス、マスク、SVG、3D キーフレーム、または hyperframes keyframes 診断/hyperframes-keyframes
デザイン仕様、コンセプト、パレット、タイポグラフィ、ナレーション、ビート計画/hyperframes-creative
画像、アイコン、ロゴ、オーディオ、キャプション、グレード、LUT、再利用可能なメディア/media-use
ボイスオーバーカーブ、オーディオエフェクトチェーン、オートメーションエンベロープ、または複数トラックにわたる1つのチェイン/フェーダー(サブミックスバス)/hyperframes-audio
Init、lint、check、snapshots、compare、バッチレンダリング、Studio、レンダリング、公開、または診断/hyperframes-cli
レジストリブロックとコンポーネント/hyperframes-registry
名前付きルック、エフェクト、処理、トランジション — CRT スキャンライン、グリッチ、フィルムグレイン、シャイマースイープ、紙吹雪バースト — 手動構築の前に/hyperframes-registry
Figma アセット、トークン、コンポーネント、または再構築されたモーションとしてのストーリーボードフレーム/figma

クリエイター編集フレーズはクロスドメインリクエストです。一致する行に名前のあるすべてのスキルをロードします:

クリエイターリクエスト必要なドメイン
「この映像をカット」、ハードカット、トリム、スプライス、並べ替え、またはソース範囲を使用/general-video + /hyperframes-core;コアが data-start、data-duration、data-media-start、およびトラックレイアウトを所有します。
ここにズームイン、パンチイン/パンチアウト、スムーズなマルチステートズームまたはフレーム変更、Ken Burns、またはカメラ移動/general-video + /hyperframes-core + /hyperframes-keyframes;タイムドクリップではなく、内部のビジュアル/クロップラッパーをアニメートします。
マッチカットまたはウィップパンカメラトランジション/general-video + /hyperframes-animation + /hyperframes-keyframes + /hyperframes-registry;手動オーサリングの前にトランジションプリミティブを検索/インストールします。
フェード、クロスフェード、トラックゲイン/ボリューム、オートメーション、ダッキング/カーブ、オーディオエフェクト、または複数トラックにわたる1つのエフェクト/general-video + /hyperframes-core + /hyperframes-audio;コアがクリップを配置し、オーディオが配置されたトラックをミックスします(それらのグループに対するサブミックスバスを含む)。
カットをカメラモーションまたはミキシングと組み合わせるピクチャーアンドサウンド編集

Individual skills in this repo

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

1999AZZAR/designer-mcp

SOTA animation and physics heuristic guide using motion.dev

1999AZZAR/designer-mcp

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.

1999AZZAR/designer-mcp

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.

1999AZZAR/designer-mcp

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.

1999AZZAR/designer-mcp

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.

1999AZZAR/designer-mcp

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.

1999AZZAR/designer-mcp

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

1999AZZAR/designer-mcp

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

1999AZZAR/designer-mcp

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.

1999AZZAR/designer-mcp

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

1999AZZAR/designer-mcp

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.

1999AZZAR/designer-mcp

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

1999AZZAR/designer-mcp

Use when building or editing a HyperFrames project that people open in Studio: 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`.

1999AZZAR/designer-mcp

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.

1999AZZAR/designer-mcp

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.

1999AZZAR/designer-mcp

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.

1999AZZAR/designer-mcp

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.

1999AZZAR/designer-mcp

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.

1999AZZAR/designer-mcp

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.

1999AZZAR/designer-mcp

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.

関連スキル