Communitygithub.com

vurakit/agentup

Inteligência de design UI/UX. 50 estilos, 21 paletas, 50 combinações de fontes, 20 gráficos, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Ações: planejar, construir, criar, projetar, implementar, revisar, corrigir, melhorar, otimizar, aprimorar, refatorar, verificar código UI/UX. Projetos: site, landing page, dashboard, painel admin, e-commerce, SaaS, portfólio, blog, app mobile, .html, .tsx, .vue, .svelte. Elementos: botão, modal, navbar, sidebar, card, tabela, formulário, gráfico. Estilos: glassmorphism, claymorphism, minimalismo, brutalism, neumorphism, bento grid, modo escuro, responsivo, skeuomorphism, flat design. Tópicos: paleta de cores, acessibilidade, animação, layout, tipografia, combinação de fontes, espaçamento, hover, sombra, gradiente. Integrações: MCP do shadcn/ui para busca de componentes e exemplos.

O que é agentup?

O skill vurakit/agentup é um guia abrangente de design UI/UX para aplicações web e mobile, projetado para auxiliar desenvolvedores e designers a tomar decisões de design rápidas e informadas. Ele oferece um banco de dados pesquisável com mais de 50 estilos, 97 paletas de cores, 57 combinações de fontes, 99 diretrizes de UX e 25 tipos de gráficos, abrangendo 9 stacks de tecnologia populares como React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind e shadcn/ui. Sua principal funcionalidade é gerar um sistema de design completo e priorizado (via a flag `--design-system`) com base no tipo de produto, palavras-chave de estilo e setor, garantindo consistência visual e boas práticas de acessibilidade, desempenho e interação. O skill também suporta um padrão de persistência hierárquica Mestre + Substituições, salvando as regras de design em `design-system/MASTER.md` e permitindo personalizações por página em `design-system/pages/`. Além disso, oferece buscas detalhadas por domínio (como `style`, `color`, `ux`, `typography`), diretrizes específicas para cada stack e uma lista de verificação de pré-entrega para garantir qualidade visual, interação responsiva, compatibilidade com modos claro/escuro e acessibilidade básica.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/vurakit/agentup/tree/HEAD/skills/frontend

Perguntar na sua IA favorita

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

Documentação

UI/UX Pro Max - Inteligência de Design

Guia abrangente de design para aplicações web e mobile. Contém mais de 50 estilos, 97 paletas de cores, 57 combinações de fontes, 99 diretrizes de UX e 25 tipos de gráficos em 9 pilhas de tecnologia. Banco de dados pesquisável com recomendações baseadas em prioridade.

Quando Aplicar

Consulte estas diretrizes ao:

  • Projetar novos componentes ou páginas de UI
  • Escolher paletas de cores e tipografia
  • Revisar código em busca de problemas de UX
  • Construir landing pages ou dashboards
  • Implementar requisitos de acessibilidade

Categorias de Regras por Prioridade

PrioridadeCategoriaImpactoDomínio
1AcessibilidadeCRÍTICOux
2Toque e InteraçãoCRÍTICOux
3DesempenhoALTOux
4Layout e ResponsivoALTOux
5Tipografia e CorMÉDIOtypography, color
6AnimaçãoMÉDIOux
7Seleção de EstiloMÉDIOstyle, product
8Gráficos e DadosBAIXOchart

Referência Rápida

1. Acessibilidade (CRÍTICO)

  • color-contrast - Proporção mínima de 4,5:1 para texto normal
  • focus-states - Anéis de foco visíveis em elementos interativos
  • alt-text - Texto alternativo descritivo para imagens significativas
  • aria-labels - aria-label para botões com apenas ícone
  • keyboard-nav - Ordem de tabulação corresponde à ordem visual
  • form-labels - Use label com atributo for

2. Toque e Interação (CRÍTICO)

  • touch-target-size - Alvos de toque mínimos de 44x44px
  • hover-vs-tap - Use clique/toque para interações principais
  • loading-buttons - Desabilite o botão durante operações assíncronas
  • error-feedback - Mensagens de erro claras próximas ao problema
  • cursor-pointer - Adicione cursor-pointer a elementos clicáveis

3. Desempenho (ALTO)

  • image-optimization - Use WebP, srcset, carregamento lento
  • reduced-motion - Verifique prefers-reduced-motion
  • content-jumping - Reserve espaço para conteúdo assíncrono

4. Layout e Responsivo (ALTO)

  • viewport-meta - width=device-width initial-scale=1
  • readable-font-size - Tamanho mínimo de 16px para texto do corpo no celular
  • horizontal-scroll - Garanta que o conteúdo caiba na largura da viewport
  • z-index-management - Defina escala de z-index (10, 20, 30, 50)

5. Tipografia e Cor (MÉDIO)

  • line-height - Use 1,5-1,75 para texto do corpo
  • line-length - Limite a 65-75 caracteres por linha
  • font-pairing - Combine personalidades de fonte de título/corpo

6. Animação (MÉDIO)

  • duration-timing - Use 150-300ms para microinterações
  • transform-performance - Use transform/opacity, não width/height
  • loading-states - Telas esqueleto ou spinners

7. Seleção de Estilo (MÉDIO)

  • style-match - Combine estilo ao tipo de produto
  • consistency - Use o mesmo estilo em todas as páginas
  • no-emoji-icons - Use ícones SVG, não emojis

8. Gráficos e Dados (BAIXO)

  • chart-type - Combine tipo de gráfico ao tipo de dado
  • color-guidance - Use paletas de cores acessíveis
  • data-table - Forneça alternativa de tabela para acessibilidade

Como Usar

Pesquise domínios específicos usando a ferramenta de CLI abaixo.


Pré-requisitos

Verifique se o Python está instalado:

python3 --version || python --version

Se o Python não estiver instalado, instale-o com base no SO do usuário:

macOS:

brew install python3

Ubuntu/Debian:

sudo apt update && sudo apt install python3

Windows:

winget install Python.Python.3.12

Como Usar Este Skill

Quando o usuário solicitar trabalho de UI/UX (projetar, construir, criar, implementar, revisar, corrigir, melhorar), siga este fluxo de trabalho:

Etapa 1: Analisar Requisitos do Usuário

Extraia informações-chave da solicitação do usuário:

  • Tipo de produto: SaaS, e-commerce, portfólio, dashboard, landing page, etc.
  • Palavras-chave de estilo: minimalista, lúdico, profissional, elegante, modo escuro, etc.
  • Setor: saúde, fintech, jogos, educação, etc.
  • Stack: React, Vue, Next.js, ou padrão para html-tailwind

Etapa 2: Gerar Sistema de Design (OBRIGATÓRIO)

Sempre comece com --design-system para obter recomendações abrangentes com justificativa:

python3 skills/agentup-frontend/scripts/search.py "<tipo_produto> <setor> <palavras-chave>" --design-system [-p "Nome do Projeto"]

Este comando:

  1. Pesquisa 5 domínios em paralelo (product, style, color, landing, typography)
  2. Aplica regras de raciocínio de ui-reasoning.csv para selecionar as melhores correspondências
  3. Retorna sistema de design completo: padrão, estilo, cores, tipografia, efeitos
  4. Inclui antipadrões a evitar

Exemplo:

python3 skills/agentup-frontend/scripts/search.py "beleza spa bem-estar serviço" --design-system -p "Serenity Spa"

Etapa 2b: Persistir Sistema de Design (Padrão Mestre + Substituições)

Para salvar o sistema de design para recuperação hierárquica entre sessões, adicione --persist:

python3 skills/agentup-frontend/scripts/search.py "<consulta>" --design-system --persist -p "Nome do Projeto"

Isso cria:

  • design-system/MASTER.md — Fonte da Verdade Global com todas as regras de design
  • design-system/pages/ — Pasta para substituições específicas de página

Com substituição específica de página:

python3 skills/agentup-frontend/scripts/search.py "<consulta>" --design-system --persist -p "Nome do Projeto" --page "dashboard"

Isso também cria:

  • design-system/pages/dashboard.md — Desvios específicos de página do Mestre

Como funciona a recuperação hierárquica:

  1. Ao construir uma página específica (ex.: "Checkout"), primeiro verifique design-system/pages/checkout.md
  2. Se o arquivo de página existir, suas regras substituem o arquivo Mestre
  3. Se não existir, use apenas design-system/MASTER.md

Prompt de recuperação sensível ao contexto:

Estou construindo a página [Nome da Página]. Por favor, leia design-system/MASTER.md.
Verifique também se design-system/pages/[nome-da-pagina].md existe.
Se o arquivo de página existir, priorize suas regras.
Se não existir, use exclusivamente as regras do Mestre.
Agora, gere o código...

Etapa 3: Complementar com Pesquisas Detalhadas (conforme necessário)

Após obter o sistema de design, use pesquisas de domínio para obter detalhes adicionais:

python3 skills/agentup-frontend/scripts/search.py "<palavra-chave>" --domain <domínio> [-n <max_resultados>]

Quando usar pesquisas detalhadas:

NecessidadeDomínioExemplo
Mais opções de estilostyle--domain style "glassmorphism dark"
Recomendações de gráficoschart--domain chart "dashboard em tempo real"
Melhores práticas de UXux--domain ux "animação acessibilidade"
Fontes alternativastypography--domain typography "elegante luxo"
Estrutura de landinglanding--domain landing "hero prova-social"

Etapa 4: Diretrizes de Stack (Padrão: html-tailwind)

Obtenha melhores práticas específicas de implementação. Se o usuário não especificar um stack, padrão para html-tailwind.

python3 skills/agentup-frontend/scripts/search.py "<palavra-chave>" --stack html-tailwind

Stacks disponíveis: html-tailwind, react, nextjs, vue, svelte, swiftui, react-native, flutter, shadcn, jetpack-compose


Referência de Pesquisa

Domínios Disponíveis

DomínioUse ParaExemplos de Palavras-chave
productRecomendações de tipo de produtoSaaS, e-commerce, portfólio, saúde, beleza, serviço
styleEstilos de UI, cores, efeitosglassmorphism, minimalismo, modo escuro, brutalism
typographyCombinações de fontes, Google Fontselegante, lúdico, profissional, moderno
colorPaletas de cores por tipo de produtosaas, ecommerce, saúde, beleza, fintech, serviço
landingEstrutura de página, estratégias de CTAhero, hero-centric, depoimento, preços, prova-social
chartTipos de gráfico, recomendações de bibliotecatendência, comparação, linha do tempo, funil, pizza
uxMelhores práticas, antipadrõesanimação, acessibilidade, z-index, carregamento
reactDesempenho React/Next.jswaterfall, bundle, suspense, memo, rerender, cache
webDiretrizes de interface webaria, foco, teclado, semântico, virtualizar
promptPrompts de IA, palavras-chave CSS(nome do estilo)

Stacks Disponíveis

StackFoco
html-tailwindUtilitários Tailwind, responsivo, a11y (PADRÃO)
reactEstado, hooks, desempenho, padrões
nextjsSSR, roteamento, imagens, rotas de API
vueComposition API, Pinia, Vue Router
svelteRunes, stores, SvelteKit
swiftuiViews, State, Navigation, Animation
react-nativeComponentes, Navigation, Lists
flutterWidgets, State, Layout, Theming
shadcnComponentes shadcn/ui, theming, formulários, padrões
jetpack-composeComposables, Modifiers, State Hoisting, Recomposition

Exemplo de Fluxo de Trabalho

Solicitação do usuário: "Fazer landing page para serviço de cuidados com a pele profissional"

Etapa 1: Analisar Requisitos

  • Tipo de produto: Serviço de Beleza/Spa
  • Palavras-chave de estilo: elegante, profissional, suave
  • Setor: Beleza/Bem-estar
  • Stack: html-tailwind (padrão)

Etapa 2: Gerar Sistema de Design (OBRIGATÓRIO)

python3 skills/agentup-frontend/scripts/search.py "beleza spa bem-estar serviço elegante" --design-system -p "Serenity Spa"

Saída: Sistema de design completo com padrão, estilo, cores, tipografia, efeitos e antipadrões.

Etapa 3: Complementar com Pesquisas Detalhadas (conforme necessário)

# Obter diretrizes de UX para animação e acessibilidade
python3 skills/agentup-frontend/scripts/search.py "animação acessibilidade" --domain ux

# Obter opções de tipografia alternativas, se necessário
python3 skills/agentup-frontend/scripts/search.py "elegante luxo serif" --domain typography

Etapa 4: Diretrizes de Stack

python3 skills/agentup-frontend/scripts/search.py "layout responsivo formulário" --stack html-tailwind

Então: Sintetize sistema de design + pesquisas detalhadas e implemente o design.


Formatos de Saída

A flag --design-system suporta dois formatos de saída:

# Caixa ASCII (padrão) - melhor para exibição em terminal
python3 skills/agentup-frontend/scripts/search.py "fintech crypto" --design-system

# Markdown - melhor para documentação
python3 skills/agentup-frontend/scripts/search.py "fintech crypto" --design-system -f markdown

Dicas para Melhores Resultados

  1. Seja específico com palavras-chave - "SaaS dashboard saúde" > "app"
  2. Pesquise várias vezes - Palavras-chave diferentes revelam insights diferentes
  3. Combine domínios - Style + Typography + Color = Sistema de design completo
  4. Sempre verifique UX - Pesquise "animação", "z-index", "acessibilidade" para problemas comuns
  5. Use a flag de stack - Obtenha melhores práticas específicas de implementação
  6. Itere - Se a primeira pesquisa não corresponder, tente palavras-chave diferentes

Regras Comuns para UI Profissional

Estes são problemas frequentemente negligenciados que fazem a UI parecer não profissional:

Ícones e Elementos Visuais

RegraFaçaNão Faça
Sem ícones emojiUse ícones SVG (Heroicons, Lucide, Simple Icons)Use emojis como 🎨 🚀 ⚙️ como ícones de UI
Estados de hover estáveisUse transições de cor/opacidade no hoverUse transformações de escala que deslocam o layout
Logotipos de marca corretosPesquise SVG oficial do Simple IconsAdivinhe ou use caminhos de logotipo incorretos
Tamanho de ícone consistenteUse viewBox fixo (24x24) com w-6 h-6Misture diferentes tamanhos de ícone aleatoriamente

Interação e Cursor

RegraFaçaNão Faça
Cursor pointerAdicione cursor-pointer a todos os cards clicáveis/hoverableDeixe o cursor padrão em elementos interativos
Feedback de hoverForneça feedback visual (cor, sombra, borda)Nenhuma indicação de que o elemento é interativo
Transições suavesUse transition-colors duration-200Mudanças de estado instantâneas ou muito lentas (>500ms)

Contraste Modo Claro/Escuro

RegraFaçaNão Faça
Card glass modo claroUse bg-white/80 ou opacidade maiorUse bg-white/10 (muito transparente)
Contraste de texto claroUse #0F172A (slate-900) para textoUse #94A3B8 (slate-400) para texto do corpo
Texto suave claroUse #475569 (slate-600) mínimoUse gray-400 ou mais claro
Visibilidade da bordaUse border-gray-200 no modo claroUse border-white/10 (invisível)

Layout e Espaçamento

RegraFaçaNão Faça
Navbar flutuanteAdicione espaçamento top-4 left-4 right-4Cole a navbar em top-0 left-0 right-0
Padding de conteúdoConsidere a altura da navbar fixaDeixe o conteúdo esconder atrás de elementos fixos
max-width consistenteUse o mesmo max-w-6xl ou max-w-7xlMisture diferentes larguras de contêiner

Lista de Verificação Pré-Entrega

Antes de entregar o código de UI, verifique estes itens:

Qualidade Visual

  • Nenhum emoji usado como ícone (use SVG)
  • Todos os ícones de um conjunto consistente (Heroicons/Lucide)
  • Logotipos de marca estão corretos (verificados do Simple Icons)
  • Estados de hover não causam deslocamento de layout
  • Use cores do tema diretamente (bg-primary) sem wrapper var()

Interação

  • Todos os elementos clicáveis têm cursor-pointer
  • Estados de hover fornecem feedback visual claro
  • Transições são suaves (150-300ms)
  • Estados de foco visíveis para navegação por teclado

Modo Claro/Escuro

  • Texto em modo claro tem contraste suficiente (4,5:1 mínimo)
  • Elementos glass/transparentes visíveis no modo claro
  • Bordas visíveis em ambos os modos
  • Teste ambos os modos antes da entrega

Layout

  • Elementos flutuantes têm espaçamento adequado das bordas
  • Nenhum conteúdo escondido atrás de navbars fixas
  • Responsivo em 375px, 768px, 1024px, 1440px
  • Sem rolagem horizontal no celular

Acessibilidade

  • Todas as imagens têm texto alternativo
  • Campos de formulário têm rótulos
  • Cor não é o único indicador
  • prefers-reduced-motion respeitado

Habilidades Relacionadas