Community画像github.com

screenshot-to-compose

アプリデザインのスクリーンショット(JPG/PNG、AI生成画像を含む)やFigmaフレームから、デザインと一致するネイティブなKotlin Jetpack Compose UIを生成します。ピクセルと色を測定(px→dp)し、スクリーン・アセットのインベントリとデザインシステム(観測値・推論値を区別)を作成し、IconifyアイコンをVectorDrawableに変換、スクリーンショットからクロップせずにアートワークを生成、MVIスクリーンを実装し、エミュレータまたはRoborazziのレンダリングとリファレンスを比較します。

screenshot-to-compose とは?

このスキルは、ユーザーが提供するデザインのスクリーンショットやモックアップ、Figmaフレームをもとに、忠実度の高いJetpack Compose UIを構築するためのワークフローを提供します。主な特徴として、画像からピクセル単位で色やサイズを測定し(px→dp変換)、観測値と推論値を明確に分けたデザインシステムを構築します。IconifyでアイコンをVectorDrawableに変換し、スクリーンショットからの画像クロップは行わず、生成AIなどでアートワークを生成します。最終的に、エミュレータのスクリーンショットやRoborazziのレンダリングをリファレンス画像と比較し、レイアウト、スペーシング、タイポグラフィ、色などの差分を検出して修正する検証ループを実行します。Android Composeプロジェクトで「この画面をComposeで作って」「デザインを合わせて」「px→dp」「スクリーンショットからコードへ」といったリクエストがあった際に使用します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/zohaibmushwani/agent-skills/tree/HEAD/skills/screenshot-to-compose

Installed? Explore more 画像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

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

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

ドキュメント

screenshot-to-compose は何をしますか?

デザインを目視せずに、忠実にComposeで再現します。リファレンス画像が受け入れテストとなるため、使用するすべての数値は観測値(画像上で測定)または推論値(推定値を明示)のいずれかであり、完成した画面は最後にリファレンスと比較されます。

デザインが入力の場合

  • スクリーンショット/モックアップのみ:以下の全フェーズを実行します。
  • Figmaフレームがある場合:測定はスキップ(Figmaから値を読み取る)し、残りの工程を実行します。
  • デザインがまだない場合:まず app-design-studio スキルを使用し、その後このスキルに戻ってきます。

ワークフロー

ファイル(docs/design/)内で作業し、共有基盤ができた後に1画面ずつ処理します。画面のインベントリ全体を把握するまでは、何も実装しないでください。

  1. 調査。 リポジトリを最初に読み込みます(アーキテクチャ、テーマ、共有コンポーネント、既存の画面)。うまく機能している部分は維持します。前提条件をメモします。
  2. インベントリ作成。 リファレンス画像をそのまま docs/design/reference/ にコピーします(ケバブケースの名前を使用)。SCREEN_INVENTORY.md を作成します:各画像 → 画面 + 状態、画面間のリンク、欠落しているリファレンス(リンクされているが画像がない画面)、ピクセルサイズとアスペクト比。すべての状態(ローディング、空、エラー、オフライン、パーミッション、プレミアム)を含めます。
  3. 測定。 scripts/measure_image.py shot.png --frame-dp 390 --sample x,y ... を実行し、px→dpのスケールとカラーサンプルを取得します(references/measuring.md 参照)。ピクセルはdpではありません。特に指定がない限り390 dpのフレームを想定し、dp = px / (imageWidthPx / 390) と計算します。観測値と推論値を別々のカラムに記録します。
  4. デザインシステム。 測定した色をMaterial 3のロールにマッピングし、タイプスケール、シェイプ、スペーシングをテーマに設定します。画面ではテーマトークンのみを使用し(画面内に16進数カラーコードやサイズ、半径を直接書かない)。ライトテーマとダークテーマを定義します。ライトテーマのみ存在する場合は、レイアウトを変更せずにダークテーマを導出します。
  5. アセット(references/assets.md)。アイコン:1つのファミリーから選択し、Iconifyから取得して scripts/svg_to_vectordrawable.py で変換します。アートワーク:生成し、スクリーンショットからクロップしないでください。テキスト、ボタン、カード、リング、チャートは常にComposeで実装し、画像にしないでください。ソース、ライセンス、モデル、プロンプトを ASSET_INVENTORY.md に記録します。
  6. 計画。 画面ごとに事前に決定します:戻る動作、ネットワーク/オフラインクラス、パーミッション、小さな画面でのスクロールまたはフィット、モーション。SCREEN_IMPLEMENTATION_PLAN.md にビルド順序を書きます(これらの品質ルールは android-compose-quality-gate スキルにあります)。
  7. 実装。 共有基盤を最初に実装し、次に画面を実装します:不変のUI状態に対するステートレスコンポーザブル、Intentを持つViewModel、1ファイルにつき1コンポーザブル、すべてのテキストに文字列リソースを使用。独立したモジュールでファイルが重複しない場合のみ並列化します。カード、タイル、または密なテキストを構築する前に references/compose-lessons.md を読んでください。
  8. 比較(references/verification.md)。画面をレンダリングし(エミュレータのスクリーンショットまたはRoborazzi)、scripts/compare_side_by_side.py を使用してリファレンスと等幅で並べ、レイアウト、スペーシング、タイポグラフィ、色、シェイプ、アセットの差分をリストアップし、修正して繰り返します。その後、小型デバイス(360 x 526 dp)、長いテキスト/ドイツ語、RTL、ダークテーマ、フォントスケール1.3でチェックします。機能やレスポンシブ性をピクセル一致のために犠牲にしないでください。
  9. 納品。 リファレンス、プロンプト付きアセット、アイコンソース/ライセンス、インベントリ、比較ノートを最新に保ちます。画面は、動作かつビジュアル比較に合格した場合のみ完了とみなします。トピックごとにコミットします。

よくある失敗を防ぐルール

  • リファレンススクリーンショットから画像をクロップしないでください(低解像度、圧縮、UIが埋め込まれている)。
  • ネイティブUIをその画像で置き換えないでください。
  • リファレンスがあいまいな場合にデザインをでっち上げないでください。最も合理的な推論を行い、推論値のカラムに書き込み、リファレンスに近づけてください。
  • 画面が実行され比較されるまでは、完了したと主張しないでください。
  • リポジトリやドキュメントにシークレット(APIキー)を含めないでください。画像サービスのキーは環境変数から取得します。

ファイル

  • references/measuring.md - pxからdpへの変換、カラーサンプリング、観測値と推論値のテーブル
  • references/assets.md - IconifyからVectorDrawableへの変換、画像生成の順序とレビュー、エクスポートサイズ、その他のソース
  • references/compose-lessons.md - 実際に時間を浪費する欠陥:兄弟カードの比率、Intrinsic measurement クラッシュ、幅のしきい値、自動サイズ調整テキスト
  • references/verification.md - エミュレータとRoborazziの比較ループ、およびデバイスマトリックス
  • scripts/measure_image.py、scripts/svg_to_vectordrawable.py、scripts/compare_side_by_side.py(Python 3 + Pillow)

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

app-design-studio

Turn an app name or a website / web-app idea into a complete high-fidelity UI design repository - pages or screens, every state (loading, empty, error, offline), dialogs, sheets, components, interactions - with a locked design system and measurable usability gates. Three targets, each with its own profile and wording - mobile app (portrait screens: splash, onboarding, auth, home, settings), website (landscape desktop pages plus a narrow responsive layout), web app / portal / dashboard. Use whenever the user gives an app name or idea and wants screens, pages, UI design, a design repo, mockups, a screen inventory, or a design to hand to developers/designers, even if they never say "skill" or "Figma". Also use to audit or fix an existing set of generated screens for usability (contrast, targets, states) while keeping them beautiful.

store-screenshots

Create App Store and Google Play marketing screenshot sets that look like top-chart apps - a headline-led story of 5-8 frames with a poster-style first frame, zoomed real UI fragments, a dominant brand colour, panoramic links between frames, social proof and human touches - generated frame by frame with Codex (GPT Image) using the app's real screens as reference images, text-checked and edit-passed, then fitted to the exact store sizes. Use whenever the user wants store screenshots, "App Store screenshots", "Play Store images", listing graphics, a screenshot redesign or "before/after" for a store page, or wants their app's store page to convert better, even if they only say "screenshots" for an app. Takes real app screens (for example from app-design-studio) as input.

関連スキル