Communitygithub.com

UI/UX Pro Max - Inteligência de Design

Inteligência de design UI/UX. 50 estilos, 21 paletas, 50 pares 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 administrativo, e-commerce, SaaS, portfólio, blog, app mobile, .html, .tsx, .vue, .svelte. Elementos: botão, modal, navbar, barra lateral, card, tabela, formulário, gráfico. Estilos: glassmorfismo, claymorfismo, minimalismo, brutalismo, neumorfismo, grade bento, modo escuro, responsivo, esqueumorfismo, design plano. Tópicos: paleta de cores, acessibilidade, animação, layout, tipografia, pares de fontes, espaçamento, hover, sombra, gradiente. Integrações: MCP shadcn/ui para busca de componentes e exemplos.

O que é UX Pro Max - Inteligência de Design?

UI/UX Pro Max é uma habilidade de inteligência de design abrangente para agentes de IA como Claude Code, Cursor e Codex que atua como um assistente de design de interface do usuário e experiência do usuário. Ela fornece um banco de dados pesquisável com mais de 50 estilos, 97 paletas de cores, 57 pares de fontes, 99 diretrizes de UX e 25 tipos de gráficos em 9 stacks de tecnologia. A habilidade opera em plataformas baseadas em terminal e guia o usuário por um fluxo de trabalho estruturado: analisar requisitos, gerar um sistema de design completo com o sinalizador `--design-system`, complementar com pesquisas de domínio detalhadas e aplicar diretrizes específicas de stack. Ela suporta a persistência de sistemas de design para recuperação hierárquica entre sessões, permitindo que o agente mantenha uma Fonte Única da Verdade com substituições por página. Projetada para desenvolvedores e designers, esta habilidade garante que cada projeto (seja um site, SaaS, aplicativo móvel ou painel) siga as melhores práticas de acessibilidade, desempenho, layout responsivo e consistência visual, com integração com shadcn/ui MCP para busca de componentes e exemplos.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agent/skills/ui-ux-pro-max

Perguntar na sua IA favorita

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

Documentação

O que UX Pro Max - Inteligência de Design faz?

Guia de design abrangente para aplicações web e mobile. Contém 50+ estilos, 97 paletas de cores, 57 pares 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 quando:

  • Projetar novos componentes ou páginas de UI
  • Escolher paletas de cores e tipografia
  • Revisar código quanto a 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 - Razã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 de no mínimo 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 perto do problema
  • cursor-pointer - Adicione cursor-pointer a elementos clicáveis

3. Desempenho (ALTO)

  • image-optimization - Use WebP, srcset, carregamento preguiçoso
  • 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 de fonte mínimo de 16px para texto do corpo no mobile
  • 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 - 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 de tabela para acessibilidade

Como Usar

Pesquise domínios específicos usando a ferramenta 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 Esta Habilidade

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

Passo 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, divertido, profissional, elegante, modo escuro, etc.
  • Indústria: saúde, fintech, jogos, educação, etc.
  • Stack: React, Vue, Next.js, ou padrão para html-tailwind

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

Sempre comece com --design-system para obter recomendações abrangentes com raciocínio:

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 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"

Passo 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 Única 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 design-system/MASTER.md exclusivamente

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 da página existir, priorize suas regras.
Caso contrário, use as regras Mestre exclusivamente.
Agora, gere o código...

Passo 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áficochart--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"

Passo 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/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ínioUse paraExemplos de Palavras-chave
productRecomendações de tipo de produtoSaaS, e-commerce, portfólio, saúde, beleza, serviço
styleEstilos de UI, cores, efeitosglassmorfismo, minimalismo, modo escuro, brutalismo
typographyPares de fontes, Google Fontselegante, divertido, 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, 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, desempenho, padrões
nextjsSSR, roteamento, imagens, rotas de API
vueComposition API, Pinia, Vue Router
svelteRunes, stores, SvelteKit
swiftuiViews, Estado, Navegação, Animação
react-nativeComponentes, Navegação, Listas
flutterWidgets, Estado, Layout, Temas
shadcnComponentes shadcn/ui, temas, formulários, padrões
jetpack-composeComposables, Modificadores, Elevação de Estado, Recombinação

Fluxo de Trabalho de Exemplo

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

Passo 1: Analisar Requisitos

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

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

Passo 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 de tipografia alternativa, se necessário
python3 skills/ui-ux-pro-max/scripts/search.py "elegant luxury serif" --domain typography

Passo 4: Diretrizes de Stack

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

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


Formatos de Saída

O sinalizador --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 palavras-chave - "dashboard SaaS saúde" > "app"
  2. Pesquise várias vezes - Palavras-chave diferentes revelam insights diferentes
  3. Combine domínios - Estilo + Tipografia + Cor = Sistema de design completo
  4. Sempre verifique UX - Pesquise "animação", "z-index", "acessibilidade" para problemas comuns
  5. Use o sinalizador 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 pouco profissional:

Ícones e Elementos Visuais

RegraFaçaNão Faça
Sem ícones de 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 tamanhos de ícone diferentes aleatoriamente

Interação e Cursor

RegraFaçaNão Faça
Cursor pointerAdicione cursor-pointer a todos os cards clicáveis/hoveráveisDeixe 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 instantâneas de estado 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) no 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 a top-0 left-0 right-0
Preenchimento de conteúdoConsidere a altura fixa da navbarDeixe o conteúdo se esconder atrás de elementos fixos
Largura máxima consistenteUse o mesmo max-w-6xl ou max-w-7xlMisture larguras de contêiner diferentes

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), 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 no modo claro tem contraste suficiente (4,5:1 no mínimo)
  • Elementos de vidro/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 oculto atrás de navbars fixas
  • Responsivo em 375px, 768px, 1024px, 1440px
  • Nenhuma rolagem horizontal no mobile

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

Individual skills in this repo

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

ulasalyesil/personal-website-v2

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

ulasalyesil/personal-website-v2

Conduct design interviews, generate five distinct UI variations in a temporary design lab, collect feedback, and produce implementation plans. Use when the user wants to explore UI design options, redesign existing components, or create new UI with multiple approaches to compare.

ulasalyesil/personal-website-v2

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

ulasalyesil/personal-website-v2

Design and implement microinteractions, motion design, transitions, and user feedback patterns. Use when adding polish to UI interactions, implementing loading states, or creating delightful user experiences.

ulasalyesil/personal-website-v2

This skill is for interface design — dashboards, admin panels, apps, tools, and interactive products. NOT for marketing design (landing pages, marketing sites, campaigns).

ulasalyesil/personal-website-v2

Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.

ulasalyesil/personal-website-v2

Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns.

ulasalyesil/personal-website-v2

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

ulasalyesil/personal-website-v2

Enforces an opinionated UI baseline to prevent AI-generated interface slop.

ulasalyesil/personal-website-v2

Build modern, composable, and accessible React UI components following the components.build specification. Use when creating, reviewing, or refactoring component libraries, design systems, or any reusable UI components. Triggers on tasks involving component APIs, composition patterns, accessibility, styling systems, or TypeScript props.

ulasalyesil/personal-website-v2

Ship correct, complete metadata.

ulasalyesil/personal-website-v2

Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on source code — never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to implement.

ulasalyesil/personal-website-v2

Defines the product's objects, relationships, states, and vocabulary independently of any interface — the most load-bearing layer

ulasalyesil/personal-website-v2

Maps domain concepts, terminology conflicts, and bounded contexts — produces a noun harvest for the conceptual model layer

ulasalyesil/personal-website-v2

Maps interaction structure and flow — produces breadboard notation with edge cases, failure paths, and open decisions

ulasalyesil/personal-website-v2

Framework orientation for Layers of Product Design — load this first; provides the context all other skills depend on

ulasalyesil/personal-website-v2

User research planning and synthesis at the observed behaviour layer — produces candidate job stories with confidence ratings

ulasalyesil/personal-website-v2

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

ulasalyesil/personal-website-v2

Connects user opportunities to business outcomes and solution bets — produces a strategy tree and prioritised experiments

ulasalyesil/personal-website-v2

Audits existing surface against lower-layer decisions and produces a surface decision inventory — vocabulary, object consistency, completeness, feedback, hierarchy, accessibility

Habilidades Relacionadas