Communitygithub.com

app-design-studio

Transforme um nome de aplicativo ou uma ideia de site/aplicativo web em um repositório completo de design de UI de alta fidelidade – incluindo páginas/telas, todos os estados (carregamento, vazio, erro, offline), diálogos, folhas, componentes e interações – com um sistema de design fixo e portões de usabilidade mensuráveis.

O que é app-design-studio?

App Design Studio é uma skill especializada (para agentes de IA como Claude Code, Cursor ou Codex) que converte um simples nome de aplicativo ou ideia de site em um repositório de design de interface do usuário (UI) completo, de alta fidelidade e consistente. Ela gera não apenas as telas principais, mas também todos os estados (carregamento, vazio, erro, offline), diálogos, folhas, componentes e interações, garantindo que o design seja bonito e usável. A skill suporta três alvos principais: aplicativos móveis (telas verticais como splash, onboarding, autenticação, home e configurações), sites (páginas desktop no formato paisagem 16:10, com layout responsivo estreito) e aplicativos web/portais/dashboards (layout desktop paisagem como padrão, com layout estreito secundário). O processo é altamente estruturado em fases (S0 a S9), começando com a definição do perfil do alvo, inventário de telas, criação de um sistema de design fixo (com verificação de contraste e tokens), geração de componentes e telas, autoavaliação com métricas de usabilidade (alvos de toque, tamanho de texto, contraste) e revisão humana. A skill utiliza scripts Python para verificar conformidade com regras de design, como contraste de cores, espaçamento e tamanho de texto, e mantém um log de veredictos para aprendizado contínuo. O resultado final é um repositório organizado com PNGs, especificações, tokens e relatórios, pronto para ser entregue a desenvolvedores ou designers, ou para alimentar ferramentas de código como Compose, Flutter ou React Native.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/zohaibmushwani/agent-skills/tree/HEAD/skills/app-design-studio

Perguntar na sua IA favorita

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

Documentação

O que app-design-studio faz?

Objetivo: a partir de um nome de aplicativo, produzir um repositório de design que seja bonito e usável ao mesmo tempo, consistente em todas as telas e pronto para ser entregue a um designer, a um agente que está criando Compose/Flutter/React Native ou à ponte Compose-para-Figma.

Por que esta skill existe: modelos de imagem desenham telas individuais atraentes, mas derivam entre elas, esquecem estados e silenciosamente quebram a usabilidade (texto pequeno, baixo contraste, alvos de toque pequenos). Solução: fixar um sistema de design primeiro, gerar a partir dele e verificar o que pode ser medido com scripts e o que não pode (bom gosto) com uma rubrica mais a escolha humana.

Alvo = perfil (decida PRIMEIRO, em S0; nunca use o padrão silenciosamente quando o usuário disse site/portal/dashboard)

AlvoOrientação / tamanhosLeia estes (e APENAS estes para a redação do alvo)
mobile (aplicativo)telas verticais 9:19,5, um tamanhoscreen-taxonomy.md, blocos mobile de design-bible-template.md e prompt-templates/README.md, pisos em dp/sp
web tipo site (site, landing page, loja, blog)páginas desktop paisagem 16:10 (1440x900) , mais um layout responsivo estreito de 390px da mesma páginaweb-design.md, prompt-templates/web.md, bloco web de design-bible-template.md, pisos em px
web tipo app (portal, dashboard, admin, SaaS)desktop paisagem primeiro; layout estreito depois. Apenas se o usuário disser que celulares são o dispositivo principal, defina "mobile_first": true e torne o layout estreito primáriomesmo que site
both (ambos)uma bíblia e tokens compartilhados, dois perfisambos os conjuntos, nunca misturados dentro de um único prompt

Defina "platform": "mobile" | "web" em inventory.json. Um prompt é escrito com exatamente o vocabulário de um perfil.

Higiene de palavras-chave (a razão desta seção existir): modelos de imagem obedecem às palavras que recebem. Um prompt de site que diz "retrato", "telefone", "barra de status", "9:19,5", "navegação inferior", "zona do polegar", "Android/iOS" ou "tela de aplicativo" retorna uma tela de telefone. Prompts web dizem "página de site", "desktop paisagem 16:10, 1440 de largura", "cabeçalho com links", "barra lateral", "sem navegador". O layout estreito é chamado de "layout responsivo estreito, 390px de largura", nunca "tela de telefone". python scripts/prompt_lint.py <design-dir> falha em qualquer prompt em prompts/ que use palavras de outro perfil; execute-o antes de enviar um lote.

Regras de saída (sempre)

  • A imagem é a própria UI, borda a borda: sem moldura de dispositivo, sem mockup de telefone/laptop, sem cromo de navegador, sem fundo extra, sem tela ao redor. (Apenas molduras de apresentação se o usuário pedir quadros.) Mobile: telas verticais. Web: páginas desktop paisagem e, onde listado, o layout estreito; páginas longas como uma única imagem alta ou 2-3 imagens de seção da mesma largura.
  • Exemplos nesta skill são ilustrações de um padrão, nunca conteúdo: não copie seus nomes, cópia, paletas, tipo ou layouts em um prompt (guarda de viés em references/design-craft.md).
  • Alta fidelidade: texto real, ícones reais, imagens reais. Sem lorem ipsum, sem nomes de marca placeholders.
  • Um sistema de design em todo o conjunto. Nunca invente um novo estilo por tela.
  • Dois modos de prompt (references/design-craft.md): breve (intenção curta + os poucos fatos que importam + a sensação; padrão para primeiras renderizações e direções S2, dá o resultado mais distinto) e travado (strings exatas, contagens, bloco da bíblia; para irmãos após a escolha e para correções). Renderize breve primeiro, veja, depois trave o que deve concordar. Modelos falham na consistência muito mais do que na beleza, mas restringir demais a primeira renderização a torna mecânica.
  • Edite, não regere: corrija uma string errada com uma passagem de edição nomeando apenas essa alteração; uma regeneração completa joga fora tudo que já foi aprovado.
  • Sem marcas reais, logotipos ou rostos de pessoas reais; apenas nomes fictícios e marcas genéricas. Nunca escreva chaves de API no repositório.
  • Responda ao usuário no idioma em que ele escreve (frequentemente Urdu Romanizado/Hinglish); arquivos e prompts permanecem em inglês.

Fluxo de trabalho (S0-S9)

Trabalhe na pasta do projeto do usuário sob design/<app-slug>/ (layout: references/repo-layout.md). Acompanhe o status da fase em design/<app-slug>/STATUS.md. Pergunte ao usuário apenas quando a resposta mudar o resultado (máximo 3 perguntas em S0); caso contrário, escolha um padrão sensato e diga isso.

S0 Captura. Nome do aplicativo/site, propósito em uma linha, público-alvo, alvo + tipo (tabela acima; pergunte se as palavras "site", "portal", "dashboard" ou "landing page" aparecerem e o alvo não estiver claro), sensação da plataforma (mobile padrão: Android + iOS neutro, Material 3; web: neutro), palavras de tom, claro/escuro (padrão: tokens claro + escuro, telas em claro). Escreva BRIEF.md (problema, público, escopo, não-objetivos); se o usuário não estiver disponível, declare a interpretação que você fez no topo em vez de esperar. Leia references/aesthetic-vs-usability.md uma vez.

S1 Inventário de telas. Construa inventory.json a partir de references/screen-taxonomy.md (web: references/web-design.md seção 4): núcleo fixo (splash, idioma, onboarding, permissões, autenticação, home, configurações) + telas de funcionalidades específicas deste aplicativo + detalhes + estados + diálogos + folhas + componentes. Cada item tem id, grupo, propósito, estados, prioridade. Mostre ao usuário uma lista compacta; confirme antes de gastar créditos de imagem.

S2 Plano de design + bíblia + 3 direções (portão humano). Primeiro escreva um plano de design de 10 linhas por direção (references/design-craft.md seção 2) e revise-o contra os padrões genéricos. Em seguida, escreva a bíblia (references/design-bible-template.md) como três alternativas curtas (humor diferente, lógica de paleta, tipo, linguagem de forma). Cada bíblia nomeia a cor do texto em cada cor preenchida (on-primary, on-accent, texto de badge) e a barra de status da plataforma (Android: hora à esquerda, ícones à direita; iOS: estilo 9:41). Antes de renderizar, coloque a paleta de cada direção em um pequeno arquivo de tokens e execute scripts/contrast_check.py nele: uma direção que só fica boa com contraste falho não deve chegar à escolha humana. Escreva cada prompt em prompts/<id>.<direction>.md primeiro e envie exatamente o texto desse arquivo (o prompt salvo é o reproduzível). Renderize uma tela herói por direção (web: a mesma página, desktop e mobile). Agrupe todas as três em uma única chamada Codex. Pare e deixe o usuário escolher - bom gosto é a única coisa que scripts não podem julgar, então aqui é onde o humano decide. Registre a escolha em DESIGN.md.

S3 Tokens. A partir da direção escolhida, escreva tokens.json (cores claro/escuro, escala de tipo, grade de espaçamento 4/8, raio, elevação, tamanho de ícone, alvo de toque). Execute ``scripts/contrast_check.py tokens.json`

Individual skills in this repo

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

screenshot-to-compose

Turn app design screenshots (JPG/PNG, often AI-generated) or Figma frames into a native Kotlin Jetpack Compose UI that matches them, design-first. Measures pixels and colours (px to dp), writes screen/asset inventories and a design system with observed vs inferred values, builds Iconify icons into VectorDrawables, generates artwork instead of cropping the screenshots, implements MVI screens, then compares emulator or Roborazzi renders against the reference. Use whenever the user supplies screenshots, mockups or a design repository and wants them built as an Android Compose app, says "make this screen in Compose", "match the design", "px to dp", "screenshot to code", or wants a whole app UI built design-first, even if they never say "Compose".

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