Ir para o guia de uso
frontend-ui-engineeringpor Addy Osmani

Frontend UI Engineering Skill.

Uma skill de Claude Code e Codex para UI design: constrói UIs voltadas ao usuário com qualidade de produção, acessíveis e responsivas.

  • Web & UI
  • Código de UI
addyosmani/agent-skills · skills/frontend-ui-engineering/SKILL.mdSKILL.md
--- name: frontend-ui-engineering description: Builds production-quality, accessible, responsive user-facing UIs. Use when building or modifying interfaces and pages, creating components, implementing layouts, meeting WCAG accessibility requirements, managing state, or when the output needs to look and feel production-quality rather than AI-generated. --- ## When to Use ## Component Architecture ## State Management ## Design System Adherence ## Accessibility (WCAG 2.1 AA) ## Responsive Design
Front matter e títulos de seção lidos do arquivo upstream em 2026-09-14 · 10.679 caracteres no total

01 O que faz

O Que o Skill frontend-ui-engineering Faz no Claude Code e Codex

Resumo, fluxo de trabalho e resultados, todos lidos do SKILL.md do skill.

Do SKILL.mdLido em 14/09/2026 · não é uma execução registrada

Nos termos do próprio skill

Constrói interfaces de usuário de qualidade profissional que são acessíveis, performáticas e visualmente refinadas. O skill se concentra em criar UI que parece ter sido construída por um engenheiro com sensibilidade para design em uma empresa de ponta — não algo gerado por uma IA. Ele reforça a aderência real ao design system, acessibilidade adequada conforme WCAG 2.1 AA, padrões de interação bem pensados, e evita clichês estéticos genéricos de IA.

O skill abrange arquitetura de componentes com colocação de arquivos, composição em vez de configuração, gerenciamento de estado desde useState local até stores globais, design responsivo mobile-first testado em breakpoints específicos, navegação por teclado, rótulos ARIA, gerenciamento de foco, estados vazios e de erro significativos, carregamento com skeleton e atualizações otimistas para velocidade percebida.

O que ele produz

  • Estados de carregamento com skeleton usando aria-busy e aria-label para conteúdo em carregamento
  • Estados vazios e de erro significativos com role="status", texto descritivo, ícones e próximos passos acionáveis
Veja o exemplo de prompt ↗

Como funciona

  1. 01
    Colocar os Arquivos do Componente Juntos

    Coloque a implementação do componente, testes, stories, hooks personalizados e types juntos em uma única pasta nomeada de acordo com o componente.

  2. 02
    Componha os Componentes, Não os Configure

    Construa APIs de componentes composáveis com filhos aninhados em vez de objetos de configuração carregados de props.

  3. 03
    Separe a Busca de Dados da Apresentação

    Crie componentes container que lidam com carregamento de dados, erros e estados vazios, e depois passem dados limpos para os componentes de apresentação.

  4. 04
    Escolha o Gerenciamento de Estado pelo Escopo

    Use useState para estado de UI específico do componente, estado elevado para 2-3 componentes irmãos, Context para tema/autenticação/localidade, estado na URL para filtros e paginação, bibliotecas de estado de servidor para dados remotos, e stores globais para estado compartilhado complexo no cliente.

  5. 05
    Siga os Tokens do Design System

    Use tokens de cor semânticos como text-primary e bg-surface em vez de valores hexadecimais brutos, mantenha uma escala de espaçamento consistente em incrementos de 0.25rem e respeite a hierarquia tipográfica.

  6. 06
    Implemente a Acessibilidade WCAG 2.1 AA

    Torne todo elemento interativo acessível por teclado, adicione rótulos ARIA a controles sem rótulo, gerencie o foco quando o conteúdo muda, garanta contraste de 4.5:1 para texto normal e forneça estados vazios e de erro significativos.

02 Encontre o ideal para você

Quando Usar a Skill frontend-ui-engineering

Use a skill frontend-ui-engineering no Claude Code ou Codex quando o trabalho for UI design desse tipo. Adequação e limites abaixo são retirados do próprio arquivo da skill.

Boa Combinação

  • Construir novos componentes ou páginas de UI
  • Modificando interfaces existentes voltadas ao usuário
  • Implementando layouts responsivos
  • Adicionando interatividade ou gerenciamento de estado
  • Corrigindo problemas visuais ou de UX

Conheça os Limites

  • Construir prototipos com a expectativa de que serão reescritos depois
  • Pular a estilização porque o design ainda não é final
  • Adiar o design responsivo para uma fase posterior
  • Tratar a acessibilidade como opcional ou desejável

O Que Fornecer

  • Conteúdo de espaço reservado realistaConteúdo real ou exemplos realistas para revelar problemas de layout que o lorem ipsum esconde (comprimento, quebra de linha, overflow)

03 Dentro da skill

Regras que a skill frontend-ui-engineering dá ao Claude Code e ao Codex

8 instruções concretas, padrões e limites que o SKILL.md define para o agente — a parte do arquivo que muda o resultado.

  1. Evitar Padrões Estéticos de IA

    Não use roxo/índigo em todos os lugares, gradientes excessivos, rounded-2xl em tudo, seções hero genéricas, texto lorem ipsum, padding exagerado em todos os lugares, grades de cards padronizadas ou design carregado de sombras.

  2. Sem Prop Drilling Além de 3 Níveis

    Se você estiver passando props por componentes que não os utilizam, introduza um context ou reestruture a árvore de componentes.

  3. Usar uma Escala de Espaçamento Consistente

    Aplique o espaçamento da escala em incrementos de 0.25rem (ou o que o projeto usar). Não invente valores como 13px ou 2.3rem que não estejam na escala.

  4. Não Pular Níveis de Cabeçalho

    Mantenha a hierarquia semântica de cabeçalhos de h1 (título da página, um por página) a h2 (seção) a h3 (subseção). Não use estilos de cabeçalho para conteúdo que não seja de cabeçalho.

  5. Todo Elemento Interativo Deve Ser Acessível por Teclado

    Use elementos focáveis nativos como button. Se precisar usar div com onClick, adicione role="button", tabIndex={0} e manipuladores onKeyDown/onKeyUp para Enter e Espaço.

  6. Projetar com Prioridade para Mobile

    Construa primeiro para breakpoints mobile e, em seguida, expanda para telas maiores. Teste em 320px, 768px, 1024px e 1440px.

  7. Usar Skeleton Loading, Não Spinners

    Mostre estados de skeleton com aria-busy e aria-label para carregamento de conteúdo. Implemente atualizações otimistas para uma velocidade percebida.

  8. Componentes Não Devem Exceder 200 Linhas

    Divida componentes que crescem além de 200 linhas em unidades menores e mais focadas.

04 Coloque em prática

Instale frontend-ui-engineering no Claude Code ou Codex

Um comando npx skills add, depois uma primeira tarefa no seu agente e uma checklist para o resultado.

Adicione frontend-ui-engineering ao Claude Code, Codex ou Seu Agente

Rode no seu projeto; o instalador pergunta a qual agente adicioná-lo.

Terminal
npx skills add https://github.com/addyosmani/agent-skills --skill frontend-ui-engineering

Formato genérico do CLI skills para skills/frontend-ui-engineering/SKILL.md; o repositório pode documentar seu próprio caminho.

Dê ao Skill uma Primeira Tarefa de Design de UI

Escrito nos próprios termos do skill; substitua as partes entre colchetes pelo seu material.

Starter prompt
Build a TaskList component for [project name] that displays a list of tasks with checkboxes to mark them complete and delete buttons. The component should handle loading, error, and empty states. It should be keyboard accessible, meet WCAG 2.1 AA standards, work responsively from 320px to 1440px, and follow the design system's spacing scale and color tokens. Include a container component that fetches tasks using React Query and a presentation component that receives clean data.

Fonte: escrito a partir do SKILL.md nos próprios termos do skill.

Verifique o Primeiro Resultado

O que o próprio SKILL.md diz sobre como é um resultado correto:

  • Componente renderiza sem erros no console
  • Todos os elementos interativos são acessíveis por teclado ao navegar pela página com Tab
  • Leitor de tela consegue transmitir o conteúdo e estrutura da página
  • O layout responsivo funciona nos breakpoints de 320px, 768px, 1024px e 1440px
  • Os estados de carregamento, erro e vazio são todos tratados
  • Nenhum aviso de acessibilidade no dev tools ou axe-core

No OpenDesign importe frontend-ui-engineering pelo link do SKILL.md: Plugins → Add → Skill → Import from link, depois selecione-o na barra superior.

05 Código aberto, rastreável

Fonte, Licença e Verificação

De onde vêm os fatos desta página e quando foram verificados pela última vez.

Arquivo da skill
skills/frontend-ui-engineering/SKILL.md Checksum de conteúdo registrado na verificação; commit be4e44a
License
MIT De LICENSE.
Estrelas do repositório
94.139 Snapshot do GitHub capturado em 14/09/2026 para todo o repositório addyosmani/agent-skills. Não é uma avaliação ou contagem de uso para frontend-ui-engineering.
Verificado pelo OpenDesign
14/09/2026 Arquivo de origem, caminho, texto da licença e contagem de estrelas foram verificados. Não integrado ao OpenDesign principal (verificado em 28/08/2026); uma execução ao vivo não foi registrada nesta página.

Dentro do SKILL.md

  1. Visão GeralO objetivo é uma UI de qualidade de produção, com aparência de design consciente, não gerada por IA
  2. Quando UsarAo construir ou modificar componentes de UI, páginas, layouts, interatividade, estado, ou corrigir problemas visuais
  3. Arquitetura de componentesMantenha os arquivos próximos, prefira composição a configuração, mantenha os componentes focados, separe dados de apresentação
  4. Gerenciamento de EstadoEscolha a abordagem mais simples: estado local, estado elevado, context, estado de URL, estado de servidor ou store global
  5. Aderência ao Design SystemEvite padrões estéticos de IA, use uma escala de espaçamento consistente, respeite a hierarquia tipográfica, use tokens de cor semânticos
  6. Acessibilidade (WCAG 2.1 AA)Navegação por teclado, rótulos ARIA, gerenciamento de foco, estados vazios e de erro significativos são obrigatórios
  7. Design ResponsivoAbordagem mobile-first, teste nos breakpoints de 320px, 768px, 1024px, 1440px
  8. Carregamento e TransiçõesUse skeleton loading em vez de spinners, implemente atualizações otimistas para velocidade percebida
  9. Racionalizações ComunsContra-argumentos que postergam acessibilidade, design responsivo, estilização, ou aceitam a estética de IA
  10. Sinais de AlertaComponentes com mais de 200 linhas, estilos inline, estados ausentes, sem teste de teclado, indicadores só por cor, aparência de IA
  11. VerificaçãoChecklist para renderização, acesso por teclado, leitor de tela, responsividade, estados, design system, ferramentas de acessibilidade
A Descrição da Própria Skill
"Constrói interfaces de usuário de qualidade de produção, acessíveis e responsivas. Use ao construir ou modificar interfaces e páginas, criar componentes, implementar layouts, atender requisitos de acessibilidade WCAG, gerenciar estado ou quando a saída precisa ter aparência e comportamento de qualidade de produção, em vez de gerada por IA."

Descrição do front-matter de SKILL.md. O arquivo completo tem cerca de 10.679 caracteres. Leia o arquivo completo no GitHub.

06 Antes de instalar

Perguntas Sobre a Skill frontend-ui-engineering

As respostas vêm do SKILL.md conforme lido em 2026-09-14, e não de uma execução registrada.

Quando devo usar Context em vez de uma store global como Zustand?

Use Context para dados com muita leitura e pouca escrita, como tema, autenticação e locale. Use uma store global como Zustand ou Redux para estado complexo compartilhado em todo o app.

Se você está apenas compartilhando estado entre 2-3 componentes irmãos, eleve o estado para o pai comum deles em vez disso. Evite prop drilling além de 3 níveis introduzindo context ou reestruturando a árvore de componentes.

Engenharia de UI Frontend

Execute frontend-ui-engineering em uma tarefa real de design de UI.

Baixe o OpenDesign, importe frontend-ui-engineering a partir do link SKILL.md, cole o prompt acima e leia o plano antes do resultado.

Terminal
npx skills add https://github.com/addyosmani/agent-skills --skill frontend-ui-engineering

OpenDesign Desktop

Um design system. Sua marca consistente em tudo

No Vibe Design Workspace completo, aplique as mesmas regras de marca a sites, apresentações, protótipos interativos, dashboards, imagens e vídeos HTML. Conecte Codex, Claude Code, Cursor e outros agentes de código locais e crie de graça.

  • Sites, apresentações, protótipos, dashboards, imagens e vídeo
  • Mais de 140 design systems e a biblioteca completa de templates e skills
  • Codex local e mais de 21 agentes de código · Grátis
Baixar grátis

Disponível para macOS e Windows