CommunityImagengithub.com

screenshot-to-compose

Convierte capturas de diseño (JPG/PNG, a menudo generadas por IA) o marcos de Figma en una interfaz nativa de Jetpack Compose para Android que coincida fielmente, midiendo píxeles y colores (px a dp), generando inventarios y un sistema de diseño, y comparando los resultados visualmente.

¿Qué es screenshot-to-compose?

Esta habilidad transforma una captura de pantalla de diseño (o un frame de Figma) en una interfaz de usuario de Android Compose funcional y de alta fidelidad. El proceso comienza midiendo píxeles y colores de la imagen de referencia para convertirlos a dp y tokens de Material 3, documentando cada valor como **observado** (medido exactamente) o **inferido** (estimado y anotado). Utiliza Iconify para obtener iconos en formato VectorDrawable, genera el artwork (ilustraciones) mediante prompts, en lugar de recortar la captura original, y construye las pantallas siguiendo el patrón MVI con ViewModel e intents. Finalmente, compara la pantalla renderizada (emulador o Roborazzi) con la referencia lado a lado para verificar la coincidencia visual, incluyendo pruebas en dispositivos pequeños, modo oscuro, RTL y escalado de fuente. Es ideal para desarrolladores que quieren pasar de un diseño visual a código Compose sin perderse en estimaciones aproximadas.

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

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace screenshot-to-compose?

Reproduce un diseño fielmente en Compose sin hacerlo a ojo. La imagen de referencia es la prueba de aceptación, por lo que cada número que uses es observado (medido en la imagen) o inferido (una estimación que declaras), y la pantalla final se compara con la referencia al final.

Cuándo el diseño es la entrada

  • Solo capturas/maquetas: sigue todas las fases a continuación.
  • Marcos de Figma disponibles: omite la medición (lee los valores de Figma) y mantén el resto.
  • Aún no hay diseño: usa primero la habilidad app-design-studio y luego vuelve aquí.

Flujo de trabajo

Trabaja en archivos (docs/design/), una pantalla a la vez después de que existan las bases compartidas. No implementes nada hasta que se comprenda el inventario completo de pantallas.

  1. Inspeccionar. Lee primero el repositorio (arquitectura, tema, componentes compartidos, pantallas existentes). Conserva lo que funciona. Anota suposiciones.
  2. Inventario. Copia las referencias sin cambios en docs/design/reference/ (nombres en kebab-case). Escribe SCREEN_INVENTORY.md: cada imagen -> pantalla + estado, enlaces entre pantallas, referencias faltantes (una pantalla enlazada pero no mostrada), tamaño en píxeles y relación de aspecto. Incluye todos los estados: carga, vacío, error, sin conexión, permiso, premium.
  3. Medir. Ejecuta scripts/measure_image.py shot.png --frame-dp 390 --sample x,y ... para la escala px->dp y muestras de color (references/measuring.md). Los píxeles no son dp: asume un marco de 390 dp a menos que se indique lo contrario, dp = px / (imageWidthPx / 390). Registra los valores observados e inferidos en columnas separadas.
  4. Sistema de diseño. Asigna los colores medidos a roles de Material 3, escala tipográfica, formas, espaciado en el tema. Las pantallas usan solo tokens del tema (sin hex, tamaños ni radios en las pantallas). Define claro y oscuro; si solo existe claro, deriva el oscuro sin cambiar el diseño.
  5. Activos (references/assets.md). Iconos: una familia, obtenidos de Iconify, convertidos con scripts/svg_to_vectordrawable.py. Artwork: genéralo, nunca lo recortes de las capturas. Texto, botones, tarjetas, anillos y gráficos son siempre de Compose, nunca imágenes. Registra fuente, licencia, modelo y prompt en ASSET_INVENTORY.md.
  6. Planificar. Por pantalla decide de antemano: comportamiento del botón Atrás, clase de red/sin conexión, permisos, desplazamiento o ajuste en teléfonos pequeños, animación. Escribe SCREEN_IMPLEMENTATION_PLAN.md con el orden de construcción. (Las reglas de calidad para estos viven en la habilidad android-compose-quality-gate).
  7. Implementar primero las bases compartidas, luego las pantallas: composables sin estado sobre un estado de UI inmutable, ViewModel con intents, un composable por archivo, recursos de cadena para todo el texto. Paraleliza solo módulos independientes con archivos disjuntos. Lee references/compose-lessons.md antes de construir tarjetas, mosaicos o texto ajustado.
  8. Comparar (references/verification.md). Renderiza la pantalla (captura de emulador o Roborazzi), ponla junto a la referencia al mismo ancho con scripts/compare_side_by_side.py, enumera las diferencias en diseño, espaciado, tipografía, color, formas y activos, corrige, repite. Luego verifica en dispositivos pequeños (360 x 526 dp), texto largo/alemán, RTL, oscuro, escala de fuente 1.3. Nunca sacrifiques funcionalidad o capacidad de respuesta por la coincidencia de píxeles.
  9. Entregar. Mantén las referencias, activos con prompts, fuentes/licencias de iconos, inventarios y notas de comparación actualizados. Una pantalla está terminada solo cuando funciona y pasa la comparación visual. Realiza commits por tema.

Reglas que evitan fallos habituales

  • Nunca recortes imágenes de las capturas de referencia (baja resolución, comprimidas, UI incrustada).
  • Nunca reemplaces la UI nativa con una imagen de ella.
  • Nunca inventes un diseño cuando la referencia es ambigua: haz la inferencia más razonable, escríbela en la columna de inferidos, mantente cerca de la referencia.
  • No afirmes que una pantalla está terminada antes de que se haya ejecutado y comparado.
  • Sin secretos (claves API) en el repositorio o documentos; las claves del servicio de imágenes provienen del entorno.

Archivos

  • references/measuring.md - px a dp, muestreo de color, tablas de observados vs inferidos.
  • references/assets.md - Iconify a VectorDrawable, orden de generación de imágenes y revisión, tamaños de exportación, otras fuentes.
  • references/compose-lessons.md - defectos que cuestan tiempo real: proporciones de tarjetas hermanas, error de medición intrínseca, umbrales de ancho, texto de tamaño automático.
  • references/verification.md - bucle de comparación entre emulador y Roborazzi y la matriz de dispositivos.
  • 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 relacionados