Oil UI
Guia de agente · Cursor / Windsurf / IDEs

Usando o Oil UI no Cursor, Windsurf e agentes de código em IDEs

Muitos desenvolvedores constroem e refinam interfaces diretamente dentro do Cursor, Windsurf, Antigravity ou Gemini CLI junto ao código da aplicação. Como o Oil UI usa o formato aberto de Skills, um único comando npx skills add oil-oil/oil-ui equipa esses agentes de IDE com o mesmo fluxo focado na tarefa: explorar direções, implementar estados funcionais na sua stack e verificar capturas renderizadas.

Pontos principais

Um instalador cobre os principais agentes de código

execute npx skills add oil-oil/oil-ui e selecione Cursor, Windsurf, Claude Code ou Codex.

Ponto-chave 2

Ao renovar telas em uma base de código existente, delimite cada prompt a uma única página ou fluxo do usuário e liste props, hooks e rotas que não devem ser tocados.

Ponto-chave 3

Para módulos de UI independentes (uploaders, checkouts, configuradores), peça ao agente para implementar desde o início os estados ocioso, ativo, concluído e de erro.

Ponto-chave 4

Faça o agente da sua IDE abrir o servidor dev local e inspecionar capturas reais em 1440px e 390px em vez de confiar apenas em diffs de código.

Instale a Oil UI Skill gratuita e de código aberto para Cursor, Windsurf e agentes de IDE
npx skills add oil-oil/oil-ui

Suporta tanto instalação no escopo do projeto (compartilhada com seu time) quanto instalação no nível de usuário.

Instalando o Oil UI em agentes de IDE e CLI

Seja trabalhando na barra lateral de agente do Cursor, no Windsurf Cascade, no Antigravity ou em um agente de terminal, o Oil UI fornece o mesmo fluxo de design e os mesmos checklists de revisão visual.

  1. Execute o instalador interativo da Skill

    Rode o comando na raiz do projeto ou no terminal e selecione os agentes de código que você usa no dia a dia.

    npx skills add oil-oil/oil-ui
  2. Use a instalação no escopo do projeto para consistência do time

    Escolher o escopo do projeto coloca a Skill dentro do repositório para que o agente de IDE de cada integrante siga os mesmos padrões de layout e revisão.

  3. Invoque o Oil UI explicitamente no seu prompt

    Comece prompts de UI com "Use Oil UI to design..." ou "Use Oil UI to refresh this screen..." para que o agente execute o fluxo de design em vez de remendar estilos de forma avulsa.

Quatro hábitos para projetar dentro de uma base de código existente

O modo de falha mais comum em um agente de IDE é misturar encanamento de backend e um redesign visual completo em um prompt gigante. Separar responsabilidades mantém código e layout limpos:

Delimite a um módulo isolado ou fluxo de tarefa por vez
Pula apenas um módulo de ponta a ponta — como o módulo de upload de arquivos Chute ou o configurador de teclado mecânico KEEB na galeria — antes de passar às telas vizinhas.
Informe quais hooks de dados e handlers estão fora de limites
Ao atualizar uma tela de produção em React ou Vue, diga ao agente: "Mantenha intactos o estado do formulário, as mutações de API e os parâmetros de rota; reformule apenas o layout, a hierarquia e o feedback de estado."
Compare novas direções em uma rota de rascunho antes de integrar
Se uma página precisa de uma nova direção visual, deixe o agente renderizar 3 opções distintas lado a lado primeiro e depois porte a direção escolhida para seus componentes principais.
Sempre verifique no localhost em larguras desktop e mobile
Antes de aceitar um diff, faça o agente abrir o servidor dev em execução e capturar telas em 1440px e 390px para detectar transbordamento, espaçamento apertado ou contraste quebrado.

Prompt reutilizável para polir módulos no Cursor e Windsurf

Marque o arquivo do componente-alvo no chat da sua IDE e use esta estrutura para obter uma implementação completa com múltiplos estados:

Prompt de agente de IDE para módulos de UI interativos
Use o Oil UI para projetar e implementar [nome do módulo, ex.: nosso módulo de upload e compartilhamento de arquivos / configurador de produto] neste repositório.
- Restrições da base de código: Mantenha intactos os [hooks, props e tipos de API] existentes.
- Estados obrigatórios: Implemente 1) estado ocioso padrão, 2) feedback ativo ao arrastar/inserir dados, 3) progresso e estado concluído (com confirmação de cópia/compartilhamento) e 4) estado de erro de validação ou limite.
- Disciplina visual: Evite invólucros de card dentro de card e pílulas decorativas acima de títulos. Estabeleça hierarquia por escala tipográfica, espaçamento e estados claros de foco, depois verifique no navegador local.

Funciona muito bem ao referenciar seu arquivo de componente existente no Cursor ou Windsurf.

Exemplos funcionais e prompts da galeria

Explorar coleção →
Oil UI Pro

Desbloqueie renovação de projetos existentes e acabamento de componentes com o Oil UI Pro

O Oil UI Pro adiciona fluxos dedicados para bases de código existentes — incluindo diagnóstico anotado de página única, um sistema de renovação em 3 camadas (limpar / evoluir / refazer fluxo + DESIGN.md) e polimento extremo de componente único.

Explorar o Oil UI Pro →
Copiar prompt de instalação do Pro
npx github:oil-oil/oil-cli install oil-ui-pro

Perguntas frequentes

Qual modelo devo escolher no Cursor ou Windsurf ao usar o Oil UI?

Use Claude Opus ou modelos GPT/Codex de fronteira ao explorar novas direções visuais ou reestruturar páginas complexas. Depois que uma direção ou um DESIGN.md estiver definido, Claude Sonnet e modelos mais rápidos funcionam bem para replicar estados em telas irmãs.

O Oil UI funciona junto com shadcn/ui, Radix ou Tailwind?

Sim. Bibliotecas de primitivas fornecem controles acessíveis, enquanto o Oil UI governa composição da página, hierarquia visual, exploração de direções e subtração anti-slop. Eles se complementam perfeitamente.

Como garanto que o agente não quebre handlers de clique ou validação de formulários existentes?

Liste os handlers a preservar no seu prompt e siga a etapa de percurso do Oil UI: clique de fato pelo fluxo principal e provoque um envio inválido no navegador antes de concluir.

Minha equipe pode usar Cursor e Claude Code / Codex no mesmo repositório?

Sim. Selecione todos os agentes relevantes durante npx skills add oil-oil/oil-ui ou faça commit de um DESIGN.md compartilhado para que todas as ferramentas leiam as mesmas regras de design.

Guias relacionados

Guia de design de UI no Claude Code ↗Renovação de UI em projetos existentes ↗Corrigindo UI genérica de IA ↗