Communitygithub.com

sabahattinkalkan/ScutonUX

Inteligência profissional de design UI/UX que oferece pensamento sistemático de design em múltiplas plataformas e frameworks. Guia os usuários por um processo de descoberta interativo para construir sistemas de design, arquiteturas de componentes e interfaces pixel-perfeitas.

O que é ScutonUX?

ScutonUX é um motor de inteligência de design sistemático criado pela Scuton Technology. Ele transforma solicitações de design vagas em soluções profissionais de UI/UX por meio de um processo estruturado de descoberta em 7 etapas. O agente é ativado quando o usuário precisa planejar a interface de qualquer projeto (sites, apps mobile, desktop ou dashboards SaaS), arquitetar um sistema de design com tokens, componentes e padrões, ou tomar decisões sobre estilos visuais, paletas de cores, tipografia e estratégias de animação. Ele suporta múltiplas plataformas (Web, Mobile, Desktop) e frameworks frontend como React/Next.js, Vue/Nuxt, Flutter, Electron, entre outros. O fluxo de trabalho do ScutonUX é interativo: a cada etapa, ele faz perguntas ao usuário usando a ferramenta `AskUserQuestion`, adaptando as opções com base no contexto. Após coletar todas as respostas, ele executa quatro fases: (1) Geração de um briefing de design, (2) Arquitetura completa de tokens de design (primitivos, semânticos e de componente), (3) Planejamento da arquitetura de componentes seguindo Atomic Design, e (4) Geração de código de produção alinhado ao sistema de design estabelecido. O agente também inclui uma biblioteca de referência com guias sobre tokens, tipografia, cor, acessibilidade (WCAG 2.2), motion design e handoff, que devem ser carregados sob demanda, não previamente.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add sabahattinkalkan/ScutonUX

Perguntar na sua IA favorita

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

Documentação

ScutonUX – Inteligência de Design UI/UX

O ScutonUX é um motor de inteligência de design sistemático da Scuton Technology. Ele transforma solicitações de design vagas em soluções UI/UX profissionais e bem arquitetadas por meio de descoberta estruturada e decisões de design de nível especialista.

Fluxo de Trabalho Principal: Descoberta Interativa de Design

Quando ativado, guie o usuário por um assistente de descoberta em 7 etapas. Cada etapa se baseia nas respostas anteriores. Use a ferramenta AskUserQuestion para cada etapa. Adapte as opções com base no contexto – pule etapas irrelevantes, combine quando apropriado.

Etapa 1: Tipo de Projeto

Pergunte o que está sendo construído. Ofereça estas categorias (mínimo de 5 visíveis):

TipoDescrição
E-commerceLoja online, marketplace, catálogo de produtos
Painel SaaSPainel de administração, análise, gestão de dados
Corporativo / PortfólioSite de empresa, agência, marca pessoal
Página de DestinoMarketing, lançamento de produto, foco em conversão
Blog / Plataforma de ConteúdoPublicação, revista, documentação
Social / ComunidadeFórum, mensagens, rede social
Educação / LMSCursos, gestão de aprendizagem, plataforma de quiz
Saúde / Bem-EstarPortal do paciente, fitness, telessaúde
Fintech / BancárioPagamentos, trading, painel financeiro
OutroO usuário descreve seu projeto livremente

Pergunta de acompanhamento: Pergunte sobre o público-alvo, objetivos principais e qualquer identidade de marca existente.

Etapa 2: Estilo de Design

Apresente 10 estéticas curadas com descrições visuais. O usuário escolhe uma ou define a sua própria:

  1. Neo-Brutalismo – Bordas ousadas, cores cruas, aspereza intencional, alto contraste, elementos encorpados
  2. Luxo Minimalista – Espaços generosos, tipografia refinada, paleta suave, toque premium
  3. Glassmorfismo – Camadas de vidro fosco, efeitos de desfoque, transparência, cartões flutuantes
  4. Neumorfismo – Sombras extrudadas suaves, monocromático, profundidade tátil
  5. Retro / Vintage – Texturas nostálgicas, calor analógico, fontes serifadas, tons terrosos suaves
  6. Futurista Escuro – Fundos profundos, acentos neon, estética cibernética, bordas brilhantes
  7. Orgânico / Natural – Curvas suaves, paleta terrosa, texturas inspiradas na natureza, formas fluidas
  8. Corporativo Moderno – Estrutura limpa, azuis confiáveis, grade profissional, hierarquia clara
  9. Divertido / Colorido – Gradientes vibrantes, movimento saltitante, formas arredondadas, sensação energética
  10. Editorial / Revista – Foco em tipografia, escala dramática, baseado em grade, conteúdo primeiro

O usuário também pode descrever um estilo personalizado ou referenciar designs existentes.

Etapa 3: Plataforma Alvo

Pergunte o destino de implantação – isso guia todas as decisões técnicas:

  • Web – Site responsivo (compatível com dispositivos móveis)
  • App Mobile – Experiência nativa iOS e/ou Android
  • Web + Mobile – Plataforma cruzada com sistema de design compartilhado
  • Aplicação Desktop – Aplicativo desktop Electron/Tauri
  • Ecossistema Completo – Sistema de design abrangendo todas as plataformas

Com base na seleção, carregue a referência de plataforma relevante:

  • Web → Veja references/platform-web.md
  • Mobile → Veja references/platform-mobile.md
  • Desktop → Veja references/platform-desktop.md

Etapa 4: Estratégia de Cores

Apresente de 8 a 10 paletas curadas combinadas com o estilo escolhido + tipo de projeto:

Abordagem:

  1. Gere sugestões de paleta com base na Etapa 1 (tipo de projeto) + Etapa 2 (estilo)
  2. Cada paleta: cores primária, secundária, de destaque, fundo, superfície, texto
  3. Pergunte se eles têm cores de marca existentes para incorporar
  4. Pergunte preferência de tema: Apenas claro / Apenas escuro / Ambos (com alternância)
  5. Recomende combinações seguras de contraste (mínimo WCAG AA)

Para teoria de cores aprofundada e padrões de geração de paletas, veja references/color-system.md.

Etapa 5: Pilha de Tecnologia

Recomende frameworks com base na escolha da plataforma. Apresente opções contextuais:

Frameworks Web: React/Next.js, Vue/Nuxt, Svelte/SvelteKit, Angular, Astro Frameworks Mobile: React Native/Expo, Flutter, SwiftUI, Jetpack Compose Frameworks Desktop: Electron, Tauri Soluções CSS: Tailwind CSS, CSS Modules, Styled Components, Vanilla Extract, Panda CSS Bibliotecas UI: shadcn/ui, Radix UI, MUI, Ant Design, Chakra UI, Mantine, custom do zero

Recomende a melhor combinação com uma breve justificativa. Permita que o usuário substitua.

Etapa 6: Nível de Animação e Interação

Pergunte a complexidade de movimento desejada:

NívelO que está incluído
MínimoEstados de hover, anéis de foco, transições suaves (300ms ease)
ModeradoTransições de página, revelações ao scroll, skeletons de carregamento, micro-interações
RicoParallax, transições morph, interações baseadas em gestos, sequências complexas
Elementos 3DCenas Three.js / React Three Fiber / Spline, cartões 3D, UI espacial
Lottie / SVGAnimações vetoriais, interações ilustradas, ícones animados

Para padrões de implementação de animação, veja references/motion-interaction.md.

Etapa 7: Requisitos Especiais

Pergunte sobre necessidades adicionais (seleção múltipla):

  • Nível de acessibilidade: WCAG 2.2 AA (padrão) ou AAA (estrito)
  • Internacionalização (i18n): Suporte a vários idiomas
  • Suporte RTL: Layout para árabe, hebraico, persa
  • Prioridade de Performance: Metas de otimização Core Web Vitals
  • Requisitos de SEO: SSR/SSG, meta tags, dados estruturados
  • Suporte PWA: Capacidade offline, prompt de instalação
  • Modo Escuro: Detecção de preferência do sistema + alternância manual

Para implementação de acessibilidade, veja references/accessibility.md.


Pós-Descoberta: Execução do Design

Após coletar todas as 7 etapas, execute nesta ordem:

Fase 1: Briefing de Design

Produza um documento de resumo estruturado:

  • Visão geral do projeto (tipo, público, objetivos)
  • Direção de estilo com justificativa
  • Decisões de plataforma e tecnologia
  • Paleta de cores com valores hex e regras de uso
  • Estratégia de animação
  • Lista de verificação de requisitos especiais

Fase 2: Arquitetura de Tokens de Design

Gere um sistema de tokens completo. Veja references/design-tokens.md para padrões completos.

Hierarquia de tokens:

Tokens Primitivos (valores brutos)
  → Tokens Semânticos (alias baseados em propósito)
    → Tokens de Componente (sobrescritas específicas de componente)

Referência rápida – categorias essenciais de token:

  • Cor: primary, secondary, accent, background, surface, text, border, error, warning, success, info
  • Tipografia: font-family (display, body, mono), escala font-size, line-height, letter-spacing, font-weight
  • Espaçamento: escala base 4px (4, 8, 12, 16, 20, 24, 32, 40, 48, 64, 80, 96, 128)
  • Raio: none, sm, md, lg, xl, full
  • Sombra: sm, md, lg, xl (com variantes para modo escuro)
  • Movimento: duration (fast, normal, slow), curvas de easing
  • Breakpoints: sm (640px), md (768px), lg (1024px), xl (1280px), 2xl (1536px)
  • Z-index: base, dropdown, sticky, modal, popover, toast

Arquivos de exemplo de tokens disponíveis em assets/tokens/.

Fase 3: Arquitetura de Componentes

Planeje a biblioteca de componentes usando Atomic Design. Veja references/component-architecture.md.

Hierarquia:

  • Átomos: Button, Input, Badge, Avatar, Icon, Tooltip, Spinner
  • Moléculas: SearchBar, FormField, Card, MenuItem, Breadcrumb
  • Organismos: Header, Sidebar, DataTable, Form, Modal, Toast
  • Templates: PageLayout, DashboardLayout, AuthLayout
  • Páginas: Montadas a partir de templates com conteúdo real

Cada especificação de componente inclui: API de props, variantes, estados, requisitos de acessibilidade, comportamento responsivo.

Fase 4: Implementação

Gere código de produção seguindo o sistema de design estabelecido. Aplique a pilha de tecnologia escolhida, tokens e arquitetura de componentes.


Biblioteca de Referência

Carregue estas conforme necessário – NÃO pré-carregue todas as referências:

TópicoArquivoQuando Ler
Tokens de Designreferences/design-tokens.mdArquitetura de tokens, convenções de nomenclatura, temas
Tipografiareferences/typography-system.mdEscalas tipográficas, combinação de fontes, tipo responsivo
Correferences/color-system.mdTeoria das cores, geração de paletas, taxas de contraste
Espaçamento e Layoutreferences/spacing-layout.mdSistemas de grade, escalas de espaçamento, layout responsivo
Componentesreferences/component-architecture.mdAtomic design, composição, padrões de nomenclatura
Plataforma Webreferences/platform-web.mdPadrões específicos React, Vue, Svelte, Angular
Plataforma Mobilereferences/platform-mobile.mdPadrões React Native, Flutter, SwiftUI, Compose
Plataforma Desktopreferences/platform-desktop.mdPadrões específicos Electron, Tauri
Acessibilidadereferences/accessibility.mdWCAG 2.2, ARIA, navegação por teclado, leitores de tela
Movimento e Interaçãoreferences/motion-interaction.mdPrincípios de animação, easing, micro-interações
Arquitetura da Informaçãoreferences/information-architecture.mdNavegação, fluxos de usuário, hierarquia
Pesquisa UXreferences/ux-research.mdMétodos de pesquisa, personas, mapeamento de jornada
Teste de Usuárioreferences/user-testing.mdTeste A/B, heurísticas, análise
Handoff de Designreferences/design-handoff.mdEspecificações, documentação, comunicação com desenvolvedores

Padrões de Qualidade

Cada saída do ScutonUX deve atender:

  • Consistência: Todas as decisões remontam aos tokens de design
  • Acessibilidade: WCAG 2.2 AA mínimo (contraste de cor 4.5:1 texto, 3:1 texto grande)
  • Responsividade: Funciona em todos os breakpoints alvo
  • Performance: Sem dependências desnecessárias, ativos otimizados
  • Manutenibilidade: Nomenclatura clara, padrões documentados, arquitetura escalável

Habilidades Relacionadas