Design de UI com Claude Code: configuração do Oil UI, prompts e revisão visual
O Claude Code se destaca ao ler a estrutura do repositório, dividir o trabalho em várias etapas e iniciar subagentes. Sem orientação de design, porém, prompts como "crie uma landing page moderna" ainda tendem a gerar gradientes roxos, cards aninhados e selos de KPI inventados. Instalar o Oil UI dá ao Claude Code um fluxo estruturado de design: pesquisar a categoria, comparar direções distintas lado a lado e verificar a página renderizada em viewports reais.
Pontos principais
Ponto-chave 1
Execute npx skills add oil-oil/oil-ui para instalar a Skill gratuita de código aberto no Claude Code sem prender seu projeto a uma biblioteca de componentes específica.
Ponto-chave 2
Comece seu prompt com o produto, público, tarefa principal do usuário, conteúdo real e viewport-alvo (como 1440×900 ou 390×844) em vez de adjetivos vagos de estilo.
Ponto-chave 3
Para páginas novas ou redesigns, peça ao Claude Code para gerar um painel comparativo em HTML com 3 a 4 direções distintas lado a lado antes de escrever estados de produção.
Ponto-chave 4
Use subagentes do Claude Code para revisão visual às cegas e sem contexto em zoom de 100% e 200%, corrigindo problemas de espaçamento, contraste e hierarquia antes da entrega.
Ajudar visitantes a descobrir datas, galerias e peças de Luz & Vaso e agendar a visita.

Luz
& Vaso.
Crepúsculo na água
Deixe o crepúsculo preencher o quadro. Mantenha os vasos próximos e o título serifado em um canto sereno.
CADERNODA LUZ

Luz na água.
Luz no barro.
Uma exposição sobre vasos do cotidiano e luz natural.
Caderno da manhã
Abra um caderno de exposição: uma grade de jornal reúne luz da manhã, vasos e detalhes da visita.
Névoa matinal.
Luz serena.

Janela enevoada
Enquadre a pintura em uma janela aberta de papel. O celadon e a água pálida ganham espaço para respirar.
Por que o Claude Code se beneficia de uma Skill de design dedicada
Quando você pede ao Claude Code uma "interface SaaS limpa e moderna" sem um método definido, o modelo recorre às médias estatísticas dos seus dados de treinamento: um título centralizado com uma pílula no topo, três cards de largura igual abaixo e minigráficos decorativos ou contadores "+24%" no canto. O código compila, mas a interface parece intercambiável com qualquer outra demo de IA.
O Oil UI muda a sequência de trabalho. Em vez de pular direto do prompt para o markup final, o Claude Code estuda o que torna a categoria do produto legível, coloca direções visuais distintas em um único painel comparativo e inspeciona a renderização ao vivo no navegador antes de dar a tarefa por concluída.
| Etapa | Prompt único no Claude Code | Fluxo Claude Code + Oil UI |
|---|---|---|
| Ponto de partida | Recorre a grades genéricas de cards SaaS e paletas seguras | Parte da categoria do produto, tarefa do usuário e conteúdo real |
| Escolha de direção | Saída única; exige refazer o prompt do zero se não encaixar | Página comparativa integrada lado a lado em 1440px ou 390px |
| Dados e texto | Frequentemente inventa porcentagens falsas e selos de preenchimento | Constrói hierarquia em torno de campos reais do domínio e remove excesso visual |
| Verificação de qualidade | Para assim que o código compila | Inicia um subagente às cegas para criticar capturas de página inteira e recortes a 200% |
Configuração em três etapas
Você pode instalar o Oil UI globalmente na sua conta de usuário ou localmente dentro de um repositório para que todo o time compartilhe o mesmo fluxo de trabalho.
Execute o instalador da Skill e selecione o Claude Code
Rode o comando abaixo no terminal e siga o prompt interativo para escolher o Claude Code e o escopo de instalação desejado.
npx skills add oil-oil/oil-uiGaranta que um navegador local consiga renderizar e capturar páginas
A revisão visual exige capturas reais em vez de suposições a partir do código-fonte. Garanta que o Playwright ou sua automação local de navegador abra o servidor de desenvolvimento em 1440×900 (desktop) e 390×844 (mobile).
Faça upgrade para o Oil UI Pro quando precisar da cobertura completa do fluxo
Se você comprou o Oil UI Pro, instale-o via CLI. Com o Pro instalado, você não precisa manter a Skill de código aberto instalada em paralelo.
npx github:oil-oil/oil-cli install oil-ui-pro
Como escrever prompts de UI de alto sinal para o Claude Code
Observe os trabalhos feitos com Claude na galeria — como Margins (leitor de e-books para tablet por Claude Opus 5.5), Echo (assistente de voz por Claude Opus 5.5), Pickup (app de corridas por Claude Sonnet 5.5) e Pinch Checkout (módulo de checkout por Claude Sonnet 5.5). Cada prompt declara quem é o usuário, qual interação sustenta a peça e quais estados precisam funcionar.
- Informe o usuário e a tarefa em linguagem direta
- Em vez de pedir um "app de mobilidade elegante", especifique "um fluxo de corridas em 390×844 cobrindo confirmação do pino de embarque, chegada do motorista ao vivo e alteração de destino no meio da viagem".
- Nomeie a interação principal
- Diga ao Claude Code qual controle ou transição mais importa: o recálculo ao vivo do preço quando um cupom é aplicado, a gaveta de anotações em um leitor de textos longos ou a resposta de forma de onda em um assistente de voz.
- Defina viewports e estados concretos
- Liste as dimensões exatas de viewport e os três ou quatro estados que você quer renderizados para que o agente verifique cada estado em um navegador real.
Use o Oil UI para criar a interface de [tipo de produto, ex.: módulo de checkout para livraria independente].
- Público e tarefa principal: [ex.: leitores revisando itens do carrinho, alternando entre retirada local e entrega, aplicando cupom de desconto e concluindo o pagamento]
- Interação principal e estados: Foque em [interação principal]. Cubra [Estado 1: formulário padrão], [Estado 2: recálculo ao vivo de frete e desconto] e [Estado 3: erro de validação inline no cartão e recuperação].
- Restrições: Mantenha nossa stack tecnológica atual. Alvo de 1440×900 no desktop e responsivo até 390px de largura.
Proponha primeiro direções de design distintas para podermos compará-las antes de refinar a direção escolhida.Substitua os campos entre colchetes pelos detalhes reais do seu domínio e cole no Claude Code.
Executando revisões às cegas com subagentes em capturas reais
Um agente que acabou de escrever 600 linhas de CSS raramente percebe quando dois rótulos se sobrepõem ou quando o texto secundário perde contraste. O Oil UI resolve isso fazendo o agente principal capturar telas da página ao vivo e entregá-las a um novo subagente do Claude Code sem nenhum conhecimento da implementação.
O revisor inspeciona capturas de página inteira em 100%, recortes a 200% de controles densos e imagens com texto borrado que expõem layouts pesados no topo ou monótonos. O agente principal corrige os defeitos apontados antes de apresentar o resultado a você.
Exemplos funcionais e prompts da galeria
Explorar coleção →Quando migrar da Skill gratuita para o Oil UI Pro
A Skill gratuita leva uma página nova do zero a um design nítido. Migre para o Oil UI Pro ($19.99 pagamento único) quando usar o Claude Code para renovar apps em produção, construir workspaces desktop densos ou executar polimento profundo às cegas opcional de até 3 rodadas com percursos de tarefa com contagem de cliques.
Explorar o Oil UI Pro →npx github:oil-oil/oil-cli install oil-ui-proPerguntas frequentes
O Oil UI prende o Claude Code ao React, Tailwind ou alguma biblioteca de UI específica?
Não. O Oil UI fornece métodos de design, critérios de layout e etapas de verificação visual. O Claude Code escreve markup e estilos dentro da sua stack atual, seja Next.js, Vue, Svelte, HTML/CSS puro ou um design system interno.
Como Claude Opus e Claude Sonnet se comparam ao usar o Oil UI?
O Opus costuma tomar decisões mais fortes em escala tipográfica, ritmo e hierarquia editorial ao longo de páginas inteiras. O Sonnet é mais rápido e funciona muito bem para módulos focados, conclusão de estados e expansão de uma direção já estabelecida.
Posso passar uma captura de referência para o Claude Code seguir ou adaptar?
Sim. Informe o caminho da imagem e diga se quer uma recriação fiel por diferença de pixels ou se quer apenas adotar o clima tipográfico e o espaçamento para o conteúdo do seu próprio produto. O Oil UI inclui fluxos dedicados para ambos.
Como sei que o Claude Code está aplicando o Oil UI de fato?
Inclua "Use Oil UI" no seu prompt. Em vez de despejar código genérico sem estilo imediatamente, o Claude Code vai enquadrar a tarefa do usuário, propor direções visuais distintas ou abrir um painel comparativo e inspecionar capturas renderizadas antes de finalizar.



