Communitygithub.com

Parrass/mograf-public

モーショングラフィックス作品を独立した視点で批評し、品質ゲートとして機能するスキルです。HyperFrames / GSAP / HTML(またはRemotion)作品を9次元のスタジオ評価基準で採点し、ハードゲート、12項目のクラフトバー、アンチスロップリストを実際にフレームを確認してチェックし、APPROVE / POLISH / REWORKの判定とフレームレベルの修正指示を返します。納品前のレンダリングや修正後、レビュー依頼があった際に使用します。新しいコンテキストのサブエージェントとして実行するのが最適です。

mograf-public とは?

このスキルは、コードの構文エラーではなく「センス(taste)」をチェックする、モーショングラフィックス作品向けの品質ゲートです。HyperFrames、GSAP、HTML(またはRemotion)で制作された作品を、9つの評価次元(コンセプト、構図、タイポグラフィ、タイミング&イージング、コレオグラフィ、トランジション、奥行きとテクスチャ、サウンドシンク、仕上がり)で1〜5点のスコア評価します。さらに、12項目のクラフトバー(例:カスタムイーズ、モーションブラー、リズム)と15のアンチスロップパターン(例:全要素のフェードイン&スライドアップ)をパス/フェイルでチェックします。レビュアーは作品フォルダに `review.md` を生成し、APPROVE、POLISH、REWORKのいずれかの判定と、フレーム単位の修正指示を「Before | After | Why」テーブル形式で提供します。このスキルは、クリエイター自身によるセルフレビューを防ぐため、新しいコンテキストのサブエージェントとして実行することを推奨します。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Parrass/mograf-public/tree/HEAD/plugins/mograf/skills/motion-review

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

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

ドキュメント

motion-review: taste gate(センスのゲート)

リンターは壊れたコードを捕捉します。このスキルはセンスを捕捉します。デフォルトの姿勢: まずフラグを立てよ。承認は獲得されるもの。 「見た目は悪くない」作品はスコア3であり、スコア3は出荷されません。

実行方法

  • 可能な場合は新しいサブエージェントとして実行してください。それに与えるもの: このファイル、プロジェクトフォルダ、ブリーフ。ビルドの難易度は伝えないでください。
  • レビュアーはコンポジションを編集しません。プロジェクトフォルダに review.md を書き込み、判定を返します。
  • コードだけでなく、ピクセルを確認してください。すべてのスコアはタイムスタンプ、フレーム、セレクタを指し示す必要があります。
  • 1作品につきレビュアー1名。 2人のレビュアーが同時に実行すると、同じ review.md に書き込みが発生し、判定が競合します。各ラウンドは1つの verdict: 行で終了します。呼び出し元は review.md をポーリングして判定を取得します。再レビューは同じレビュアーに送ります。長時間経過しても新しいラウンドが review.md に表示されない場合にのみ代替レビュアーを起動し、review.md にキャンセルを記録し、代替レビュアーは履歴を読んでから開始します。ラウンドが競合した場合、最後に review.md に書き込まれたものが正とします。

手順

すべてのステップを実行してください。コマンドはHyperFramesプロジェクト(npx hyperframes …)を想定しています。他のスタックの場合は同等のものを使ってください(Remotion: フレームは npx remotion still、ストリップは npx remotion render)。

  1. 構造。 npx hyperframes check . エラーはすべてBlockです。警告も読み取ってください。このコントラスト監査がコントラストゲートです。読まれることを意図していない装飾的なテキスト(ブラーゴースト、ゴーストトレイルのクローン、溶けるチップ、スクランブルの埋め草)は、各ノードに data-layout-ignore を付けて除外します。実際のコピーを隠すためにこれを使用しないでください。

  2. モーションマップ。 タイムラインコード(または、HyperFramesスキルが animation-map.mjs を提供している場合はアニメーションマップ)を読んでください。以下に注意:

    • 1秒以上のデッドゾーンで、何も動いていない部分。
    • 0.2秒未満(速すぎて読めない)または2秒超(ドリフト)の空間移動。
    • 不規則または機械的なスタガー。
    • フレーム外に出てしまう、または偶然衝突する要素。

    プロキシ/セッターオブジェクト(カスタムカメラ、three.js、カウンター)を介したモーションは、トゥイーンベースのマップには見えません。これらの動きについてはフレームストリップ(ステップ5)を使用してください。

  3. コンタクトシート。 ストーリーボードまたはビートリストから、シーンと継ぎ目の時間を取得します。スナップショット:

    • フレーム0、ヒーローモーメント、最終フレーム。
    • すべてのシーンの25/50/75%。
    • すべての継ぎ目で−2フレーム、0、+2フレーム。

    npx hyperframes snapshot --at <t1,t2,…>。正確なフレーム時間を渡します(t = frame / fps、例: 30 fpsでフレーム316 → 10.5333)。--at はスナップしないため、丸められた時間はレンダリングに含まれない中間ポーズを示します。snapshot は以前の実行からの古いPNGを残すため、各実行の前に古い snapshots/ ディレクトリを移動します(例: rm globで削除する代わりに node -e "require('fs').renameSync('snapshots','snapshots-'+Date.now())")。--at は要求していない余分なフレームを追加することもあるので、無視してください。画像を開いて確認してください。タイプのズームは、その要素が表示されている時間に行うこと(非表示の要素を拡大するとハングする可能性があります)。

  4. 奥行きの証明。 カメラまたはヒーロームーブの場合、npx hyperframes keyframes --ghost --angle。zに沿って分離する平面は真の奥行きを意味します。すべてが一緒に拡大縮小するものは偽の奥行きです。ヒーロームーブでの等間隔のゴーストはリニアイージングを意味し、不合格です。--ghost が実行できない場合は、スクラッチコピーを作成し、ワールドの親に証明用カメラを与えて(プッシュバック + ピッチ + ヨー、例: translateZ(-900px) rotateX(-28deg) rotateY(64deg)。ヨーのみでは奥行きのあるシーン内にカメラが入り込みます)、動き全体で4〜6フレームのスナップショットを撮り、それらを重ね合わせます(ffmpeg … -filter_complex blend=all_mode=lighten)。ネストされたパースペクティブ(snapshot --angle side は平坦化します)とJSプロジェクションカメラ(3Dを1つのSVG/キャンバスに投影)の場合は、このオニオンスキンを手動で構築します。スクラッチコピーのプロジェクション関数にサイドカメラを差し替えます。

  5. 実速度での視聴。 レンダリングが存在する場合:

    • ストリップを作成: ffmpeg -i renders/video.mp4 -vf fps=6,scale=360:-1,tile=6x4 strip.jpg。
    • ffprobe で再生時間と最初と最後のフレームを確認。
    • オーディオがある場合、各ヒットがキューの±1フレーム以内であること、最終AACファイルのtrue peakが−1 dBTP以下であることを確認(ffmpeg -i … -af ebur128=peak=true -f null -)。
    • 透明 .webm オーバーレイ: ffprobe はVP9-alphaを yuv420p として表示します。-i の前に -c:v libvpx-vp9 を付けてデコードするか(ストリーム読み取り yuva420p)、ALPHA_MODE=1 タグでアルファを確認します。
  6. コード読み取り。 コンポジション内をgrep:

    • ease:(使用されているすべてのイーズをリストアップ)とduration。
    • アルファのみのエントランスと小さな y: オフセット(20〜40 px)。
    • Math.random / Date.now(非決定論的)。
    • back.out|elastic|bounce, yoyo, repeat: -1。
    • 空間移動でのリニアまたは power1。許可リスト外のイーズ(mg.*, power3.out, expo.out, power3.in, power4.out, power2.inOut, none, ベイクドスプリング)。
    • 同じイーズを共有する同時トゥイーン(ロックされたグループ: 1つのマルチターゲットトゥイーンまたは defaults を持つ子タイムラインの場合のみ可。セッター駆動のプロキシは、そのトゥイーンのイーズによって1回カウントされます)。
    • yPercent 130 未満から始まるブラー付きラインマスクの上昇(ブラーがマスクに漏れます)。
    • 禁止フォント。
    • グレイン、ビネット、モーションブラーの欠如。
  7. 採点 9次元(アンカーは以下)、1〜5、それぞれに時間またはフレームに関連付けた1行の理由。

  8. クラフトバー(12項目、パス/フェイル。表は以下)。

  9. アンチスロップスキャン(トップ15リストは以下)。IDを記録。

  10. ライセンス。 すべての非オリジナルアセット(フォント、SFX、音楽、画像、サードパーティコード)には、ソースと互換性のあるライセンスが文書化されていること。フォント: OFLまたは同等。コード: MITまたはApacheでヘッダーが保持されていること。不明なものはすべてフラグを立てます。

ルーブリックアンカー(スコア1〜5)

次元135
コンセプトアイデアなし。背景にテキスト。どのブランドでも置き換え可能明確なワンライナーアイデア。モーションが一部のシーンでそれをサポートエンドツーエンドで1つの強力なアイデア。驚きがあり、固有で、一言で説明できる瞬間がある
構図すべて中央揃え、均一なサイズ、意図のない乱雑さまたは空白グリッド、フレームごとに1つのヒーロー、適切なネガティブスペースすべての静止画がポスターレベル: 意図的なトリミング、奥行きレイヤー、ネガティブスペース。レイアウトが進化する
タイポグラフィシステムフォントまたは汎用フォント、デフォルトトラッキング、ブロック全体のフェード正しい分割単位(行/単語/文字)、マスクを使ったリビール、可読性タイプ自体がアニメーション: 可変アクシス、キネティックレイアウト、クロップ/スケールプレイ、完璧なリズム
タイミング&イージングリニアまたはデフォルトのイーズ、均一なduration、ホールドなしヒーロームーブにカスタムイーズ、durationが変化、ホールドが読み取れる非対称な速度、上品なオーバーシュート、フレーム単位で必然と感じるホールド
コレオグラフィすべてが一緒に、または均一なスタガーで動くヒーローがリードし、サポートがオフセットで追従、オーバーラップあり指揮されている: 1つのジェスチャーが次のジェスチャーに流れ込み、セカンダリモーションがプライマリに反応する
トランジションクロスフェードまたは無関係なカットデザインされたマスク/ワイプ、ビートに合っている1つの連続したカメラ/アイデア。記憶に残り、決して過剰ではない
奥行きとテクスチャフラットな背景上のフラットなベクター、またはぼんやりしたグラデーション、静的なフレームカメラのドリフト/プッシュ、2つ以上の奥行き平面、若干のグレインまたはライト真の3Dまたは説得力のある2.5D。ライティングがストーリーを語る。テクスチャが見せびらかさずに統一する
サウンドシンク無音、または無関係なオーディオメジャーカットがビートに合っている映像と音が一緒に作曲されている。沈黙がアクセントとして使われている。クリーンなミックス
仕上がりバグ、ジッター、ポップ、エイリアシング、未ロードのアセットクリーンで一貫性があり、デザインされたエンドフレームスタジオ出荷品質。すべてのフレームが精査されている。エンドフレームが保持され、解決されている

スコア2と4はアンカーの中間です。スコア4を得るには:

  • タイミング: 役割によるイーズパレット、「速いアウト、長いセトル」の到着、加速する退出。
  • コレオグラフィ: アンティシペーション、フォロースルー、イーズまたは距離ベースのスタガー。
  • トランジション: 少なくとも1つのマッチカットまたはモーフ、およびピーク速度でのブラーを使用したカット。
  • 奥行き: 3プレーンパララックス、速い動きにはモーションブラー。
  • 構図: 少なくとも5倍のスケールコントラスト。

ブリーフ内で無音であることを宣言しているミュートされたSFX無しの作品は、その沈黙と視覚的リズムでサウンドシンクを評価します。意図的な選択を罰しないでください。

ハードゲート(いずれか1つ = Block)

  • check が失敗する、レンダリングが非決定的である、またはシークでグリッチが見られる。
  • 読めないテキスト:
    • ホールドが0.5秒 + 単語あたり0.3秒未満。
    • コントラストが4.5:1未満。
    • テキストが安全エリアを越えている。
  • フォントフラッシュ、欠落アセット、継ぎ目の壊れたまたは空のフレーム、最初または最後のフレームのポップ。
  • 文書化された正当化なしの3つ以上のアンチスロップヒット。
  • ヒーローの空間移動におけるリニアまたはデフォルトのイーズ。
  • ブリーフに文書化された免除なしのクラフトバー項目の欠落。
  • 1秒あたり3回以上のフラッシュ。
  • 記録されたソースまたはライセンスのないサードパーティアセット。

クラフトバー(12項目)

  1. コンセプト。 1文のアイデア、およびランタイムの約40%までにシグネチャーモーメント。
  2. ヒーロースチル。 デザインされたヒーローフレーム(構図 ≥ 4、少なくとも3つの奥行きレイヤー)。
  3. カメラ。 ゴーストまたはサイドアングルチェックで証明された、少なくとも1つのリアルなカメラまたは奥行きムーブ。
  4. カスタムイーズ。 少なくとも3つの異なるイーズキャラクターがあり、偶然に同じイーズを共有する同時トゥイーンがないこと。
  5. デフォルトのフェードアップなし。 どこにも opacity 0→1 + y 20–40→0 がないこと。
  6. 名前付き継ぎ目。 継ぎ目に名前が付けられ、速度がマッチしている。最大1つのプレーンなクロスフェード。
  7. モーションブラー 1〜3の速いビートに使用されている(テキストが読まれている間は使用しない)。
  8. テクスチャパス。 グレイン、ビネット、ラジアル(光に動機付けられた)グラデーション。
  9. ライトイベント。 少なくとも1つ: スイープ、グロス、スキャンバンド、ブルーム、リーク。
  10. サウンド。 オーディオがある場合はサウンドシンク。そうでない場合は作品は無音であると宣言されている。
  11. リズム。
    • 最も遅いストーリーボードビートは、最も速いビートの少なくとも3倍である(ビートはストーリーボードの行であり、サブトゥイーンではない)。
    • すべてのトゥイーンにおいて、最大/最小durationは少なくとも4である。
    • 最終スチルは少なくとも0.8秒間保持される。
    • 最後のフレームがサムネイルとして機能する。
  12. ルーブリックバー を満たしている(Ship barを参照)。

アンチスロップトップ15

id兆候修正
S1すべての要素がフェードインし、20〜40 pxスライドアップする役割によるエントランス: テキストはマスク/スプリット、シェイプはスケールフロムポイント、シーンはカメラキャリー
S2同一のduration(すべて0.5秒/1秒)距離と質量からdurationを決定。ヒーロー到着0.8〜1.5秒、退出は約30%速く
S3デフォルトのイーズ(power1、CSS ease、ease-in-out)または空間移動でのリニア名前付きカスタムイーズ。「速いアウト、長いセトル」の非対称性
S4均一な0.1秒スタガー意味のある起点(センター、焦点、読む順序)からのイーズスタガー
S5すべてが同時に同じ速度で動く1つのリーダー。サポートは2〜8フレーム後に振幅を抑えて追従
S6ホールドなし: 入ってすぐに出ていく読み取りホールド ≥ 0.5秒 + 0.3秒/ワード
S7デッドストップ: 到着して停止ロングセトル、ホールド中のマイクロドリフト
S8すべてにElastic/back/bounceを使用作品全体で最大1つのオーバーシュート、≤ 6%、transformのみ
S9アイドル状態の「呼吸」パルス(スケール/opacityのヨーヨー)静止、または1つの動機付けられたアンビエント、または終了ポーズのあるカメラドリフト
S10モーションブラーのない速い動き最も速い1〜3ビートにシャッター風または指向性ブラー
S11中央揃えのスタック: タイトル/サブタイトル/ボタン非対称グリッド、エッジアンカータイプ、30〜50%のネガティブスペース
S12静的なフレーム、カメラなしプッシュ、ドリフト、パララックスプレーン、ビートでのパンチイン
S13「スライド」: シーンがフェードアウト、次がフェードイン動機付けられた継ぎ目: マッチカット、モメンタム、マスク、モーフ
S14紫/青/ピンク/オレンジのぼんやりした塊、グラスモーフィズム、すべてにネオン光源のように振る舞うグラデーション。2〜3色 + ニュートラル、アクセント ≤ 10%
S15Inter/Roboto/Poppinsのレギュラーを「デザイン」として使用。絵文字やストックアイコン表現力豊かなディスプレイフォント、タイトトラッキング、ウェイトコントラスト。カスタムマークまたはなし

また、以下の点にも注意:

  • タイプライター + カーソルがアイデア全体になっている。
  • 汎用的なカウント数字。
  • Loremに似たコピー(「未来を解き放て…」)。
  • ただ停止またはフェードアウトするだけのエンディング。
  • クライマックスのないフラットなエネルギーカーブ。
  • どのメッセージにも当てはまるモーション。

Ship bar(出荷基準)

  • APPROVE: 平均 ≥ 4.0、どの次元も3未満なし、ハードゲートゼロ。
  • POLISH: 平均3.5〜3.9、または1つの次元が3。修正リストを作成し、再レビュー。
  • REWORK: 平均3.5未満。コンセプトとスタイルフレームに戻る。ポリッシュでは救えない。

review.md の形式

piece: <name> · reviewed: <date> · render: <path or none>
concept: N — …            composition: N — …        typography: N — …
timing_easing: N — …      choreography: N — …       transitions: N — …
depth_texture: N — …      sound_sync: N — …         finish: N — …
average: N.N
hard_gates: [ … ]
craft_bar: [1 ✓, 2 ✗ (理由), …]
anti_slop_hits: [S1, S7, …]
verdict: APPROVE | POLISH | REWORK   → route fixes to: concept | composition | motion build
contact_sheet: <path>

次にBefore | After | Why テーブル。インパクト÷労力で並べ替え、すべての「After」は正確な値にすること:

#Where (t / frame / selector)BeforeAfterWhy
13.40–3.90 s #titleopacity + y 30, power2.out 0.5 s行に分割、マスクリビール、セトルイーズ cubic-bezier(0,.65,.51,.99) 0.9 s、行 +4 framesデフォルトのフェードアップ(S1)。セトルなし(S7)

修正順序: 削除 → 削減 → イージング修正 → 構図/起点修正 → リタイミング → 奥行き/ブラー/テクスチャ追加 → ポリッシュ。 「もっとダイナミックに」と書かないでください。常に数値を伴うレシピを提供してください。

再レビュー

再レビューは同じレビュアーに戻します。修正後、ステップ1、ステップ3(変更された領域とその継ぎ目)、ステップ7を再実行します。リタイムは check を再実行します。そのコントラストサンプルはタイミングとともに移動します。改善が見えるように review.md に古いスコアを保持し、各ラウンドを独自の verdict: 行で終了します。3回のポリッシュループ後に停止します。平均がまだ4.0未満の場合は、REWORKを返します。


Part of the free mograf skills (MIT). For the full studio pipeline, see mograf.si. Each piece in the library ships with its prompt, skills, source and copy.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル