Communitygithub.com

minicoohei/ai-agent-camp

Guia de design UI/UX. 50 estilos, 97 paletas, 57 combinações de fontes, 9 stacks compatíveis. Ative com solicitações como 'Projete a interface', 'Crie um sistema de design', 'Revise a tela'.

O que é ai-agent-camp?

Este skill oferece um guia abrangente de design de interface do usuário e experiência do usuário (UI/UX) para aplicações web e mobile. Ele contém 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 diferentes. O skill é ativado por palavras-chave como 'UI design', 'UX review', 'design', 'landing page' e 'screen design', e segue um fluxo de trabalho que inclui analisar os requisitos do usuário, gerar um sistema de design completo (com recomendações priorizadas por domínios como acessibilidade, estilo e tipografia), realizar pesquisas detalhadas e fornecer diretrizes específicas de implementação para o stack escolhido (padrão html-tailwind). Ele é útil para desenvolvedores e designers que desejam garantir consistência, acessibilidade e boas práticas em seus projetos, pois oferece desde regras críticas de acessibilidade e interação até opções de estilo e tipografia, além de um sistema de persistência de design system para recuperação hierárquica entre sessões.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/minicoohei/ai-agent-camp/tree/HEAD/skills/ui-ux-pro-max

Perguntar na sua IA favorita

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

Documentação

Palavras-chave de Ativação

"UI design", "UX review", "design", "landing page", "screen design"

Palavras-chave correspondentes:

  • Ações: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check
  • Projetos: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte
  • Elementos: button, modal, navbar, sidebar, card, table, form, chart
  • Estilos: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design
  • Tópicos: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient
  • Integrações: shadcn/ui MCP para busca de componentes e exemplos

UI/UX Pro Max - Design Intelligence

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

Quando Aplicar

Consulte estas diretrizes ao:

  • Projetar novos componentes de UI ou páginas
  • 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
3PerformanceALTOux
4Layout e ResponsividadeALTOux
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 - Mínimo 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 apenas com í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 primárias
  • 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. Performance (ALTO)

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

4. Layout e Responsividade (ALTO)

  • viewport-meta - width=device-width initial-scale=1
  • readable-font-size - Mínimo de 16px para texto do corpo em mobile
  • horizontal-scroll - Garanta que o conteúdo caiba na largura da viewport
  • z-index-management - Defina uma 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 - Corresponda o 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 - Corresponda o tipo de gráfico ao tipo de dado
  • color-guidance - Use paletas de cores acessíveis
  • data-table - Forneça alternativa em tabela para acessibilidade

Como Usar

Pesquise domínios específicos usando a ferramenta de linha de comando 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 (design, build, create, implement, review, fix, improve), siga este fluxo de trabalho:

Etapa 1: Analisar os Requisitos do Usuário

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

  • Tipo de produto: SaaS, e-commerce, portfolio, dashboard, landing page, etc.
  • Palavras-chave de estilo: minimal, playful, professional, elegant, dark mode, etc.
  • Indústria: healthcare, fintech, gaming, education, 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 justificativas:

python3 skills/ui-ux-pro-max/scripts/search.py "<tipo_produto> <indústria> <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 o sistema de design completo: padrão, estilo, cores, tipografia, efeitos
  4. Inclui antipadrões a evitar

Exemplo:

python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service" --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/ui-ux-pro-max/scripts/search.py "<consulta>" --design-system --persist -p "Nome do Projeto"

Isso cria:

  • design-system/MASTER.md — Fonte Global da Verdade 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/ui-ux-pro-max/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 da página em relação ao 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 da página existir, suas regras substituem o arquivo Mestre
  3. Caso contrário, use exclusivamente 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-página].md existe.
Se o arquivo da página existir, priorize suas regras.
Caso contrário, 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/ui-ux-pro-max/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 "real-time dashboard"
Melhores práticas de UXux--domain ux "animation accessibility"
Fontes alternativastypography--domain typography "elegant luxury"
Estrutura de landinglanding--domain landing "hero social-proof"

Etapa 4: Diretrizes do 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/ui-ux-pro-max/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ínioUso paraExemplos de Palavras-chave
productRecomendações de tipo de produtoSaaS, e-commerce, portfolio, healthcare, beauty, service
styleEstilos de UI, cores, efeitosglassmorphism, minimalism, dark mode, brutalism
typographyCombinações de fontes, Google Fontselegant, playful, professional, modern
colorPaletas de cores por tipo de produtosaas, ecommerce, healthcare, beauty, fintech, service
landingEstrutura de página, estratégias de CTAhero, hero-centric, testimonial, pricing, social-proof
chartTipos de gráficos, recomendações de bibliotecastrend, comparison, timeline, funnel, pie
uxMelhores práticas, antipadrõesanimation, accessibility, z-index, loading
reactPerformance React/Next.jswaterfall, bundle, suspense, memo, rerender, cache
webDiretrizes de interface webaria, focus, keyboard, semantic, virtualize
promptPrompts de IA, palavras-chave CSS(nome do estilo)

Stacks Disponíveis

StackFoco
html-tailwindUtilitários Tailwind, responsivo, a11y (PADRÃO)
reactEstado, hooks, performance, padrões
nextjsSSR, roteamento, imagens, rotas de API
vueComposition API, Pinia, Vue Router
svelteRunes, stores, SvelteKit
swiftuiViews, State, Navigation, Animation
react-nativeComponentes, Navegação, Listas
flutterWidgets, Estado, Layout, Temas
shadcnComponentes shadcn/ui, temas, formulários, padrões
jetpack-composeComposables, Modifiers, State Hoisting, Recomposition

Exemplo de Fluxo de Trabalho

Solicitação do usuário: "Làm landing page cho dịch vụ chăm sóc da chuyên nghiệp"

Etapa 1: Analisar Requisitos

  • Tipo de produto: Beauty/Spa service
  • Palavras-chave de estilo: elegant, professional, soft
  • Indústria: Beauty/Wellness
  • Stack: html-tailwind (padrão)

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

python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service elegant" --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/ui-ux-pro-max/scripts/search.py "animation accessibility" --domain ux

# Obter opções alternativas de tipografia, se necessário
python3 skills/ui-ux-pro-max/scripts/search.py "elegant luxury serif" --domain typography

Etapa 4: Diretrizes do Stack

python3 skills/ui-ux-pro-max/scripts/search.py "layout responsive form" --stack html-tailwind

Em seguida: Sintetize o 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/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system

# Markdown - melhor para documentação
python3 skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system -f markdown

Dicas para Melhores Resultados

  1. Seja específico com as palavras-chave - "healthcare SaaS dashboard" > "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 "animation", "z-index", "accessibility" 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 o SVG oficial do Simple IconsAdivinhe ou use caminhos de logotipo incorretos
Tamanho de ícone consistenteUse viewBox fixo (24x24) com w-6 h-6Misture tamanhos de ícone diferentes aleatoriamente

Interação e Cursor

RegraFaçaNão Faça
Cursor pointerAdicione cursor-pointer a todos os cartões clicáveis/com hoverDeixe 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
Cartão glass em 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) no mínimoUse gray-400 ou mais claro
Visibilidade da bordaUse border-gray-200 em 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 a top-0 left-0 right-0
Padding de conteúdoConsidere a altura da navbar fixaDeixe o conteúdo esconder atrás de elementos fixos
Largura máxima consistenteUse o mesmo max-w-6xl ou max-w-7xlMisture larguras de contêiner diferentes

Checklist Pré-Entrega

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

Qualidade Visual

  • Nenhum emoji usado como ícone (use SVG em vez disso)
  • Todos os ícones de conjunto de ícones 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) não 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 (mínimo 4.5:1)
  • Elementos glass/transparentes visíveis em 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 navbar fixa

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Habilidades Relacionadas