CommunityBildgithub.com

Screenshot-to-Compose

Wandelt App-Design-Screenshots (JPG/PNG, oft KI-generiert) oder Figma-Frames in eine native Kotlin Jetpack Compose UI um, die das Design originalgetreu nachbildet – design-first. Misst Pixel und Farben (px zu dp), erstellt Bildschirm- und Asset-Inventare und ein Designsystem mit beobachteten vs. abgeleiteten Werten, baut Iconify-Icons in VectorDrawables um, generiert Artwork statt Screenshots zuzuschneiden, implementiert MVI-Bildschirme und vergleicht am Ende Emulator- oder Roborazzi-Renderings mit der Referenz.

Was ist Screenshot-to-Compose?

Diese Fähigkeit ist für Entwickler gedacht, die Design-Screenshots, Mockups oder Figma-Frames als Ausgangspunkt haben und eine präzise Android-Compose-UI erstellen möchten. Sie vermeidet das ‚Augenmaß‘, indem sie systematisch Pixel misst, Farben abtastet und alle Werte als beobachtet oder abgeleitet kennzeichnet. Der Workflow umfasst die Phasen Inspizieren, Inventarisieren, Messen, Designsystem definieren, Assets erstellen, Planen, Implementieren, Vergleichen und Ausliefern. Dabei wird strikt darauf geachtet, Kunstwerke zu generieren statt aus Screenshots auszuschneiden, Icons aus Iconify zu beziehen und als VectorDrawables zu konvertieren, und die finale UI mit einem Side-by-Side-Vergleichstool gegen die Referenz zu prüfen. Die Fähigkeit unterstützt MVI-Architektur, Material 3 Design Tokens, helles/dunkles Theme, und berücksichtigt Edge Cases wie kleine Bildschirme, lange Texte, RTL und hohe Schriftgrade. Der Vergleichsschritt automatisiert die visuelle Qualitätssicherung und verhindert typische Fehler wie das Einbetten von Bildern statt nativer UI oder das Erfinden von Design, wenn die Referenz mehrdeutig ist.

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

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Screenshot-to-Compose?

Reproduzieren Sie ein Design originalgetreu in Compose, ohne es nach Augenmaß zu erstellen. Das Referenzbild ist der Akzeptanztest, daher ist jeder verwendete Wert entweder beobachtet (am Bild gemessen) oder abgeleitet (eine von Ihnen benannte Schätzung), und der fertige Bildschirm wird am Ende mit der Referenz verglichen.

Wenn das Design die Eingabe ist

  • Nur Screenshots/Mockups: alle folgenden Phasen durchlaufen.
  • Figma-Frames verfügbar: Messen überspringen (Werte aus Figma auslesen) und den Rest beibehalten.
  • Noch kein Design: zuerst die Fähigkeit app-design-studio verwenden, dann hierher zurückkehren.

Arbeitsablauf

Arbeiten Sie in Dateien (docs/design/), einen Bildschirm nach dem anderen, nachdem die gemeinsamen Grundlagen vorhanden sind. Implementieren Sie nichts, bis das gesamte Bildschirminventar verstanden ist.

  1. Inspizieren. Lesen Sie zuerst das Repository (Architektur, Theme, gemeinsam genutzte Komponenten, vorhandene Bildschirme). Bewahren Sie, was funktioniert. Notieren Sie Annahmen.
  2. Inventarisieren. Kopieren Sie die Referenzen unverändert in docs/design/reference/ (kebab-case-Namen). Schreiben Sie SCREEN_INVENTORY.md: jedes Bild -> Bildschirm + Zustand, Verknüpfungen zwischen Bildschirmen, fehlende Referenzen (ein verlinkter, aber nicht gezeigter Bildschirm), Pixelgröße und Seitenverhältnis. Jeden Zustand einschließen: laden, leer, Fehler, offline, Berechtigung, Premium.
  3. Messen. Führen Sie scripts/measure_image.py shot.png --frame-dp 390 --sample x,y ... aus für den px->dp-Maßstab und Farbabtastungen (references/measuring.md). Pixel sind nicht dp: gehen Sie von einem 390 dp Rahmen aus, sofern nichts anderes angegeben wurde, dp = px / (imageWidthPx / 390). Notieren Sie beobachtete und abgeleitete Werte in getrennten Spalten.
  4. Designsystem. Ordnen Sie die gemessenen Farben den Material 3 Rollen zu, sowie den Schriftskalen, Formen und Abständen im Theme. Bildschirme verwenden nur Theme-Tokens (keine Hex-Werte, Größen oder Radien in den Bildschirmen). Definieren Sie hell und dunkel; wenn nur hell existiert, leiten Sie dunkel ab, ohne das Layout zu ändern.
  5. Assets (references/assets.md). Icons: eine Familie, aus Iconify bezogen, konvertiert mit scripts/svg_to_vectordrawable.py. Kunstwerke: generieren, niemals aus den Screenshots ausschneiden. Text, Buttons, Karten, Ringe und Diagramme sind immer Compose, niemals Bilder. Protokollieren Sie Quelle, Lizenz, Modell und Prompt in ASSET_INVENTORY.md.
  6. Planen. Entscheiden Sie pro Bildschirm vorab: Zurück-Verhalten, Netzwerk-/Offline-Klasse, Berechtigungen, Scroll-oder-Passend auf kleinen Telefonen, Bewegung. Schreiben Sie SCREEN_IMPLEMENTATION_PLAN.md mit der Build-Reihenfolge. (Qualitätsregeln hierfür leben in der Fähigkeit android-compose-quality-gate.)
  7. Implementieren Sie zuerst die gemeinsamen Grundlagen, dann Bildschirme: zustandslose Composables über einem unveränderlichen UI-Status, ViewModel mit Intents, ein Composable pro Datei, String-Ressourcen für alle Texte. Parallelisieren Sie nur unabhängige Module mit disjunkten Dateien. Lesen Sie references/compose-lessons.md, bevor Sie Karten, Kacheln oder engen Text bauen.
  8. Vergleichen (references/verification.md). Rendern Sie den Bildschirm (Emulator-Screenshot oder Roborazzi), setzen Sie ihn neben die Referenz bei gleicher Breite mit scripts/compare_side_by_side.py, listen Sie Unterschiede in Layout, Abständen, Typografie, Farbe, Formen und Assets auf, korrigieren Sie, wiederholen Sie. Dann prüfen Sie kleine Geräte (360 x 526 dp), langen Text/Deutsch, RTL, dunkel, Schriftgröße 1,3. Tauschen Sie niemals Funktion oder Reaktionsfähigkeit gegen pixelgenaue Übereinstimmung.
  9. Ausliefern. Behalten Sie Referenzen, Assets mit Prompts, Icon-Quellen/Lizenzen, Inventare und Vergleichsnotizen aktuell. Ein Bildschirm ist erst fertig, wenn er funktioniert und den visuellen Vergleich besteht. Commiten Sie pro Thema.

Regeln, die die üblichen Fehler verhindern

  • Schneiden Sie niemals Bilder aus Referenz-Screenshots aus (niedrige Auflösung, komprimiert, UI eingebacken).
  • Ersetzen Sie niemals native UI durch ein Bild davon.
  • Erfinden Sie kein Design, wenn die Referenz mehrdeutig ist: treffen Sie die vernünftigste Schlussfolgerung, notieren Sie sie in der abgeleiteten Spalte, bleiben Sie nah an der Referenz.
  • Behaupten Sie nicht, ein Bildschirm sei fertig, bevor er ausgeführt und verglichen wurde.
  • Keine Geheimnisse (API-Schlüssel) im Repository oder in Dokumenten; Bilddienst-Schlüssel stammen aus der Umgebung.

Dateien

  • references/measuring.md - px zu dp, Farbabtastung, Tabellen für beobachtet vs. abgeleitet.
  • references/assets.md - Iconify zu VectorDrawable, Reihenfolge der Bildgenerierung und Überprüfung, Exportgrößen, andere Quellen.
  • references/compose-lessons.md - Fehler, die echte Zeit kosten: Kartenverhältnisse von Geschwistern, Absturz bei intrinsischer Messung, Breitenschwellen, automatisch skalierender Text.
  • references/verification.md - Emulator- vs. Roborazzi-Vergleichsschleife und die Gerätematrix.
  • 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.

Verwandte Skills