Communitygithub.com

1999AZZAR/designer-mcp

HyperFramesスライドショーを作成します。プレゼンテーション、ピッチデッキ、インタラクティブなデッキを、個別のスライド、フラグメント表示、分岐、ホットスポットナビゲーション、スピーカーノート付きのプレゼンターモードで作成します。既存のページをデッキに変換することも可能です。出力はナビゲート可能なデッキであり、レンダリングされたMP4ではありません。ユーザーが明示的にスライドショーを要求していない場合は、作成前に確認します。不明な場合は → /hyperframes。

designer-mcp とは?

このスキルは、HyperFramesフレームワーク上でスライドショー(プレゼンテーションデッキ)を作成するためのAIエージェント用設計書です。スライドは個別のシーンとして定義され、JSONアイランドと呼ばれる設定ブロックでスライドの順序、フラグメント(段階表示)、ホットスポット(分岐ナビゲーション)、スピーカーノートが管理されます。主に対応するプラットフォームはHyperFramesを利用するAIエージェント(例:Claude Code)であり、出力はブラウザ上で動作するインタラクティブなデッキです。ユーザーが明示的にスライドショーを依頼した場合のみ作成を開始し、曖昧なリクエスト(「プレゼンを作って」など)の場合は確認を求めます。Figmaからのアセット取り込みや、既存ページの移植にも対応し、元のデザインや動作を忠実に再現するルールが定義されています。

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

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

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

ドキュメント

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

figma ソース: デッキのコンテンツやストーリーボードがfigma.comのURLから来ている場合は、まず/figmaを実行します — アセットのエクスポート、ブランドトークン、およびソースがシーンフレームのストリップである場合のストーリーボードの再構築 — その後、その出力から構築します。Figmaを生のMCPツールで直接操作しないでください。SVGのサニタイズ、.media/manifest.jsonlの来歴、ブランドトークンのvar()バインディングがスキップされ、後でブランドを変更しても完全な再インポートなしでは反映されなくなります。

スライドショー作成契約

HyperFramesスライドショーは、通常のHyperFramesコンポジション(シーン、クリップ、GSAPタイムライン)に、1つの追加要素があります。それは、どのシーンがスライドで、それらがどのように接続されるかを宣言するJSONアイランドです。プレイヤーのSlideshowControllerがこのアイランドを読み取り、連続したGSAPタイムラインを個別のナビゲート可能なデッキに変換します。

最初に/hyperframes-coreを読んで、ベースのコンポジション契約(クリップ、トラック、data-*属性、決定論ルール)を理解してください。このスキルでは、新しい部分、つまりアイランドスキーマ、スライド作成ルール、フラグメント、分岐、検証、ラッピングコンポーネントのみをカバーします。

出力 — ナビゲート可能なデッキであり、線形MP4ではありません

スライドショーの出力は実行中のデッキです。hyperframes present <project-dir>(またはStudioのプレゼントモード)で提供します。プレイヤーのSlideshowControllerがアイランドを読み取り、ナビゲーション、フラグメント、分岐、プレゼンターモードを駆動します。プレゼンテーションと引き継ぎのセクションを参照してください。

スライドショーをhyperframes renderで単一のMP4にしないでください。 デッキは、複数のトップレベルシーンコンポジション(スライドごとに1つのdata-composition-id)として作成され、それらをラップするマスタールートコンポジションはありません。そのため、renderは最初のコンポジションのみを解決し、静かに切り詰められたMP4(例えば40秒のデッキのうち6秒のみ)を出力します。線形のメインラインエクスポート(メインスライドのみ、ブランチシーケンスは除外)は先送りされています。これが出荷されるまでは、サポートされる出力はライブのpresentデッキとスライドごとのsnapshot静止画です。ユーザーが今すぐ線形MP4を必要とする場合は、renderをデッキに向けるのではなく、この制限を伝えてください。

意図の確認

ユーザーが明示的にスライドショー、スライド表示、またはHyperFramesスライドショーを要求した場合は、このスキルを進めてください。リクエストが/hyperframesを経由して到着した場合、インテントレイヤーのトリアージがこの確認を担当します。ここにルーティングされたということは、すでに確認済みであることを意味するため、再確認は不要です。レイヤーの実行形状に関する質問は適用されません(成果物はデッキであり、レンダリングされたビデオではありません)。BRIEF.mdが存在する場合、それは確認済みの意図を保持しています。それを読んでください。

このスキルが、「プレゼンテーション」「ピッチデッキ」「デッキ」「インタラクティブデッキ」「このページを変換」などの隣接するリクエストからトリガーされた場合は、作成を一時停止し、確認を求める前に選択肢を提示してください。HyperFramesスライドショーが、個別のスライド、内蔵ナビゲーションとプレゼンターモード、編集可能なスピーカーノート、共有メディア処理、引き継ぎ前の検証を備えた実行可能なデッキであることを簡単に説明します。ソースページの変換の場合は、元のページのビジュアルデザイン、インタラクション、モーション、メディア動作を維持しながら、ページの移動をスライド間のトランジションに変換することを目標として説明することも含めます。

その後、短い確認質問をします:

これをHyperFramesスライドショーとして作成しますか?

環境が提供する場合は、はい/いいえの選択UIを使用します。それ以外の場合は、プレーンテキストで質問します。

ユーザーが「はい」と言うまで、スライドショーを実装しないでください。ユーザーが「いいえ」と言った場合、このスキルの使用を停止してください。/hyperframesを読み、インテントレイヤーに再ルーティングさせてください。この確認はルーティングの決定であり、好みのゲートではありません。../hyperframes/references/brief-contract.md § 1に従い、自律モードでもこれをスキップしません。「サプライズミー」でもスキップされません。間違った成果物タイプを構築することは品質の欠如であり、創造的な判断ではありません。


2つの構成要素

1. シーン — 通常の方法で宣言

すべてのスライドはシーンによって支えられています。シーンはdata-composition-id、data-start、data-duration、data-labelで宣言します:

<div
  data-composition-id="problem"
  data-start="0"
  data-duration="8"
  data-label="The problem"
  data-width="1920"
  data-height="1080"
>
  <!-- クリップはここに -->
</div>

ブランチスライド(ホットスポットからのみ到達可能で、メインラインからは除外される)もまったく同じ方法で宣言します。これらはアイランドのslideSequencesエントリにのみ表示され、メインのslides配列には表示されません。

2. JSONアイランド — コンポジションごとに1つのスクリプトブロック

コンポジションHTMLに、<script type="application/hyperframes-slideshow+json">ブロックを1つだけ追加します。これにはすべてのスライドショーメタデータが含まれます:

<script type="application/hyperframes-slideshow+json">
  {
    "slides": [...],
    "slideSequences": [...]
  }
</script>

アイランドは、スライドの順序、ノート、フラグメントホールドポイント、ホットスポット、ブランチシーケンスの単一の情報源です。シーンのdivの前、<body>の先頭近くに配置して、見つけやすくしてください。

スライドショーマニフェストを、代替の<script type="application/json">ブロックと、アイランドを作成するランタイムコードの背後に隠さないでください。presentコマンドはコンポジションHTMLを静的に読み取り、実際のapplication/hyperframes-slideshow+jsonアイランドがすでに存在することを期待します。


スキーマ

SlideshowManifest (トップレベルのアイランドオブジェクト)

{
  "slides": [
    /* SlideRef[] — メインライン、順序通り */
  ],
  "slideSequences": [
    /* SlideSequence[] — オフラインブランチシーケンス */
  ]
}

SlideRef

{
  "sceneId": "problem",
  "notes": "痛みから始めよ、会社からではない。",
  "fragments": [3.5, 5.2, 7.0],
  "hotspots": [
    /* SlideHotspot[] */
  ],

  "ttsScript": null,
  "ttsAudioUrl": null,
  "ttsDurationMs": null
}
フィールド必須備考
sceneIdはいシーンのdata-composition-idと完全に一致する必要があります(または明示的なstartTime/endTimeを指定します)。lintルールはdata-composition-idでシーンを解決します。
notesいいえ発表者のみのテキスト。聴衆には決して表示されません。
fragmentsいいえスライドの[start, end]範囲内の時間(秒)の配列 — 以下のフラグメントを参照。
hotspotsいいえブランチをトリガーするインタラクティブオーバーレイ — 以下のブランチングを参照。
startTimeいいえオプション。一致したシーンの時間範囲をオーバーライドします。デフォルトはシーンの開始/終了。
endTimeいいえオプション。一致したシーンの時間範囲をオーバーライドします。デフォルトはシーンの開始/終了。
ttsScript, ttsAudioUrl, ttsDurationMsいいえ予約済み。 スキーマフィールドは存在しますが、TTS再生はまだ配線されていません。将来のビルドのために事前に入力する場合を除き、省略してください。

SlideHotspot

{
  "id": "h1",
  "label": "これはどのように計算しましたか?",
  "target": "market-deep-dive",
  "region": { "x": 60, "y": 10, "w": 35, "h": 20 }
}
フィールド必須備考
idはいスライド内で一意。
labelはい聴衆に表示されるツールチップ/ボタンテキスト。
targetはいslideSequences内のSlideSequence.idと一致する必要があります。
regionいいえスライドのパーセンテージで指定されたバウンディングボックス:{x, y, w, h}、範囲は0-100。省略すると、ホットスポットは代わりに全スライドのラベル付きボタンとしてレンダリングされます。

SlideSequence

{
  "id": "market-deep-dive",
  "label": "市場規模の計算方法",
  "slides": [{ "sceneId": "mkt-1" }, { "sceneId": "mkt-2" }]
}

シーケンス内のslidesは、メインラインと同じSlideRef形状を使用します。フラグメントとネストされたホットスポットは許可されます。


スライド作成ルール

これらは提案ではなく、厳格な制約です。これらに違反するスライドは、レビュアーが見つけた時点で完全に置き換えられます。

  • 見出しは、ラベルではなく、完全な文による主張であること。「スケジューリングの問題」ではなく、「SMBは手動スケジューリングに週14時間を費やしている」と書きます。その文は、ビジュアルが無視されても単独で成立する必要があります。
  • スライドごとに1つのアイデア+1つのビジュアル。 2つ目の箇条書きや2つ目のチャートを追加したくなったら、スライドを分割します。
  • 結論から始める。 最も強いポイントを最初に持ってきます — スライド内でも、デッキの順序でも。投資家は左から右、上から下に読み、そして止まります。
  • ボトムアップの市場規模のみ。 計算を示さずに「500億ドルのTAM」と書かないでください。ユニットエコノミクスから構築します:アカウント数×ACV、または取引数×テイクレート。
  • フォントは最低30pt相当。 1920×1080では、見出しは72~96px、本文は48pxです。聴衆が読まなければならないテキストは、40pxを下回らないでください。
  • 名前付きビジュアルを手作りする前に、ライブカタログを検索する。 スライドに必要なすべてのルック、エフェクト、チャート、処理、トランジションについて — 「CRTスキャンライン」「グリッチ」「棒グラフレース」「きらめきスイープ」「ターミナルウィンドウ」 — npx hyperframes catalog --query "<ビジュアルを平易な英語で>" --jsonを実行し、スライドのクリップを作成する前に上位の結果を読んでください。この検索には何もインストールする必要はありません。プロジェクト、事前のadd、アカウントは不要です。ホストされているレジストリ全体(約400のブロックとコンポーネント)を任意のディレクトリからランク付けします。npx hyperframes add <名前>で、ブロックのソースがデッキにドロップされ、その場でカスタマイズできます。これは、ソースページを移植する場合に特に当てはまります。実際のブロックは、以下の移植ルールで禁止されている単純化された近似よりも優れています。

ソースページの移植

既存のページをスライドショーに変換する場合、ソースの忠実性は契約の一部です。ユーザーが明示的に再設計を要求しない限り、ソース固有のウィジェットを単純化された近似に置き換えないでください。

  • 元のページのビジュアルデザイン、モーション言語、インタラクティブな動作、メディアの動作、プレゼンテーションのアフォーダンスを、実用的な範囲で可能な限り忠実に保持します。スライドショーシステムがプレゼンターモードをサポートしている場合は、デッキ固有の実装ではなく、共有の編集可能ノート動作を使用してスピーカーノートを含めます。
  • ソースのDOM/CSS/JSから機械的なビジュアルを、実用的な範囲で可能な限り正確に移植します:カスタムプレイヤー、キャンバスビジュアライザー、タイムライン、プレイヘッド、ステム、拡大する円、ホバー状態、その他のインタラクティブな詳細は、変換後も維持される必要があります。
  • ネイティブの<video> / <audio>要素を、カスタムメディアクローム、キャンバスビジュアライザー、波形、ビートグリッド、プレイヘッドの信頼できる情報源として扱います。ソースのメディアイベント(play、pause、timeupdate、seeking、seeked、ended、ratechange、volumechange)を配線し、media.currentTimeからビジュアル状態を導出します。実際の再生からずれる可能性のある別個のタイマーを実行しないでください。
  • srcを持つコピーされたすべての<video>または<audio>は、lintの前にHyperFramesタイミング属性を持たなければなりません:data-startとdata-duration、さらに、可聴のネイティブオーディオを保持する必要がある場合はdata-has-audio="true"。スライド固有のメディアにはシーンの時間範囲を使用します。複数のフォーカスされたスライドから再生される可能性のあるユーザー制御のエビデンスビデオには、デッキ全体の範囲を使用します。メディアにpreload="none"を残さないでください。metadataまたはautoを使用します。
  • 検証の前に、ソースのフォントトークンを解決します。カスタムソースフォントを保持する場合は、ローカル/キャプチャされたフォントファイルの@font-faceルールを追加します。システムフォールバックを使用する場合は、font-family: var(--f-body)などのトークン化された宣言を、system-ui, sans-serifやui-monospace, monospaceなどの具体的なレンダリングセーフなスタックに置き換えます。var(...)をフォントファミリーの値として残さないでください。
  • ソースに非典型的なページ移動がないか監査します。特に、スクロール、ホイール、タッチ、ハッシュ状態、リサイズ、またはrequestAnimationFrameループによって駆動される動作に注意します。変換/スケーリングされた「ワールド」レイヤー、パララックス、ピン留めされたパネル、水平スクローラー、スクロールスクラブタイムライン、セクションスナップ、ズームトゥエレメントカメラを備えた固定ビューポートを、ソースの動作として扱います。スクロールは多くの場合、ソースのトランジショントリガーであるため、進行の停止、イージング、カメラ/フォーカス状態を抽出してトランジションを保持し、そのモーションをタイムライン位置、フラグメント、または再利用可能なプレイヤー/ハーネスフックを介してスライドショーナビゲーションに再ホストします。スライドのホールドポイントにジャンプするスタンドアロンラッパーでも、明示的なナビゲーションカメラトランジションフックが必要です。スライドごとのカメラ変換を計算するだけでは不十分です。スライド内でリテラルなページスクロールダウントランジションをシミュレートしないでください。ビューアは、Webページがスクロールされているのを見るのではなく、1つの焦点から別の焦点へのカメラの移動/ズームを感じる必要があります。各スライド間のカメラ移動を連続的に保ちます。x/y方向を逆転させたり、途中でズームを解除したりする中間ルートストップを避けます。

...

[翻訳のために切り詰められています]

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

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

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.

関連スキル