CommunityImagegithub.com

screenshot-to-compose

Transformez des captures d'écran de design (JPG/PNG, souvent générées par IA) ou des maquettes Figma en une interface utilisateur native Kotlin Jetpack Compose qui correspond fidèlement au design. Mesurez les pixels et les couleurs (px vers dp), rédigez des inventaires d'écrans et un système de design complet, intégrez les icônes Iconify en VectorDrawables, générez les illustrations, implémentez des écrans MVI, puis comparez les rendus émulés ou Roborazzi avec la référence.

Qu'est-ce que screenshot-to-compose ?

Ce skill permet de reproduire un design d’interface utilisateur (issu de captures d’écran, de maquettes IA ou de fichiers Figma) en un écran natif Kotlin Jetpack Compose, pixel par pixel. Il guide l’assistant à travers un workflow rigoureux : inspection du code existant, inventaire des écrans avec tous leurs états (chargement, vide, erreur, hors ligne, etc.), conversion px→dp via l’outil `measure_image.py`, création d’un système de design basé sur les tokens Material 3, import des icônes depuis Iconify (génération de VectorDrawables), génération d’illustrations (jamais de rognage des captures), planification de l’implémentation écran par écran, développement en MVI avec ViewModel et composables sans état, puis vérification visuelle automatisée par comparaison côte à côte des rendus. Le skill impose des règles strictes pour éviter les échecs courants : ne jamais rogner les images des captures, ne pas remplacer l’UI native par une image, ne pas inventer de design sans le noter comme valeur inférée, et ne déclarer un écran terminé qu’après exécution et comparaison réussie. Il s’applique à tous les projets Android Compose où l’utilisateur fournit des visuels et demande à ce que l’UI soit construite en respectant le design.

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

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait screenshot-to-compose ?

Reproduire un design fidèlement en Compose sans approximation. L’image de référence est le test d’acceptation, donc chaque nombre utilisé est soit observé (mesuré sur l’image) soit inféré (une hypothèse que vous déclarez), et l’écran final est comparé à la référence à la fin.

Quand le design est l’entrée

  • Captures d’écran/maquettes uniquement : suivre toutes les phases ci-dessous.
  • Maquettes Figma disponibles : ignorer la phase de mesure (lire les valeurs depuis Figma) et garder le reste.
  • Pas encore de design : utiliser d’abord le skill app-design-studio, puis revenir ici.

Workflow

Travail dans les fichiers (docs/design/), un écran à la fois après la mise en place des fondations partagées. Ne rien implémenter tant que tout l’inventaire des écrans n’est pas compris.

  1. Inspecter. Lire d’abord le dépôt (architecture, thème, composants partagés, écrans existants). Conserver ce qui fonctionne. Noter les hypothèses.
  2. Inventaire. Copier les références sans les modifier dans docs/design/reference/ (noms en kebab-case). Rédiger SCREEN_INVENTORY.md : chaque image → écran + état, liens entre écrans, références manquantes (un écran lié mais non montré), taille en pixels et rapport hauteur/largeur. Inclure tous les états : chargement, vide, erreur, hors ligne, permission, premium.
  3. Mesurer. Exécuter scripts/measure_image.py shot.png --frame-dp 390 --sample x,y ... pour l’échelle px→dp et les échantillons de couleur (references/measuring.md). Les pixels ne sont pas des dp : supposer un cadre de 390 dp sauf indication contraire, dp = px / (largeurImagePx / 390). Enregistrer les valeurs observées et inférées dans des colonnes séparées.
  4. Système de design. Mapper les couleurs mesurées aux rôles Material 3, échelle typographique, formes, espacements dans le thème. Les écrans n’utilisent que les tokens du thème (pas de hex, tailles ou rayons dans les écrans). Définir les modes clair et sombre ; si seul le clair existe, dériver le sombre sans modifier la mise en page.
  5. Ressources (references/assets.md). Icônes : une seule famille, récupérées depuis Iconify, converties avec scripts/svg_to_vectordrawable.py. Illustrations : les générer, ne jamais les rogner des captures d’écran. Le texte, les boutons, les cartes, les anneaux et les graphiques sont toujours en Compose, jamais en images. Enregistrer la source, la licence, le modèle et le prompt dans ASSET_INVENTORY.md.
  6. Planifier. Pour chaque écran, décider à l’avance : comportement retour, classe réseau/hors ligne, permissions, scroll ou fit sur les petits téléphones, animations. Rédiger SCREEN_IMPLEMENTATION_PLAN.md avec l’ordre de construction. (Les règles de qualité pour ces aspects se trouvent dans le skill android-compose-quality-gate.)
  7. Implémenter d’abord les fondations partagées, puis les écrans : composables sans état sur un état UI immuable, ViewModel avec intentions, un composable par fichier, ressources chaînes pour tout le texte. Paralléliser uniquement les modules indépendants avec des fichiers disjoints. Lire references/compose-lessons.md avant de construire des cartes, des tuiles ou du texte serré.
  8. Comparer (references/verification.md). Générer le rendu de l’écran (capture d’écran d’émulateur ou Roborazzi), le placer à côté de la référence à largeur égale avec scripts/compare_side_by_side.py, lister les différences de mise en page, espacement, typographie, couleurs, formes et ressources, corriger, répéter. Ensuite vérifier sur les petits appareils (360 x 526 dp), texte long/allemand, RTL, sombre, échelle de police 1.3. Ne jamais sacrifier la fonctionnalité ou la réactivité pour une correspondance pixel parfaite.
  9. Livrer. Garder les références, les ressources avec leurs prompts, les sources/licences d’icônes, les inventaires et les notes de comparaison à jour. Un écran n’est terminé que lorsqu’il fonctionne et passe la comparaison visuelle. Commiter par sujet.

Règles qui empêchent les échecs habituels

  • Ne jamais rogner des images des captures de référence (basse résolution, compressées, UI intégrée).
  • Ne jamais remplacer l’UI native par une image de celle-ci.
  • Ne jamais inventer un design quand la référence est ambiguë : faire l’inférence la plus raisonnable, l’écrire dans la colonne inférée, rester proche de la référence.
  • Ne pas déclarer un écran terminé avant qu’il ait été exécuté et comparé.
  • Pas de secrets (clés API) dans le dépôt ou la documentation ; les clés de service d’image proviennent de l’environnement.

Fichiers

  • references/measuring.md – px vers dp, échantillonnage de couleurs, tableaux observé vs inféré.
  • references/assets.md – Iconify vers VectorDrawable, ordre de génération et revue des images, tailles d’exportation, autres sources.
  • references/compose-lessons.md – défauts qui coûtent du temps réel : ratios de cartes frères, plantage de mesure intrinsèque, seuils de largeur, texte à auto-dimensionnement.
  • references/verification.md – boucle de comparaison émulateur vs Roborazzi et la matrice d’appareils.
  • 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.

Skills associés