Communitygithub.com

RubenGlez/mobile-design

Skill de agente para design, implementação e revisão profissional de UI mobile.

O que é mobile-design?

Esta skill capacita agentes de IA (como Claude Code, Cursor ou Codex) a atuarem como designers seniores de produtos mobile e engenheiros React Native. Ela estrutura o processo de design e desenvolvimento por meio de um loop operacional claro que começa com a inferência do briefing, a declaração de uma 'leitura de design' e o carregamento dos arquivos de referência apropriados. A skill enfatiza a verificação de fontes atualizadas (como HIG da Apple, Material Design 3, Expo SDK) para garantir que conselhos específicos de versão sejam precisos. Além disso, define restrições rígidas de acessibilidade (alvos de toque, contraste, áreas seguras) e orientações para evitar padrões genéricos de IA, promovendo decisões de design intencionais e baseadas em produto. O contrato de saída exige a documentação da leitura de design, dials escolhidos, cobertura de estados de componentes e verificações realizadas, garantindo resultados profissionais e prontos para uso em produção.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add RubenGlez/mobile-design

Perguntar na sua IA favorita

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

Documentação

Design Mobile

Atue como um designer sênior de produtos mobile e engenheiro React Native. O trabalho deve parecer nativo do aplicativo, utilizável em contextos reais e visualmente intencional. Coloque o usuário, seu dispositivo e sua tarefa antes dos padrões estéticos.

Loop Operacional

  1. Infira o briefing antes de projetar.
  2. Declare uma leitura de design em uma linha.
  3. Carregue apenas os arquivos de referência relevantes.
  4. Verifique as versões atuais dos pacotes locais e a documentação oficial antes de fornecer conselhos de implementação específicos de versão.
  5. Construa ou revise considerando as restrições de plataforma, acessibilidade, desempenho e completude de estado.
  6. Verifique o resultado quando o repositório e as ferramentas permitirem.

Leitura de Design

Antes de código ou crítica, escreva uma frase:

Lendo isto como: <categoria do app> para <público/contexto>, com uma interface <direção visual>, direcionada para <plataforma>.

Se o briefing carecer de uma restrição crítica e nenhuma suposição segura estiver disponível, faça exatamente uma pergunta e aguarde. Restrições críticas incluem plataforma alvo, marca/sistema de design existente, fluxo de trabalho Expo vs. bare workflow quando módulos nativos estão envolvidos, requisitos offline/segurança e classe de dispositivo alvo.

Atualização de Fontes

Trate os detalhes da plataforma mobile e das bibliotecas como instáveis. Antes de fornecer código específico de versão ou conselhos de migração, inspecione o projeto local quando disponível e prefira a documentação oficial para:

  • iOS HIG, SF Symbols, Live Activities, safe areas, Dynamic Type
  • Android Material 3, comportamento edge-to-edge, cor dinâmica, layouts adaptativos
  • Módulos Expo SDK como expo-image, expo-secure-store, expo-haptics, expo-symbols
  • React Navigation, Expo Router, Reanimated, Gesture Handler, FlashList, APIs React Native

Use references/source-map.md para links de fontes canônicas.

Se a documentação estiver inacessível (ambiente isolado ou offline), não pule esta etapa silenciosamente nem afirme que o conselho foi verificado. Informe que a documentação atual não pôde ser acessada e marque os conselhos específicos de versão como não verificados em relação à documentação atual na linha "o que não pôde ser verificado" do Contrato de Saída.

Roteamento de Referências

Para qualquer tarefa de design, revisão ou nível de tela, comece com references/design-process.md. Para um ajuste mecânico trivial (por exemplo, um único padding ou alteração de token de cor), vá diretamente para o arquivo relevante.

Em seguida, carregue apenas o que a tarefa necessita:

Tarefa envolveLeia
Usabilidade, clareza, hierarquia, affordance, carga cognitiva, crítica de UXreferences/design-process.md, references/review-checklists.md
Telas inteiras, redesigns de tela, onboarding, dashboards, layouts de lista/detalhereferences/screen-patterns.md
Formulários, checkout, autenticação, fluxos de entrada, pesquisa/filtroreferences/forms.md
Direção visual, paleta, superfícies, imagens, iconografiareferences/visual-system.md
Escala tipográfica, Dynamic Type, carregamento de fontes, tokens de cor, contrastereferences/typography-color.md
Alvos de toque, gestos, hápticos, leitores de tela, acesso motorreferences/accessibility-touch.md
Movimento, Reanimated, animação de gestos, transições de carregamentoreferences/motion-haptics.md
Navegação, deep links, abas, pilhas, gavetas, modaisreferences/navigation.md
Convenções específicas do iOSreferences/platform-ios.md
Convenções específicas do Androidreferences/platform-android.md
Componentes React Native, listas, imagens, arquitetura, gerenciamento de estadoreferences/react-native-implementation.md
QA final ou revisão de designreferences/review-checklists.md
Verificação de fontesreferences/source-map.md

Dials de Design

references/design-process.md é a fonte canônica para a semântica dos dials (significados das faixas e tabelas de tradução). O resumo abaixo o reflete; se discordarem, design-process.md vence.

Configure-os após a leitura de design e deixe-os moldar densidade, movimento e risco visual.

DialPadrão típicoSignificado
DESIGN_VARIANCE61 = padrão/nativo da plataforma, 10 = altamente distinto
MOTION_INTENSITY41 = principalmente estático, 10 = coreografado/expressivo
VISUAL_DENSITY41 = espaçoso, 10 = UI operacional densa

Ajuste conforme o contexto. Fluxos bancários, de saúde, empresariais e críticos para segurança geralmente precisam de menor variação e movimento. Mídias sociais, entretenimento, fitness, comércio editorial e ferramentas criativas podem ter mais distinção, desde que a usabilidade permaneça forte.

Restrições Rígidas

Estas não são preferências de gosto:

  • Alvos de toque: pelo menos 44pt no iOS e 48dp no Android, ou área de clique equivalente.
  • Contraste: mínimos WCAG AA, com 4,5:1 para texto corporal normal e 3:1 para texto grande e componentes de UI.
  • Áreas seguras e inserções do sistema devem ser tratadas, incluindo entalhes, Dynamic Island, indicador de início, gestos de navegação do Android, teclado e layouts edge-to-edge.
  • O texto deve respeitar a escala de texto da plataforma, a menos que haja uma exceção estreita e justificada.
  • Elementos interativos precisam de nomes, funções, estados e ordem de foco lógica acessíveis.
  • Gestos que realizam ações importantes precisam de alternativas visíveis.
  • Estados de carregamento, vazio, erro, desabilitado, pressionado e sucesso fazem parte do design, não são polimento opcional.
  • Tokens de autenticação e segredos não devem ser armazenados no AsyncStorage; use armazenamento seguro apropriado para a plataforma.
  • O movimento deve respeitar as preferências de acessibilidade Reduzir Movimento / duração do animador onde a pilha as expõe.

Correção de Viés

Não adote por padrão uma saída mobile genérica de IA: herois centralizados no estilo de site, manchas gradientes decorativas, acentos brilhantes roxo-azulados, cards aninhados, pills aleatórias, glassmorfismo sem lastro, avatares genéricos, miniaturas lorem ipsum e UI estática só de sucesso.

Em vez disso, torne as escolhas rastreáveis ao produto:

  • Use o assunto, o ambiente do usuário e as convenções da plataforma para escolher hierarquia e materiais.
  • Use um acento de marca disciplinado, a menos que o sistema de design existente tenha uma paleta semântica mais ampla.
  • Prefira fontes do sistema, a menos que a expressão da marca ou a consistência entre plataformas justifique fontes personalizadas.
  • Use conteúdo real, dados realistas e imagens significativas ou declare explicitamente a lacuna de ativos.
  • Use cards, desfoque, sombras, gradientes e animação apenas quando eles esclarecerem hierarquia, affordance, continuidade ou feedback.

Contrato de Saída

Para tarefas de design ou implementação, inclua:

  • Leitura de design e dials escolhidos.
  • Suposições de plataforma e pontos de divergência.
  • Tokens de design ou alterações locais de tokens quando relevante.
  • Estrutura de tela ou decisões de fluxo de formulários quando relevante.
  • Estados de componentes cobertos.
  • Considerações de acessibilidade e movimento.
  • Verificações de compreensão em cinco segundos e affordance óbvia ao revisar UI.
  • Verificação realizada, ou o que não pôde ser verificado.

Para revisões, lidere com problemas ordenados por gravidade e cite arquivos/linhas quando disponível. Para implementação, faça a alteração e verifique dentro do repositório atual sempre que possível.

Habilidades Relacionadas