Communitygithub.com

Charlo-O/clone-design

エンドツーエンドのウェブサイトクローン作成、ランディングページリミックス、DESIGN.mdの抽出を行うスキルです。CodexがURLからウェブサイトやランディングページを1:1で複製するよう求められた場合、ソースサイトを現在のプロジェクト用のランディングページに変換する場合(レイアウトを維持しながらコピーと画像アセットを置き換える)、サイトのデザインシステムをDESIGN.mdに抽出する場合、ビジュアル言語を分析する場合、または複数のキャプチャページや状態を再利用可能なデザインガイダンスに統合する場合に使用します。

clone-design とは?

このスキルは、与えられたURLまたはローカルのHTMLファイルからウェブサイトを忠実にクローンし、その後、プロジェクト固有のランディングページにリミックスするか、デザインシステムをDESIGN.mdとして抽出するための包括的なワークフローを提供します。主にAIエージェント(Codexなど)での使用を想定しており、開発者がウェブサイトのUIを複製・分析・再利用する際のプロセスを自動化・支援します。 **主な機能とユースケース:** 1. **1:1クローン作成:** 指定されたURLから、レンダリングされたDOM、CSS、フォント、アセットURLを完全に保持したHTMLスナップショットを作成します。認証が必要なページにも対応し、ブラウザでの検証も行います。 2. **ランディングページリミックス:** クローンしたページのレイアウト、アニメーション、セクション構成を維持したまま、テキストコピーと画像を現在のプロジェクト用に置き換えます。プロジェクトフォルダ(README、package.jsonなど)を分析してコンテキストを取得し、コピーマップと画像生成計画を作成します。 3. **デザインシステム抽出:** クローンしたページから、カラーパレット、タイポグラフィ、コンポーネントスタイル、レイアウト原則などを分析し、構造化されたDESIGN.mdファイルを生成します。複数のページや状態(ログイン後など)を統合して、一貫性のあるデザインガイダンスを提供することも可能です。 4. **標準化された出力構造:** キャプチャファイル、リミックス出力、デザイン抽出出力はすべて所定のディレクトリ構造下に保存され、後続の処理やレビューが容易になります。

対応~Claude Code✓Codex CLI~Cursor
npx skills add Charlo-O/clone-design

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

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

ドキュメント

clone-design は何をしますか?

まずウェブサイトをクローンし、その後、プロジェクト固有のランディングページにリミックスするか、DESIGN.mdに抽出します。

デフォルトの姿勢: 1:1のクローンが検証されるまで、ソースサイトのレンダリングされたレイアウトを創造的な逸脱なしに維持します。その後にのみ、現在のプロジェクト用にコピー、画像、ブランド固有のコンテンツを置き換えることができます。

使用時機

ユーザーが以下の依頼をした場合にこのスキルを使用します:

  • URLからウェブサイトやランディングページをクローンする
  • ランディングページを適応前に1:1で複製する
  • 別のウェブサイトのランディングページを現在のローカルプロジェクトのランディングページに変換する
  • クローンしたウェブサイトのコピーを現在のプロジェクトフォルダのコピーで置き換える
  • クローンした画像をプロジェクト関連の生成ラスターアセットで置き換える
  • ウェブサイトをDESIGN.mdに変換する
  • サイトのデザインシステムを抽出する
  • ページのビジュアル言語を分析する
  • ログイン済みの製品UIやワークスペースを分析する
  • 複数のページや状態からデザインガイダンスを統合する
  • UIクローンを再利用可能なデザインガイダンスに変換する
  • ライブURLから直接デザインバンドルを作成する

モードの選択

モードA: ランディングページリミックス

ユーザーが別のランディングページをクローンして現在のプロジェクトに適応させたい場合に使用します。

パイプライン:

URL -> 1:1クローン -> 検証済みローカルページ -> プロジェクトコピーマップ -> imagegenアセット -> 最終ランディングページ

以下を読んで従ってください:

モードB: デザインシステム抽出

ユーザーがDESIGN.md、ビジュアル言語分析、またはデザインガイダンスを求める場合に使用します。

パイプライン:

URL または clone.html -> キャプチャ -> design-md/<slug>/

以下を読んで従ってください:

ソースキャプチャルール

ユーザーがURLを指定した場合:

  • ユーザーにfrontend-ui-cloneを個別にインストールまたは実行するように依頼しないでください
  • 最初に自己完結型のHTMLスナップショットを作成します
  • frontend-ui-cloneと同じクローンワークフローと忠実度ラダーを再利用します
  • ソースマテリアルをcaptures/<slug>/の下に保存します
  • キャプチャしたすべてのページまたは状態にclone.htmlを含めます
  • 必要に応じてスクリーンショットとトークンダンプを追加します
  • リミックスまたは抽出の前に、ブラウザでクローンを検証します

ユーザーがローカルの.htmlファイルを指定した場合:

  • それを直接使用します
  • 単一ファイル、複数ファイル、または複数のclone.htmlファイルを含むキャプチャディレクトリを受け入れます

サイトがクライアントサイドレンダリングに依存している場合、生のHTTPフェッチからのリミックスやDESIGN.mdの作成は避けてください。

デフォルトパス

ユーザーがパスを指定しない場合:

キャプチャファイル:

  • 単一ページキャプチャフォルダ: captures/<slug>/
  • 複数ページキャプチャフォルダ: captures/<slug>/<page-slug>/
  • ページごとのファイル: clone.html, homepage.png, live.json
  • オプションのサイトレベルキャプチャマニフェスト: captures/<slug>/capture-plan.json

ランディングリミックス出力:

  • 出力フォルダ: landing-pages/<slug>/
  • 最終ページ: index.html
  • 検証済みソースクローン: source-clone.html
  • 抽出されたインベントリ: content-inventory.json
  • 生成されたアセット: assets/generated/
  • 計画およびQAファイル:
    • copy-map.json
    • image-plan.json
    • qa/original-desktop.png
    • qa/clone-desktop.png
    • qa/final-desktop.png
    • オプションのモバイルスクリーンショット

デザイン抽出出力:

  • 出力フォルダ: design-md/<slug>/
  • 出力ファイル:
    • DESIGN.md
    • README.md
    • preview.html
    • preview-dark.html
  • オプションの証拠ファイル: evidence.json

1:1クローンスタンダード

入力がURLの場合:

  • 可能な場合は組み込みのブラウザ/Playwrightツールを優先します
  • frontend-ui-cloneと同じデフォルトビューポートとスクロール戦略を使用します
  • レンダリングされたDOM、CSS、フォント、および解決済みのアセットURLを保持します
  • 元のDOM構造、クラス名、セクション順序、スペーシング、半径、シャドウ、タイポグラフィ、グラデーション、およびレスポンシブ動作を保持します
  • 検証済みのクローンが存在する前に、再設計、簡略化、ブランド変更、またはレイアウト変更を行わないでください
  • ページに認証が必要な場合、ユーザーにブラウザでログインを完了させ、同じブラウザコンテキストを維持します
  • ログイン後、同じセッション内で要求された各ページまたはUI状態を個別にキャプチャします
  • 最初のキャプチャに空白のヒーローや明らかなオーバーレイの問題がある場合、frontend-ui-cloneと同じエスカレーションマインドセットを適用します:
    • レベル1: DOM + CSSクローン
    • レベル1a: ターゲット修正を施したハイブリッドクローン
    • レベル1b: ターゲットスタイルベイク
  • デスクトップスクリーンショットQAを約1440 x 900で行います
  • ページがレスポンシブである場合、モバイルスクリーンショットQAを約390px幅で行います
  • 続行する前に、目に見える不一致を修正します

ユーザーがその広範さを明確に要求しない限り、認証済みアプリ全体を自動クロールしないでください。主要なページまたは状態の厳選されたセットを優先します。

リミックスルール

クローンしたランディングページを現在のプロジェクトに適応させる場合:

  1. コピーを書く前に、現在のプロジェクトフォルダを調べて製品コンテキストを取得します。README、PRODUCT.md、package.json、既存のランディングページ、ドキュメント、ソース文字列、スクリーンショット、ブランドアセットを優先します。
  2. 検証済みクローンに対してscripts/extract_landing_inventory.pyを実行し、テキストと画像の計画を準備します。
  3. 元の表示テキストから置換テキストへのコピーマップを作成します。同じコンテンツ階層を維持し、レイアウトが崩れないようにテキストの長さをほぼ同じにします。
  4. ブランド名、見出し、サブ見出し、CTA、機能ラベル、推薦文、FAQテキスト、フッターコピーをプロジェクト関連の言語に置き換えます。
  5. ユーザーが明示的に構造変更を要求しない限り、ソースのレイアウト、アニメーションタイミング、セクション順序、コンポーネント構造を維持します。
  6. ラスター画像、ヒーローメディア、サムネイル、アバター、製品モックアップ、装飾写真をインベントリします。
  7. ソース画像を残すべきでない場合、プロジェクト関連のラスター置換にはimagegenスキルを使用します。生成されたアセットをlanding-pages/<slug>/assets/generated/に保存し、HTML/CSS参照を更新します。
  8. 元の画像の寸法、アスペクト比、クロップ動作、object-fit、ボーダー半径、視覚的な重みを維持することを優先します。
  9. ユーザーが要求しない限り、単純なSVGアイコン、ベクターマーク、CSSグラデーション、または幾何学的な装飾を生成されたビットマップに置き換えないでください。
  10. ユーザーがプライベート参照クローン用に明示的に保持したい場合を除き、サードパーティのブランドロゴ、名前、スクリーンショット、商標を削除または置き換えます。
  11. コピーと画像の置き換え後、ブラウザで最終的な適応ページを検証します。テキストオーバーフロー、画像切れ、モバイルでの折り返し、レイアウトのずれを修正します。

DESIGN.md生成

デザイン抽出モードの場合、バンドルされたスクリプトを使用します:

python3 scripts/generate_design_md.py "$CLONE_HTML" \
  --name "$SITE_NAME" \
  --url "$SITE_URL" \
  --out-dir "design-md/$SLUG" \
  --json-out "design-md/$SLUG/evidence.json"

複数のキャプチャページの場合:

python3 scripts/generate_design_md.py \
  "captures/$SLUG/home/clone.html" \
  "captures/$SLUG/workspace/clone.html" \
  "captures/$SLUG/settings-modal-open/clone.html" \
  --name "$SITE_NAME" \
  --url "$SITE_URL" \
  --out-dir "design-md/$SLUG" \
  --json-out "design-md/$SLUG/evidence.json"

または、キャプチャルートを直接スキャンします:

python3 scripts/generate_design_md.py \
  --capture-dir "captures/$SLUG" \
  --name "$SITE_NAME" \
  --url "$SITE_URL" \
  --out-dir "design-md/$SLUG" \
  --json-out "design-md/$SLUG/evidence.json"

これらの値がない場合はオプションフラグを省略します。

生成後:

  • 生成されたDESIGN.mdを読みます
  • 曖昧な表現を明確にします
  • トークンクレームをソースに基づいて維持します
  • 不確かなステートメントは推測としてマークします

以下のことを決して捏造しないでください:

  • クローンに存在しない色
  • CSSで観測されなかったフォントファミリー
  • 抽出されなかったブレークポイント
  • キャプチャしなかったランタイム状態を必要とするインタラクション
  • セッションに実際に含めなかったページやフローに対するカバレッジクレーム

必須のDESIGN.mdセクション:

  1. ビジュアルテーマと雰囲気
  2. カラーパレットと役割
  3. タイポグラフィルール
  4. コンポーネントスタイリング
  5. レイアウト原則
  6. 奥行きとエレベーション
  7. すべきこととすべきでないこと
  8. レスポンシブ動作
  9. エージェントプロンプトガイド

最終応答

ランディングリミックスモードの場合、以下を報告します:

  • ソースURL
  • キャプチャフォルダと検証済みクローンパス
  • 最終ランディングページフォルダとindex.html
  • 置換コピーの決定に使用したプロジェクトファイル
  • 行われたコピー置換の数
  • 作成された生成画像の数とその保存先
  • 実行されたデスクトップ/モバイルブラウザ検証
  • キャプチャされなかったインタラクションやクリーンに置き換えられなかったアセットなどの制限事項

デザイン抽出モードの場合、以下を報告します:

  • ライブURLからクローンした場合、キャプチャフォルダが保存された場所
  • 単一のclone.htmlが含まれているか、複数のページフォルダにそれぞれclone.htmlが含まれているか、およびオプションでhomepage.png/live.jsonが含まれているか
  • 出力フォルダが保存された場所
  • DESIGN.md、README.md、preview.html、preview-dark.htmlが含まれているか
  • evidence.jsonが生成された場合、その保存先
  • 結果が強力なクローンソースから得られたものか、弱いフォールバックから得られたものか
  • 最終的な統合に含まれたページまたは状態の数
  • 顕著な制限事項

関連スキル