Communitygithub.com

1999AZZAR/designer-mcp

長編・複数シーン作品、ブランドリール、モンタージュ、静止ループ、タイトルカード、フッテージリミックスなどを、専門ワークフローがない場合やBRIEF.mdのflowがcompanionの場合に作成・編集するスキル。モーション主体の短い作品はmotion-graphicsを使用。新規作成はhyperframes経由で行う。

designer-mcp とは?

このスキルは、Claude CodeなどのAIエージェントがHyperFramesを使って動画作品をゼロから作成したり、既存のプロジェクトを編集したりするためのものです。特に、複数シーンからなる長編作品、ブランドやインパクトを重視したリール、静止画ループ、タイトルカード、フッテージのリミックスなど、他の専門ワークフローに当てはまらないケースで役立ちます。サポートするプラットフォームはHyperFramesで、エージェントはまずプロジェクトの状態(新規作成、BRIEF.mdの有無、特定の編集指示など)を確認し、適切なアクションを取るように設計されています。特に`flow: companion`モードでは、エージェントは「請負人」ではなく「監督」として振る舞い、ユーザーの意図を深く理解した上で、最高品質の制作計画を提案します。また、メディアファイルやFigmaデザインを適切に取り込むためのアダプターを備え、事前定義されたルールに従って、一貫性のある高品質な結果を保証するために、制作の各段階で必要な知識を参照しながら進行します。

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

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

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

ドキュメント

一般的な動画

このワークフローに依存する前に、以下を実行してください:

npx hyperframes skills update general-video

成功したno-opはスキルが最新であることを意味します。記憶から続行する代わりに、更新失敗があれば報告してください。

1. 横断的ソースアダプターの適用

  • メディア: 音声、画像、アイコン、ロゴ、音声、グレーディング、LUT、処理/エフェクト、キャプション、またはメディア操作が必要な場合は、/media-use をロードし、../media-use/references/resolve.md(解決、採用、再利用)および ../media-use/references/setup-providers.md(プロバイダー、認証)に従ってください。曖昧なフッテージフィードバックや名前付きスタイルは、編集前に ../media-use/references/media-treatments.md を使用してください。サポートされているメディアエフェクトをCSS/SVG/不透明度で即興で作成しないでください。認証済みプロバイダーで最初のアクションを実行する前に、npx hyperframes auth status を実行し、その出力をそのまま中継してください。サインアウトしている場合は、../hyperframes/references/brief-contract.md のゲートを適用します。協力モードでは、サインインまたは明示的なオフライン選択を待ちます。自律モードでは、ステータスを述べ、利用可能なオフラインプロバイダーを通じて続行します。必要な機能を満たせるオフラインプロバイダーがない場合は、ブロッカーを報告してください。ローカル採用のみでは認証ゲートは必要ありません。
  • Figma: 入力が figma.com URLの場合は、最初に /figma を実行してください。エクスポートされたアセット、トークン、コンポーネント、またはストーリーボードフレームから構築してください。生のFigmaコネクタ呼び出しは、SVGサニタイゼーション、メディアの出所、ブランドトークンバインディングをスキップするため使用しないでください。

これらのアダプターは /hyperframes で選択されたワークフローを変更しません。

2. プロジェクトの状態から開始

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

状態アクション
特定の編集編集を実行し、既存のプロジェクト決定を維持し、影響を受けるチェックを再実行してください。ディスカバリーを再開しないでください。
BRIEF.md が存在するそれを読んでください。workflow が別のワークフローを指定し、flow が companion でない場合は、引き継いでください。ブリーフについて質問しないでください。
ブリーフなし、ただし hyperframes.json または STORYBOARD.md が存在するファイルと記録された設定から再開してください。既知の事実からのみ BRIEF.md をバックフィルしてください。
新規作成/hyperframes とそのインテントレイヤーを実行してください。workflow: general-video または flow: companion の場合のみ、ここに戻ってきてください。

新規プロジェクトの場合は、ブリーフからケバブケースのディレクトリ名を選択し、ブリーフを書く前に以下のコマンドでスキャフォールディングを行ってください:

npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video

次に、../hyperframes/references/brief-format.md を使用してプロジェクトルートに BRIEF.md を書いてください。既存のプロジェクトでは、ルートは hyperframes.json を含むディレクトリです。ブリーフフォーマットで指定された、確認済みの設定に基づくフィールドのみを記録し、node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT> を使用してください。推測されたデフォルトは決して記録しないでください。ここで <MEDIA_DIR> はインストールされた /media-use スキルディレクトリ、<PROJECT_ROOT> は hyperframes.json を含むディレクトリです。インテントレイヤーがレシピを採用した場合は、node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes <PROJECT_ROOT> --name <name> で今すぐ適用し、再度質問しないでください。

3. 実行形状の解釈

../hyperframes/references/brief-contract.md の正規用語のみを使用してください:

フィールド意味効果
flow誰が主導するかautomation: ルートを選択して実行します。companion: 会話の中で共同制作します。
storyboardビルド前に計画、スケッチ、レビューを行うかyes: 計画とスケッチレビューを実行します(storyboard.html)。no: それなしでビルドします。
派生 modeチェックポイントゲートの動作方法ブリーフコントラクトに従ってください。ユーザーにモードの名前を尋ねないでください。

これらの状態の同義語を発明しないでください。進行中の「とにかくビルドする」シグナルはインテントレイヤーによって処理され、flow: automation、storyboard: no として到着します。

  • flow: automation の場合、最初の進捗更新でルートを選択し、1行で述べてください。
  • 特定の編集の場合は、新しいルートを発明せずに編集を行ってください。

既存のフッテージのハードカット、トリム、スプライス、または並べ替えの場合は、同じビデオソースを複数のクリップ要素に複製してください。各コピーで、data-media-start と data-duration でソース範囲を設定し、data-start で著者の配置/順序を設定してください。別々に作成されたオーディオは、一致する <audio> 要素で同一のクリップ範囲とタイミングに従います。/hyperframes-core がこの時間的編集を担当します。ズーム、パンチ、パン、クロップ、マスク、または内側のラッパー上の clip-path などの視覚プロパティアニメーションには /hyperframes-keyframes のみを使用してください。../hyperframes-core/references/creator-editing-recipes.md から完全なコントラクトをコピーしてください。

コンパニオンフロー

flow: companion の場合:

  • BRIEF.md を読み、受け入れられた ## Assets と ## Customizations をプロジェクトアーティファクトと調整してください。受け入れられたがまだ保留中の作業を完了し、完了した作業はそのままにし、受け入れられた機能を新規であるかのように再度提供しないでください。
  • 請負人ではなく、監督として振る舞ってください。 コンパニオンを選択したユーザーは、関与と品質を選択したのです。正直な応答は、あなたが防御できる最小のバージョンではなく、あなたがデザインできる最良のバージョンです。最初の計画は天井の処理です。ストーリーアーク(最も近いジャンルのレンズを借用 — メニュー§ジャンルレンズ)、デザイン仕様、各シーンのモーション処理(§5の計画規律に従って名前で引用)、トランジション、オーディオアイデンティティ(音楽とサウンドマーク、または意図的な無音)、ユーザーの素材の配置、そしてデザインされたオープンとクローズを含みます。各レイヤーが何を追加するかを1行で述べてください。高価なもの(レンダリング時間、サインイン、請求)には名前を付けてフラグを立ててください。ユーザーは処理を削減します。承認ごとに組み立てさせるべきではありません。
  • 天井はツールボックスではなく、コンセプトに属します。 すべてのレイヤーはブリーフのメッセージに奉仕しなければなりません。どのビデオにも同じように装飾する処理は、単なる装飾です。クラフトは天井にまで高まりますが、コンテンツは決して要求されたものを超えて成長しません(§6)。
  • チェックポイント間では、../hyperframes/references/capability-menu.md は2つの方法で機能します。トリガーリストとして: ユーザーがその入力を言及したり、ビルドがそのニーズに達したときに関連する機能を提供します。各パスのアップグレードチャネルとして: 計画、スケッチ、またはビルドのチェックポイントは、ユーザーが見ている素材に向けられた1つまたは2つのトレースされたオファーを運ぶことがあります(「シーン3の統計にはカウントアップ処理が必要です」)。提供する前にそれを読んでください。完全なカタログを決してダンプしないでください。
  • ユーザーが機能を受け入れた後、そのアーティファクトを生成し、決定を即座に一致する BRIEF.md 本文セクションに記録してください。ユーザーが明示的に変更した場合のみ、フロントマターフィールドを書き換え、確認された設定を記録してください。
  • 同じストーリーボード、検証、最終プレビュー、レンダリング承認のゲートを維持してください。コンパニオンは誰が操縦するかを変えるのであって、どのような品質が必要かを変えるのではありません。

4. 各段階の前に必要な知識をロードする

これらの読み取りは、条件が一致する場合に必須です:

条件行動前に読むもの
任意の合成HTMLまたはシーンレイアウト/hyperframes-core; レイアウトコントラクトには references/determinism-rules.md を使用
任意の非自明な作成または視覚的処理/hyperframes-creative → references/house-style.md および references/video-composition.md
任意のモーション、アニメーション、またはシーントランジション/hyperframes-animation; そのルーティングに従い、一致するルール、アダプター、ブループリント、またはトランジションリファレンスへ
storyboard: yes../hyperframes/references/storyboard-format.md および ../hyperframes/references/review-loop.md
メディアアセットまたは操作(ナレーション、BGM、SE、キャプション、グレーディング、変換を含む)/media-use; フレームワークの再生と配置については /hyperframes-core → references/variables-and-media.md も読む
マルチシーンアセンブリ../hyperframes/references/production-loop.md
flow: companion、最初の計画の前/hyperframes-creative → references/story-spine.md および references/house-style.md; 最も近いジャンルレンズと ../hyperframes/references/capability-menu.md の全文 — 天井処理はこれらからデザインされ、記憶から呼び出されるわけではありません
コンパニオン機能オファー、キャプチャ、ビートグリッド、生成ビデオ、マップ、パブリッシング、またはクロスワークフロー機能../hyperframes/references/capability-menu.md
デザイン仕様が存在し、最終承認の前/hyperframes-creative → references/design-adherence.md

これらの読み取りを記憶で置き換えないでください。段階的開示は、一致するリファレンスが実際にロードされた場合にのみコンテキストを節約します。

5. 合成を実行する

この依存関係の順序を使用してください。入力がない場合のみステージをスキップしてください。

  1. 計画。 視聴者のアーク、構造、リズム、および期間ドライバーを述べてください。短い単一シーンには1つのファイルを使用してください。3つ以上のハードシーンカットや再利用されるシーンにはサブコンポジションを使用してください。ナレーションアークには /hyperframes-creative → references/story-spine.md、リズムには references/beat-direction.md、構造には /hyperframes-core → references/composition-patterns.md を読んでください。オープンエンドのマルチシーンブリーフの場合は、/hyperframes-creative → references/prompt-expansion.md を通じてプロンプトを拡張してください。マルチシーン計画は各シーンの形状を引用します。/hyperframes-animation → blueprints-index.md のブループリントID(適合する場合)、または適合するものがない場合は rules-index.md から構成する名前付きルールです。モーション名はこれらのインデックスから取得され、発明されたものではありません。ストーリーの真実がどのシーンが存在するかを決定し、引用がそれらを装飾します。計画で名前付きルックを自分で構築すると述べる前に、ライブカタログを検索してください。 ブリーフが「CRTスキャンライン」「グリッチ」「フィルムグレイン」「シャマースイープ」「紙吹雪バースト」など、あらゆるルック、エフェクト、処理、またはトランジションについて、npx hyperframes catalog --query "<ルックをわかりやすい英語で>" --json を実行し、そのルックの構築方法を計画が命名する前に上位の結果を読んでください。この検索には何もインストールする必要はありません。 プロジェクトも、事前の add も、アカウントも必要ありません。任意のディレクトリからホストされたレジストリ全体(約400のブロックとコンポーネント)をランク付けするため、ビルドの途中でユーザーが求めるルックにも適用できます。計画で命名されたブロックはステージ3でインストールされます。検索で適合するものが何も返ってこなかった場合にのみ、ルックを手作りしてください。マルチシーン計画はディスパッチアーティファクトとしても記録されます。STORYBOARD.md にシーンごとに1つの ## Frame N ブロック — status: outline、宣言された src:、ブループリント/ルールの引用、およびビートテキスト — を記載します。storyboard: no の場合でも同様です。 ブロックがディスパッチユニットであり、ストーリーボードシートはレビューサーフェスにすぎません。
  2. リクエストされた場合、計画をレビューします。 storyboard: yes の場合は、これらのブロックに対して共有レビューループを実行します。storyboard: no の場合は、計画の一時停止やスケッチシートなしで続行します。それでも計画の一時停止が発生した場合は、サブエージェント委任許可(ステップ4のディスパッチにCodexが必要とするもの)をその一時停止に折り込み、後で再び停止しないようにします。
  3. 依存関係を解決します。 並行作業の前にレジストリブロックをインストールします。ユーザーアセットをステージングし、既存のものを採用し、...

…[翻訳のために切り詰められました]

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

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

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.

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.

関連スキル