CommunityImagemgithub.com

screenshot-to-compose

Transforme capturas de tela de design (JPG/PNG, frequentemente geradas por IA) ou quadros do Figma em uma UI nativa em Kotlin Jetpack Compose que corresponda fielmente ao design, com foco em design-first. Meça pixels e cores (px para dp), escreva inventários de telas/ativos e um sistema de design com valores observados vs inferidos, converta ícones do Iconify em VectorDrawables, gere arte em vez de recortar capturas de tela, implemente telas MVI e compare as renderizações do emulador ou Roborazzi com a referência. Use sempre que o usuário fornecer capturas de tela, mockups ou um repositório de design e quiser que sejam construídos como um aplicativo Android Compose, disser "faça esta tela em Compose", "corresponda ao design", "px para dp", "screenshot para código", ou quiser uma UI de aplicativo inteira construída design-first, mesmo que nunca diga "Compose".

O que é screenshot-to-compose?

Este skill transforma capturas de tela de design ou quadros do Figma em uma UI nativa em Kotlin Jetpack Compose, garantindo fidelidade visual e estrutural. Ele é especialmente útil para desenvolvedores Android que desejam reproduzir designs exatos sem depender de adivinhação de espaçamentos e cores. O fluxo de trabalho inclui medição precisa de pixels e cores (px para dp), criação de inventários de telas e ativos, definição de um sistema de design com valores observados (medidos) e inferidos (supostos), conversão de ícones do Iconify para VectorDrawables, geração de arte em vez de recorte das capturas, implementação de telas no padrão MVI (Model-View-Intent) e verificação final com renderizações do emulador ou Roborazzi. O skill enfatiza evitar erros comuns, como recortar imagens de referência de baixa resolução, substituir UI nativa por imagens, ou inventar design quando a referência é ambígua. Suporta os fluxos "design-first", onde o design é a entrada principal, e se integra com outros skills como `app-design-studio` quando não há design disponível. A saída é uma UI totalmente funcional e documentada, com verificação visual automatizada.

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

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que screenshot-to-compose faz?

Reproduza um design fielmente em Compose sem estimar visualmente. A imagem de referência é o teste de aceitação, então cada número que você usa é observado (medido na imagem) ou inferido (um palpite que você declara), e a tela finalizada é comparada com a referência ao final.

Quando o design é a entrada

  • Apenas capturas de tela/mockups: siga todas as fases abaixo.
  • Quadros do Figma disponíveis: pule a medição (leia os valores do Figma) e mantenha o restante.
  • Ainda não há design: use o skill app-design-studio primeiro e depois volte aqui.

Fluxo de trabalho

Trabalhe em arquivos (docs/design/), uma tela por vez após as fundações compartilhadas existirem. Não implemente nada até que todo o inventário de telas seja compreendido.

  1. Inspecione. Leia o repositório primeiro (arquitetura, tema, componentes compartilhados, telas existentes). Preserve o que funciona. Anote suposições.
  2. Inventário. Copie as referências inalteradas para docs/design/reference/ (nomes em kebab-case). Escreva SCREEN_INVENTORY.md: cada imagem -> tela + estado, links entre telas, referências ausentes (uma tela linkada mas não mostrada), tamanho em pixels e proporção. Inclua todos os estados: carregando, vazio, erro, offline, permissão, premium.
  3. Meça. Execute scripts/measure_image.py shot.png --frame-dp 390 --sample x,y ... para a escala px->dp e amostras de cor (references/measuring.md). Pixels não são dp: assuma um frame de 390 dp a menos que informado o contrário, dp = px / (imageWidthPx / 390). Registre valores observados e inferidos em colunas separadas.
  4. Sistema de design. Mapeie as cores medidas para os papéis do Material 3, escala tipográfica, formas, espaçamentos no tema. As telas usam apenas tokens de tema (sem hex, tamanhos ou raios nas telas). Defina claro e escuro; se apenas o claro existe, derive o escuro sem alterar o layout.
  5. Ativos (references/assets.md). Ícones: uma família, obtidos do Iconify, convertidos com scripts/svg_to_vectordrawable.py. Arte: gere-a, nunca a recorte das capturas de tela. Texto, botões, cartões, anéis e gráficos são sempre Compose, nunca imagens. Registre origem, licença, modelo e prompt em ASSET_INVENTORY.md.
  6. Planeje. Por tela, decida antecipadamente: comportamento do botão voltar, classe de rede/offline, permissões, scroll-ou-ajuste em celulares pequenos, movimento. Escreva SCREEN_IMPLEMENTATION_PLAN.md com a ordem de construção. (As regras de qualidade para estas vivem no skill android-compose-quality-gate.)
  7. Implemente as fundações compartilhadas primeiro, depois as telas: composables sem estado sobre um estado de UI imutável, ViewModel com intents, um composable por arquivo, recursos de string para todo texto. Paralelize apenas módulos independentes com arquivos disjuntos. Leia references/compose-lessons.md antes de construir cartões, tiles ou texto apertado.
  8. Compare (references/verification.md). Renderize a tela (captura de emulador ou Roborazzi), coloque-a ao lado da referência com largura igual usando scripts/compare_side_by_side.py, liste diferenças em layout, espaçamento, tipografia, cor, formas e ativos, corrija, repita. Em seguida, verifique dispositivos pequenos (360 x 526 dp), texto longo/alemão, RTL, escuro, escala de fonte 1.3. Nunca troque funcionalidade ou responsividade por correspondência de pixel.
  9. Entregue. Mantenha referências, ativos com prompts, origens/licenças de ícones, inventários e notas de comparação atualizados. Uma tela está pronta apenas quando funciona e passa na comparação visual. Commite por tópico.

Regras que impedem as falhas comuns

  • Nunca recorte imagens das capturas de tela de referência (baixa resolução, comprimidas, UI embutida).
  • Nunca substitua UI nativa por uma imagem dela.
  • Nunca invente um design quando a referência é ambígua: faça a inferência mais razoável, escreva-a na coluna inferida, mantenha-se próximo à referência.
  • Não afirme que uma tela está pronta antes de ela ter sido executada e comparada.
  • Sem segredos (chaves de API) no repositório ou docs; chaves de serviços de imagem vêm do ambiente.

Arquivos

  • references/measuring.md - px para dp, amostragem de cor, tabelas observado vs inferido.
  • references/assets.md - Iconify para VectorDrawable, ordem de geração de imagem e revisão, tamanhos de exportação, outras fontes.
  • references/compose-lessons.md - defeitos que custam tempo real: proporções de cartões irmãos, travamento por medição intrínseca, limites de largura, texto com redimensionamento automático.
  • references/verification.md - loop de comparação entre emulador e Roborazzi e a 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.

Habilidades Relacionadas