Communitygithub.com

UIクローン

参照元(URL、動画、Figmaデザインなど)からUIコンポーネント、セクション、エフェクト、アニメーションをピクセル単位またはモーション単位で正確にクローンし、ユーザーのスタックで再構築して検証するスキルです。

UIクローン とは?

このスキルは、参照元(ライブURL、ローカル開発サーバー、動画/GIF/スクリーンレコード、Figmaデザイン、モバイルアプリ)からUI要素やアニメーションを正確にクローン・再現するためのものです。HTML/CSS、React、Next.js、Vue、Svelte、Tailwind、Framer Motion、GSAP、 three.js、React Native、SwiftUIなど、ユーザーのスタックに合わせて再構築します。ワークフローは「参照の取得 → 測定(可能な場合は正確な値を、そうでなければピクセル単位で計測) → 仕様書の作成 → ビルド → 同じ方法で自前の出力をキャプチャ → 比較 → 修正」のループで構成され、ピクセル差スクリーンショットやフレーム単位のタイミング比較で検証します。特にピクセル忠実モードでは、静的レイアウト(フォント、サイズ、色、間隔)と動的アニメーション(タイミング、イージング、オーバーシュート)の両方を厳密に一致させ、2%未満の誤差に収めることを目標とします。対応プラットフォームはClaude Code、Cursor、CodexなどのAIエージェントツールで、プロジェクト内に証拠を含むコードを生成します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/stazdev/ui-clone/tree/HEAD/skills/ui-clone

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

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

ドキュメント

UIクローン:参照を測定し、再構築し、一致を証明する

すべてのジョブは1つのループに従います:参照のキャプチャ → 測定(可能な場合は正確な値を、そうでなければピクセル単位で計測) → 仕様の作成 → ユーザーのスタックでビルド → 同じ方法で自前の出力をキャプチャ → 比較 → 修正。仕様がパスするまで繰り返します。成果物はユーザーのプロジェクト内のコードと証拠(数値、差分画像、比較シート)であり、「だいたい合ってる」では終わりません。NiazMorshed2007/reanimate および rossark0/rossark-motion-skill(いずれもMITライセンス)から手法を採用していますが、スクリプトはすべて独自のものです。

<skill> = このスキルのフォルダ。作業はプロジェクト内の ./ui-clone/<name>/ に配置します: ref/、 ours/、 figma/、 compare-N/、 diff-N/、 spec.md。ユーザーが証拠のコミットを望まない限り、 ui-clone/ を .gitignore に追加します。

セットアップ(マシンごとに1回)

  • Python(numpy + Pillow): ~/.ui-clone/venv/bin/python(存在しない場合は python3 -m venv ~/.ui-clone/venv && ~/.ui-clone/venv/bin/pip install numpy pillow で作成)。スクリプトは -I フラグ付きで実行します。
  • ブラウザキャプチャ(Playwright + Chromium、約250MB、URL/開発サーバー入力のみ): ~/.ui-clone/runner にランナーを作成(cd ~/.ui-clone/runner && npm i [email protected] && npx [email protected] install chromium)。.mjs スクリプトは node <skill>/scripts/<script>.mjs で実行します(Playwright を ~/.ui-clone/runner からロードします。環境変数 UICLONE_RUNNER でパスを上書き可能。Playwright 自身の Chromium がインストールされていない場合は、Playwright のキャッシュ内の任意の Chromium、または UICLONE_CHROMIUM で指定された Chromium を使用します)。
  • ffmpeg/ffprobe が PATH に含まれていること。Figma の場合のみ:環境変数、プロジェクトの keys.env、または ~/.ui-clone/keys.env に FIGMA_TOKEN=... を設定します(読み取り専用の個人アクセストークン)。トークンを出力したりコミットしたりしないでください。 不足しているものがあれば、インストールする前に確認を取ってください。

0. スコープ(spec.md の先頭、キャプチャ前)

  • ターゲット: クローンする対象を正確に指定(URL + セレクタ、ファイル + 時間範囲 + クロップ、Figmaノード)。それ以上は含めない。
  • 忠実度(最初の返信で明記。検証方法が決まります):
    レベルいつ使うか一致させるべきもの相違を許容するもの
    モーション忠実(他人の作品のデフォルト)「私たちのものを彼らのように感じさせ/動かしたい」場合構造とプロポーション、順序、タイミング ±0.08秒、イージングファミリー、オーバーシュート、サイズに対する移動量、スタガーコピー、色、フォント、画像、ブランド
    ピクセル忠実ユーザー自身のデザイン(Figma→コード)、自身のサイト、権利を持つクライアントワーク、またはプライベートな練習上記すべてに加え、フォント、サイズ、間隔、色、角丸、シャドウ、アセット。スクリーンショットの不一致 ≤ 2%(静止時 ≤ 0.5%)、計測可能なズレなし変更を依頼されていないもの
    混合「XをクローンしてYを追加」の場合クローン部分は上記いずれかのレベル追加部分(分離して表示し、クローンを壊していないことを確認)
  • 権利: 他社のUI、ロゴ、イラスト、フォント、コピーライトのピクセル忠実コピーはそれらの著作物です。学習目的または許可を得た場合のみ使用し、ユーザー自身の作品として公開しないでください。参照が第三者の製品であり、ユーザーが出荷したい場合は、デフォルトでモーション忠実とし、ユーザー自身のデザインを使用する理由を説明します。
  • 出力先: コードの配置場所と使用するスタック。package.json、既存のコンポーネント、スタイリングシステム(Tailwind設定、CSS変数、デザイントークン)、および既に使用されているアニメーションライブラリを読み、新しいライブラリを追加するのではなくそれらに合わせます。

1. 入力方法の選択(利用可能な中で最も正確なものを選択。どれを使うか明記すること)

入力キャプチャ方法取得内容
ライブURLinspect_web.mjs + capture_web.mjs正確なCSS値、フォント、宣言されたduration/delay/easing、キーフレーム。仮想クロックによるフレーム単位の正確な録画
ローカル開発サーバー(自前)同じスクリプトを http://localhost:… に使用すべての比較の「自前」側。参照とまったく同じ方法でキャプチャ
ビデオ/GIF/画面録画(ウェブまたはアプリ)ref_frames.pyソースのFPSですべてのフレーム、タイミング/ポーズシート。ピクセルからの測定値
Figmafigma_fetch.py(トークン)またはエクスポートされたPNGフレーム正確なサイズ、間隔、オートレイアウト、タイポグラフィ、色、エフェクト、プロトタイプトランジション、および参照PNG
モバイルアプリ画面録画(参照)。自前の場合は xcrun simctl io booted recordVideo ours.mp4(iOSシミュレータ)または adb shell screenrecord(Android)ビデオとして取得。自前も同じ方法でキャプチャ
これらを組み合わせることも可能:URLの値 + トリガーが難しいインタラクション(ログイン必須フロー、ドラッグ)の録画;Figmaの値 + 開発サーバーで「ビルドがデザインと一致するか」を確認;ビデオ参照 + 開発サーバーキャプチャで自前の確認。ログインが必要なページ:画面録画を依頼するか、ユーザーにログインしてもらいます。パスワードを扱うことは絶対にしません。

2. 参照のキャプチャと測定

URL:

  • inspect_web.mjs --url URL --selector "<section>" --out ui-clone/<name>/ref [--state hover --target "<btn>"] で実行 → inspect.md が生成:要素ごとのボックス + 計算済みスタイル、宣言されたトランジション、実行中のアニメーション(キーフレーム含む)、@keyframes、フォント、検出されたライブラリ(GSAP、Framer Motion、Lottie、three.js、Lenis...)、キャンバス(2d/WebGL)、ホバー/フォーカスの差分。宣言された値は測定値より優先:それらをコピーします。
  • capture_web.mjs --url URL --selector "<section>" --trigger load|hover|click|scroll|none --duration 2 --fps 30 --out ui-clone/<name>/ref で実行 → frames/、video.mp4、frames.json、animations.json が生成。デフォルトは --mode seek(仮想クロック:JSタイマーとrequestAnimationFrameをPlaywrightのクロックで管理、CSS/Webアニメーションは一時停止して各フレームでシーク:完全に同一のキャプチャが可能)。仮想クロックが壊れるページ(video要素、一部のWebGL/キャンバスライブラリ)では --mode realtime を使用し、その旨を明記します。--still はピクセル作業用に静止したスクリーンショットを1枚取得。--dpr 2 でRetina精細な比較に(小さな要素では --dpr 3:12pxのホバー拡大は1xではイージングを収めるのにピクセルが足りません)。--pad 12 で --selector の周囲にマージンを追加し、ホバー/スケールエフェクトが静止ボックスを超えて拡大してもフレーム内に収まるようにします。--viewport 390x844 でスマートフォン用。シークモードは実行間でフレームが同一であることが確認されています。--mode realtime はマシンが許す限り高速(一般的なラップトップで約19枚/秒)でスクリーンショットを撮り、リサンプリングします。達成されたフレームレートが出力されます:タイミングの精度はそのレートに依存します。 ビデオ/GIF/録画: ref_frames.py REF.mp4 --out ui-clone/<name>/ref [--start --end --crop x:y:w:h]。 Figma: figma_fetch.py --url "<figma link with node-id>" --out ui-clone/<name>/figma --scale 2 → design.md/json + frame.png。 次にモーションを測定(フレームがある任意の入力):
  • カットとセクション: motion_compare.py <ref> <ref> --out <ref>/self --no-align。
  • 色: track_motion.py <ref>/frames --sample X,Y --at T。
  • 動く各要素: track_motion.py <ref>/frames --name el --colors HEX,HEX --tol 35 --region x,y,w,h(込み入った参照では常にリージョンを指定)。
  • 各移動: fit_easing.py <ref>/track_el.json --prop cx|cy|w|h|aspect|presence --from A --to B → タイミング、イージング、オーバーシュート、およびコピペ可能なCSS / WAAPI / Framer Motion / GSAP / Remotionのコード行を出力。誤差 ≤ 0.03 で適合良好。「no single ease fits」= ウィンドウを分割するか、キーフレームチェーンである可能性があります。次点の誤差が最良のものから約0.003以内の場合、同点として扱います(例:easeOutQuad 0.58秒 vs easeOutCubic 0.80秒が同じフレームに適合する場合):その旨を明記し、inspect.md、ソースコード、またはシートから宣言された値を優先して判定します。トラッキングは要素をその色でしか見ないため、移動中にフェードインする要素は開始が遅れているように見えます:ウェブ入力の場合は代わりに宣言された値を使用します。 すべてのシート(sheets/poses.png、sheets/timing_NN.png)は自分で読んでください:数字は何を、シートはどのようにを示します。

3. 仕様の作成(ui-clone/<name>/spec.md。すべての行がチェック対象になります)

  • 構造と静的スタイル(ピクセル忠実の場合):要素 → ボックス、フォント(ファミリー/サイズ/ウェイト/行間/文字間隔)、色、角丸、シャドウ、間隔。出典(inspect.json / design.json / 測定値)を記録。
  • タイムライン(モーションの場合): | # | 要素 | プロパティ | 開始値 → 終了値 | 開始ms | 継続時間ms | イージング | スタガー / 繰り返し | トリガー | 出典 |。
  • 動かないものも明記。"?" は参照がまだ読まれていないことを意味します。大規模なビルドの前に仕様を表示します。

4. ビルド

ユーザーのスタックとデザインシステムに従います。ピクセル忠実の場合は宣言された値を正確にコピーし、モーション忠実の場合は相対的なプロポーションを使用します。イージングは inspect.json または fit_easing.py の出力から該当ライブラリ向けのものを使用。参照がオーバーシュートして落ち着く場合はスプリングを使用。スタガーは 基本値 + インデックス × ステップ。prefers-reduced-motion を尊重します(終了状態を表示)。追加部分は別のコンポーネントに維持します。参照と同じビューポートとトリガーでコンポーネントをレンダリングするルート/ページを用意し、同一条件でキャプチャできるようにします。WebGLエフェクト:参照が示すものからシェーダーを再構築(またはユーザーが使用可能な場合は読み取り可能なソースから)。固定タイムステップは時間から、乱数はシード付きで生成します。

5. 検証、修正、繰り返し(2〜5ラウンド。各ラウンドのフォルダは保持)

  1. 参照と同じコマンド(--url/入力と --out のみ変更)で自前の出力をキャプチャします。ビデオ入力の場合は ref_frames.py OURS.mp4 --out ui-clone/<name>/ours --like <ref>/frames.json。
  2. ピクセル: screenshot_diff.py <ref>/still.png <ours>/still.png --out ui-clone/<name>/diff-N [--strict] [--max 0.02] [--mask x,y,w,h] (ピクセル忠実では常に --strict:ピクセル単位の閾値0.03、最大0.5%、色がRGBレベルで3以上ずれる領域はすべて不合格。デフォルトは寛容で、小さなパディングや色の変更を通過させます) → 不一致率%、最悪の領域、画像全体または要素ごとのズレ(「領域…の何かがx +0px、y +6px移動」)、色のずれ、side_by_side.png。まずズレを修正します(すべてが間違って見える原因になります)、次にサイズ、最後に色を修正します。ピクセル忠実では計測可能なズレがあるとFAIL。モーション忠実では --allow-shift と緩い --max を使用します。
  3. モーション: motion_compare.py <ref> <ours> --out ui-clone/<name>/compare-N(カット、移動、オフセット。PASS ±0.08秒。activity.png、sheets/compare_NN.png)および、仕様の行ごとに fit_easing.py REF_TRACK --prop P --from A --to B --vs OUR_TRACK。
  4. 毎ラウンドシートを読んでください。証拠が指し示す最小のものを変更し、再キャプチャ、再比較します。
  5. 5ラウンド後も不合格の行があれば、その番号と理由(フォントライセンス、近似したWebGLエフェクト、目視で調整したスプリングなど)をすべて報告します。閾値を黙って緩めることは決してしません。
症状よくある原因修正方法
画像全体がNpxずれているスクロール/オフセット/クロップの違い、またはラッパーマージンの欠落ビューポート、dpr、クロップを一致させ、外側の間隔を修正
要素が移動したmargin/padding/line-height/gapの違いinspect.json / design.json でボックスを比較
テキスト全体がわずかにずれているフォールバックフォント、異なるウェイトまたは文字間隔同じフォント(またはユーザーがライセンスを持つ同等のフォント)をロードし、サイズ/ウェイト/トラッキングを一致させる
色が全体的にわずかにずれている色空間、不透明度の重ね合わせ、グラデーションのストップ計算された色/グラデーションをコピー。親要素の不透明度を確認
モーションが1オフセット分ずれているトリガーのレイテンシまたは遅延の欠落最初の遅延を修正
自前の動きが前寄り/速すぎる強いイージング(expo vs cubic)フィッティングされたベジェ曲線または宣言されたイージングを使用
参照はオーバーシュートするが自前はしないスプリング/back vs ベジェ測定されたオーバーシュートと落ち着きに合わせてスプリング/backを調整
スクロールアニメーションの開始が早い/遅いトリガー閾値/オフセットモーションが始まるスクロール位置を一致させる
自前に余分な動きがある不要なトランジション(例:transition: all)アニメーションさせるプロパティのみにトランジションを制限

6. レポート(単独で成立すること)

忠実度レベルとクローン/追加したもの。変更したファイルとモーションのトリガー方法。最終ラウンドの表(ピクセルの不一致とズレ、カット/モーションのタイミング、要素ごとのイージング)、side_by_side.png、activity.png、比較シートへのパス。残っているすべての差異とその数値・理由。どのチェックが測定(スクリプトによる)で、どれが目視(シートを見た)かを明記。

制限

  • 仮想クロックキャプチャは <video> の再生や一部のGPU/物理ライブラリを制御できません:--mode realtime を使用し、±1-2フレームのジッターが発生する可能性があることを明記します。
  • クロスオリジンのスタイルシートやフォントは @keyframes/@font-face ルールをインスペクションから隠す場合がありますが、計算されたスタイルと実行中のアニメーションは引き続き読み取られます。
  • ビデオからの3Dはカメラ/オブジェクトの動きとしてマッチングされ、モデルやマテリアルとしてはマッチングされません。動きの多い実写映像はリズムは得られますが、正確な要素の値は得られません。
  • モバイル:値は録画から得られます(ソースコードなし)。シミュレータでの自前のキャプチャも同様に比較します。

関連スキル