Oil UI
Guia de agente · Claude Code

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.

Oil UIPROMuseu Qingya · Luz & Vaso

Ajudar visitantes a descobrir datas, galerias e peças de Luz & Vaso e agendar a visita.

Vasos de celadon à beira de um lago ao entardecer
MUSEU QINGYAEXPOSIÇÃO DE OUTONO

Luz
& Vaso.

2026.11.14 — 2027.02.28Galeria 02
SelecionadoClique para ver isolado · tamanho real
01

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.

Museu QingyaLuz & Vaso · Outono

CADERNODA LUZ

Celadon e linho sob luz filtrada por salgueiros

Luz na água.
Luz no barro.

Uma exposição sobre vasos do cotidiano e luz natural.

11.14 — 02.28Galeria 02
SelecionadoClique para ver isolado · tamanho real
02

Caderno da manhã

Abra um caderno de exposição: uma grade de jornal reúne luz da manhã, vasos e detalhes da visita.

Museu Qingya

Névoa matinal.
Luz serena.

Aparelho de chá em celadon ao lado de uma janela enevoada
11.14 — 02.28Galeria 02
SelecionadoClique para ver isolado · tamanho real
03

Janela enevoada

Enquadre a pintura em uma janela aberta de papel. O celadon e a água pálida ganham espaço para respirar.

Instale a Oil UI Skill gratuita e de código aberto para Claude Code
npx skills add oil-oil/oil-ui

Ou envie diretamente para o Claude Code: "Instale esta Skill para mim: execute npx skills add oil-oil/oil-ui".

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.

Prompt único vs. Claude Code com a Oil UI Skill
EtapaPrompt único no Claude CodeFluxo Claude Code + Oil UI
Ponto de partidaRecorre a grades genéricas de cards SaaS e paletas segurasParte da categoria do produto, tarefa do usuário e conteúdo real
Escolha de direçãoSaída única; exige refazer o prompt do zero se não encaixarPágina comparativa integrada lado a lado em 1440px ou 390px
Dados e textoFrequentemente inventa porcentagens falsas e selos de preenchimentoConstrói hierarquia em torno de campos reais do domínio e remove excesso visual
Verificação de qualidadePara assim que o código compilaInicia 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.

  1. 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-ui
  2. Garanta 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).

  3. 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.
Modelo reutilizável de prompt de UI para Claude Code
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 →
Oil UI Pro

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 →
Copiar prompt de instalação do Pro
npx github:oil-oil/oil-cli install oil-ui-pro

Perguntas 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.

Guias relacionados

Guia de design de UI no Codex ↗Comparação de direções lado a lado ↗Revisão às cegas em tela real ↗