Communitygithub.com

ui-design

Use esta skill antes de projetar, construir ou revisar qualquer tela ou componente de UI, web ou mobile: layout, espaçamento, tipografia, cor, sombras, botões, formulários, cartões, ícones, navegação, imagens, texto, animação, acessibilidade, estados vazio/erro. As regras que toda tela segue estão aqui, com um arquivo de referência por tópico: leia apenas os que sua tarefa tocar.

O que é ui-design?

Esta skill fornece um conjunto completo e prático de regras para design de interfaces de usuário (UI), baseado no livro *UI Design Principles* de Michael Filipiuk (edição 2021). Ela é projetada para agentes de IA que precisam criar, revisar ou modificar telas e componentes de UI, tanto para web quanto para mobile. O conteúdo está organizado em um arquivo principal (SKILL.md) que contém as regras universais e uma pasta `references/` com arquivos detalhados por tópico (como tipografia, cor, botões, formulários, etc.), permitindo que o agente leia apenas o que é relevante para a tarefa. A skill prioriza a reutilização de tokens e componentes existentes do repositório, evitando a criação de conjuntos paralelos. Ela também inclui diretrizes de acessibilidade (como contraste de cores e tamanhos mínimos de alvos de toque) e convenções da indústria, garantindo que as interfaces sejam usáveis, consistentes e acessíveis. As regras são apresentadas de forma direta, com uma ordem de prioridade clara (usabilidade > acessibilidade > consistência > simplicidade > aparência) e uma seção de 'não negociáveis' que cobre espaçamento, tipografia, contraste, tratamento de erros e outros aspectos fundamentais. A skill é ideal para ser usada em conjunto com ferramentas como Claude Code, Cursor ou Codex, fornecendo orientações precisas para a geração e revisão de código de UI, garantindo que o resultado siga boas práticas de design e seja consistente com o sistema de design do projeto.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JuanEliasJabib02/ui-design-skill/tree/HEAD

Perguntar na sua IA favorita

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

Documentação

UI design: regras para construir interfaces

Estas regras foram destiladas do livro UI Design Principles de Michael Filipiuk (edição de 2021). Este arquivo contém as regras que se aplicam a toda tela. references/ (ao lado deste arquivo) contém os detalhes, um arquivo por tópico; leia apenas os arquivos que sua tarefa tocar.

Regras sem uma tag vêm do livro. (WCAG) marca um padrão de acessibilidade que o livro não menciona. (convention) marca um valor comum da indústria adicionado para preencher uma lacuna. (derived) marca um valor calculado com o próprio método do livro. 1 pt no livro = 1 CSS px = 1 iOS pt = 1 Android dp.

O sistema de design do repositório vence

Se o repositório já possui tokens ou um tema (um config do Tailwind, variáveis CSS, um tema shadcn/MUI, uma biblioteca components/ui/), use-os. Esta skill apenas preenche o que eles não definem.

  • Nunca introduza um segundo conjunto de tokens ao lado dos do próprio repositório.
  • Reutilize um componente existente em vez de construir um paralelo.
  • Quando o próprio repositório quebrar uma das regras abaixo (um contraste que falha, um botão de 32 px), mantenha o valor do repositório e reporte o conflito. Não o substitua silenciosamente.

Prioridade quando as regras entram em conflito: usabilidade > acessibilidade > consistência > simplicidade > aparência.

Caminho rápido

  1. Personalidade primeiro: lúdico, neutro ou sério, com base na marca e no público (references/personality-and-copy.md). Nunca seu próprio gosto.
  2. Tokens antes das telas: cores, escala tipográfica e escala de espaçamento, do repositório ou de references/tokens.md. Não use nada fora deles.
  3. Escala de cinza primeiro: acerte hierarquia, layout e espaçamento, depois adicione cor apenas onde ela tem uma função.
  4. Componentes com todos os estados (padrão, hover, pressionado, foco, desabilitado, erro, sucesso), e todos os estados de tela (vazio, carregando, erro, 404).
  5. Antes de relatar como concluído: percorra references/checklist.md para o que você construiu. Se puder tirar um screenshot, verifique o screenshot, não o código.

Inegociáveis

  1. O espaçamento vem da escala. Use uma escala de 4 pt no mobile e uma escala de 8 pt na web. Sem valores de 5, 13 ou 22 px.
  2. O texto do corpo é de 16–17 px. Nunca vá abaixo de 10 px para qualquer texto e prefira 12 px ou mais. Nunca use um peso Light em texto pequeno.
  3. Uma única família tipográfica, uma sans serif por padrão. Use cerca de 5 tamanhos.
  4. Nunca use #000000 para texto ou sombras. Use um cinza escuro matizado como #1F1F1F.
  5. Uma cor primária, aplicada apenas ao que deve se destacar. Se tudo se destaca, nada se destaca.
  6. Contraste: 4.5:1 para texto do corpo e 3:1 para texto grande e partes da UI (WCAG).
  7. Nunca use apenas cor para transmitir significado. Erros, mensagens de sucesso e links também recebem um ícone, texto, peso ou um sublinhado.
  8. Cada alvo de toque ou clique tem pelo menos 44×44, mesmo quando o glifo visível é menor.
  9. Botões têm 40–60 px de altura, com um botão primário por grupo. Quando os botões vêm em pares, o primário vai para a direita. O rótulo diz exatamente o que acontece.
  10. Entradas sempre têm um rótulo visível. Um placeholder sozinho não é um rótulo. Use um formulário de coluna única com validação inline e nunca apague o que o usuário digitou.
  11. As sombras são suaves (grande deslocamento Y, grande desfoque, 5–10% de opacidade) e apenas em elementos interativos ou elevados.
  12. Ícones vêm de um único pacote, em um único estilo, com a mesma espessura de traço e arredondamento. Ícones que não são universalmente conhecidos recebem um rótulo.
  13. Animações dão feedback, duram menos de 1000 ms e são suavizadas (nunca lineares).
  14. Sem Lorem Ipsum. Escreva texto real, curto e humano. Erros dizem como corrigir o problema. Diálogos nomeiam o objeto e a consequência.
  15. Mesma coisa, mesma aparência, mesmo comportamento em todas as telas. Siga os padrões da plataforma para comportamento.

Qual referência ler

A tarefa tocaLeia
Um novo projeto ou tema, escolhendo valorestokens.md (espaçamento, escala tipográfica, papéis de cor, raio, sombra, animação, CSS inicial)
Uma página ou layout de tela, grade, espaçamento, hierarquialayout.md
Estilos de texto, cabeçalhos, parágrafostypography.md
Paleta, modo escuro, sombras, gradientescolor-and-depth.md
Botões e CTAsbuttons.md
Formulários, entradas, selects, checkboxes, validaçãoforms.md
Cartões, listas de itenscards.md
Íconesicons.md
Barra de abas, navegação superior, barra lateral, linksnavigation.md
Fotos, ilustrações, arte de estado vazio e 404imagery.md
Sensação da marca, rótulos de botões, diálogos, erros, tompersonality-and-copy.md
Transições, hover, carregamento, feedbackmotion.md
Contraste, texto alternativo, alvos, legendasaccessibility.md
Componentes para reutilizar, estados, telas vazias/404, um sistema de designsystem-and-states.md
Revisando uma tela concluídachecklist.md

Todos os caminhos estão sob a pasta references/ desta skill.

Habilidades Relacionadas