Communitygithub.com

ulasalyesil/personal-website-v2

Esta habilidade é para design de interfaces — painéis de controle, painéis administrativos, aplicativos, ferramentas e produtos interativos. NÃO é para design de marketing (landing pages, sites de marketing, campanhas).

O que é personal-website-v2?

Esta skill é focada em design de interfaces com arte e consistência, destinada a painéis de controle, painéis administrativos, aplicativos SaaS, ferramentas, páginas de configuração e interfaces de dados. Ela não se aplica a landing pages, sites de marketing ou campanhas. O problema central que a skill aborda é a geração genérica de interfaces por IAs, que tendem a seguir padrões predefinidos em vez de criar designs intencionais e específicos para cada produto. A solução proposta é um processo rigoroso que inclui exploração do domínio do produto, definição de uma assinatura visual única, e verificação constante contra padrões genéricos. A skill fornece um mandato para que o desenvolvedor revise seu trabalho antes de apresentá-lo, aplicando testes como o 'teste de troca', 'teste de apertar os olhos', 'teste de assinatura' e 'teste de tokens' para garantir que o design seja artesanal e não genérico. Além disso, a skill cobre fundamentos de arte como camadas sutis, elevação de superfícies, hierarquia de bordas, expressão infinita e arquitetura de tokens, exigindo que cada escolha de design seja justificada com base na intenção do produto.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agent/skills/interface-design

Perguntar na sua IA favorita

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

Documentação

Design de Interface

Construa design de interface com arte e consistência.

Escopo

Use para: Painéis de controle, painéis administrativos, aplicativos SaaS, ferramentas, páginas de configuração, interfaces de dados.

Não use para: Landing pages, sites de marketing, campanhas. Redirecione para /frontend-design.


O Problema

Você gerará saída genérica. Seu treinamento viu milhares de painéis de controle. Os padrões são fortes.

Você pode seguir todo o processo abaixo — explorar o domínio, nomear uma assinatura, declarar sua intenção — e ainda assim produzir um modelo. Cores quentes em estruturas frias. Fontes amigáveis em layouts genéricos. "Sensação de cozinha" que parece com todos os outros aplicativos.

Isso acontece porque a intenção vive na prosa, mas a geração de código puxa dos padrões. A lacuna entre eles é onde os padrões vencem.

O processo abaixo ajuda. Mas o processo sozinho não garante arte. Você tem que se pegar.


Onde os Padrões se Escondem

Os padrões não se anunciam. Eles se disfarçam como infraestrutura — as partes que parecem que só precisam funcionar, não ser projetadas.

Tipografia parece um contêiner. Escolha algo legível, siga em frente. Mas a tipografia não está segurando seu design — ela É seu design. O peso de um título, a personalidade de um rótulo, a textura de um parágrafo. Isso molda como o produto parece antes de alguém ler uma palavra. Uma ferramenta de gestão de padaria e um terminal de negociação podem ambos precisar de "tipo limpo e legível" — mas o tipo que é quente e artesanal não é o tipo que é frio e preciso. Se você está recorrendo à sua fonte usual, você não está projetando.

Navegação parece andaime. Construa a barra lateral, adicione os links, vá para o trabalho real. Mas a navegação não está ao redor do seu produto — ela É seu produto. Onde você está, para onde pode ir, o que mais importa. Uma página flutuando no espaço é uma demonstração de componente, não software. A navegação ensina as pessoas a pensar sobre o espaço em que estão.

Dados parecem apresentação. Você tem números, mostre números. Mas um número na tela não é design. A questão é: o que este número significa para a pessoa que o olha? O que eles farão com ele? Um anel de progresso e um rótulo empilhado mostram "3 de 10" — um conta uma história, o outro preenche espaço. Se você está recorrendo a número-no-rótulo, você não está projetando.

Nomes de tokens parecem detalhe de implementação. Mas suas variáveis CSS são decisões de design. --ink e --parchment evocam um mundo. --gray-700 e --surface-2 evocam um modelo. Alguém lendo apenas seus tokens deve ser capaz de adivinhar qual produto é este.

A armadilha é pensar que algumas decisões são criativas e outras são estruturais. Não existem decisões estruturais. Tudo é design. O momento em que você para de perguntar "por que isso?" é o momento em que os padrões assumem o controle.


Intenção Primeiro

Antes de tocar no código, responda a estas. Não na sua cabeça — em voz alta, para si mesmo ou para o usuário.

Quem é este humano? Não "usuários." A pessoa real. Onde eles estão quando abrem isso? O que está em suas mentes? O que fizeram 5 minutos atrás, o que farão 5 minutos depois? Um professor às 7h com café não é um desenvolvedor depurando à meia-noite não é um fundador entre reuniões com investidores. O mundo deles molda a interface.

O que eles precisam realizar? Não "usar o painel." O verbo. Avaliar estas submissões. Encontrar a implantação quebrada. Aprovar o pagamento. A resposta determina o que lidera, o que segue, o que se esconde.

Como isso deve parecer? Diga em palavras que signifiquem algo. "Limpo e moderno" não significa nada — toda IA diz isso. Quente como um caderno? Frio como um terminal? Denso como uma sala de negociação? Calmo como um aplicativo de leitura? A resposta molda cor, tipo, espaçamento, densidade — tudo.

Se você não consegue responder a estas com especificidades, pare. Pergunte ao usuário. Não adivinhe. Não use o padrão.

Toda Escolha Deve Ser Uma Escolha

Para cada decisão, você deve ser capaz de explicar POR QUÊ.

  • Por que este layout e não outro?
  • Por que esta temperatura de cor?
  • Por que esta face de tipo?
  • Por que esta escala de espaçamento?
  • Por que esta hierarquia de informação?

Se sua resposta é "é comum" ou "é limpo" ou "funciona" — você não escolheu. Você usou o padrão. Padrões são invisíveis. Escolhas invisíveis se acumulam em saída genérica.

O teste: Se você trocasse suas escolhas pelas alternativas mais comuns e o design não se sentisse significativamente diferente, você nunca fez escolhas reais.

Mesmice É Falha

Se outra IA, dada uma solicitação semelhante, produzir substancialmente a mesma saída — você falhou.

Isso não é sobre ser diferente por si só. É sobre a interface emergindo do problema específico, do usuário específico, do contexto específico. Quando você projeta a partir da intenção, a mesmice se torna impossível porque duas intenções não são idênticas.

Quando você projeta a partir de padrões, tudo parece o mesmo porque os padrões são compartilhados.

A Intenção Deve Ser Sistêmica

Dizer "quente" e usar cores frias não é seguir em frente. Intenção não é um rótulo — é uma restrição que molda cada decisão.

Se a intenção é quente: superfícies, texto, bordas, acentos, cores semânticas, tipografia — tudo quente. Se a intenção é densa: espaçamento, tamanho de tipo, arquitetura de informação — tudo denso. Se a intenção é calma: movimento, contraste, saturação de cor — tudo calmo.

Verifique sua saída contra sua intenção declarada. Cada token a reforça? Ou você declarou uma intenção e ainda assim usou o padrão?


Exploração do Domínio do Produto

É aqui que os padrões são pegos — ou não.

Saída genérica: Tipo de tarefa → Modelo visual → Tema Saída artesanal: Tipo de tarefa → Domínio do produto → Assinatura → Estrutura + Expressão

A diferença: tempo no mundo do produto antes de qualquer pensamento visual ou estrutural.

Saídas Obrigatórias

Não proponha nenhuma direção até produzir todas as quatro:

Domínio: Conceitos, metáforas, vocabulário do mundo deste produto. Não funcionalidades — território. Mínimo de 5.

Mundo de cores: Quais cores existem naturalmente no domínio deste produto? Não "quente" ou "frio" — vá para o mundo real. Se este produto fosse um espaço físico, o que você veria? Quais cores pertencem lá que não pertencem em outro lugar? Liste 5+.

Assinatura: Um elemento — visual, estrutural ou de interação — que só poderia existir para ESTE produto. Se você não consegue nomear um, continue explorando.

Padrões: 3 escolhas óbvias para este tipo de interface — visuais E estruturais. Você não pode evitar padrões que não nomeou.

Requisitos de Proposta

Sua direção deve referenciar explicitamente:

  • Conceitos de domínio que você explorou
  • Cores da sua exploração do mundo de cores
  • Seu elemento de assinatura
  • O que substitui cada padrão

O teste: Leia sua proposta. Remova o nome do produto. Alguém conseguiria identificar para que é isso? Se não, é genérico. Explore mais profundamente.


O Mandato

Antes de mostrar ao usuário, olhe para o que você fez.

Pergunte a si mesmo: "Se eles dissessem que isso falta arte, o que eles significariam?"

Aquela coisa que você acabou de pensar — corrija-a primeiro.

Sua primeira saída é provavelmente genérica. Isso é normal. O trabalho é pegá-la antes que o usuário tenha que fazer isso.

As Verificações

Execute estas contra sua saída antes de apresentar:

  • O teste de troca: Se você trocasse a face de tipo pela sua usual, alguém notaria? Se você trocasse o layout por um modelo de painel padrão, pareceria diferente? Os lugares onde a troca não importaria são os lugares onde você usou o padrão.

  • O teste de apertar os olhos: Aperte os olhos. Você ainda consegue perceber hierarquia? Algo está saltando asperamente? A arte sussurra.

  • O teste de assinatura: Você pode apontar cinco elementos específicos onde sua assinatura aparece? Não "a sensação geral" — componentes reais. Uma assinatura que você não pode localizar não existe.

  • O teste de token: Leia suas variáveis CSS em voz alta. Elas soam como se pertencem ao mundo deste produto, ou poderiam pertencer a qualquer projeto?

Se alguma verificação falhar, itere antes de mostrar.


Fundamentos de Arte

Camadas Sutis

Esta é a espinha dorsal da arte. Independentemente da direção, tipo de produto ou estilo visual — este princípio se aplica a tudo. Você mal deve notar o sistema funcionando. Quando você olha para o painel da Vercel, você não pensa "belas bordas." Você apenas entende a estrutura. A arte é invisível — é assim que você sabe que está funcionando.

Elevação de Superfície

Superfícies se empilham. Um dropdown fica acima de um cartão que fica acima da página. Construa um sistema numerado — base, depois níveis crescentes de elevação. No modo escuro, elevação mais alta = ligeiramente mais claro. No modo claro, elevação mais alta = ligeiramente mais claro ou usa sombra.

Cada salto deve ser apenas alguns pontos percentuais de claridade. Você mal consegue ver a diferença isoladamente. Mas quando as superfícies se empilham, a hierarquia emerge. Mudanças sussurrantes e silenciosas que você sente em vez de ver.

Decisões-chave:

  • Barras laterais: Mesmo fundo que a tela, não diferente. Cores diferentes fragmentam o espaço visual em "mundo da barra lateral" e "mundo do conteúdo." Uma borda sutil é separação suficiente.
  • Dropdowns: Um nível acima da superfície pai. Se ambos compartilham o mesmo nível, o dropdown se mistura ao cartão e as camadas são perdidas.
  • Entradas: Ligeiramente mais escuras que seu entorno, não mais claras. Entradas são "inseridas" — recebem conteúdo. Um fundo mais escuro sinaliza "digite aqui" sem bordas pesadas.

Bordas

Bordas devem desaparecer quando você não está procurando por elas, mas serem encontráveis quando você precisa de estrutura. rgba de baixa opacidade se mistura com o fundo — define arestas sem exigir atenção. Bordas hex sólidas parecem ásperas em comparação.

Construa uma progressão — nem todas as bordas são iguais. Bordas padrão, separação mais suave, bordas de ênfase, ênfase máxima para anéis de foco. Combine intensidade com a importância do limite.

O teste de apertar os olhos: Aperte os olhos na interface. Você ainda deve perceber hierarquia — o que está acima do que, onde as seções se dividem. Mas nada deve saltar. Sem linhas ásperas. Sem mudanças de cor bruscas. Apenas estrutura silenciosa.

Isso separa interfaces profissionais de amadoras. Erre isso e nada mais importa.

Expressão Infinita

Cada padrão tem expressões infinitas. Nenhuma interface deve parecer igual.

Uma exibição de métrica poderia ser um número herói, estatística inline, sparkline, medidor, barra de progresso, delta de comparação, crachá de tendência ou algo novo. Um painel poderia enfatizar densidade, espaço em branco, hierarquia ou fluxo de maneiras completamente diferentes. Mesmo barra lateral + cartões tem variações infinitas em proporção, espaçamento e ênfase.

Antes de construir, pergunte:

  • Qual é a ÚNICA coisa que os usuários mais fazem aqui?
  • Quais produtos resolvem problemas semelhantes de forma brilhante? Estude-os.
  • Por que esta interface pareceria projetada para seu propósito, não modelada?

NUNCA produza saída idêntica. Mesma largura da barra lateral, mesma grade de cartões, mesmas caixas de métrica com ícone-esquerda-número-grande-rótulo-pequeno toda vez — isso sinaliza gerado por IA imediatamente. É esquecível.

A arquitetura e os componentes devem emergir da tarefa e dos dados, executados de uma forma que pareça fresca. Os cartões da Linear não se parecem com os da Notion. As métricas da Vercel não se parecem com as da Stripe. Mesmos conceitos, expressões infinitas.

Cor Vive em Algum Lugar

Todo produto existe em um mundo. Esse mundo tem cores.

Antes de pegar uma paleta, passe tempo no mundo do produto. O que você veria se entrasse na versão física deste espaço? Que materiais? Que luz? Que objetos?

Sua paleta deve parecer que veio DE algum lugar — não como se foi aplicada A algo.

Além de Quente e Frio: Temperatura é um eixo. Isso é silencioso ou barulhento? Denso ou espaçoso? Sério ou brincalhão? Geométrico ou orgânico? Um terminal de negociação e um aplicativo de meditação são ambos "focados" — tipos completamente diferentes de foco. Encontre a qualidade específica, não o rótulo genérico.

Cor Carrega Significado: Cinza constrói estrutura. Cor comunica — status, ação, ênfase, identidade. Cor sem motivação é ruído. Uma cor de acento, usada com intenção, vence cinco cores usadas sem pensamento.


Antes de Escrever Cada Componente

Toda vez que você escrever código de UI — mesmo adições pequenas — declare:

Intenção: [quem é este humano, o que eles devem fazer, como deve parecer]
Paleta: [cores da sua exploração — e POR QUE elas se encaixam no mundo deste produto]
Profundidade: [bordas / sombras / camadas — e POR QUE isso se encaixa na intenção]
Superfícies: [sua escala de elevação — e POR QUE esta temperatura de cor]
Tipografia: [sua face de tipo — e POR QUE ela se encaixa na intenção]
Espaçamento: [sua unidade base]

Este ponto de verificação é obrigatório. Isso força você a conectar cada escolha técnica de volta à intenção.

Se você não consegue explicar POR QUÊ para cada escolha, você está usando o padrão. Pare e pense.


Princípios de Design

Arquitetura de Token

Cada cor na sua interface deve traçar de volta a um pequeno conjunto de primitivas: primeiro plano (hierarquia de texto), fundo (elevação de superfície), borda (hierarquia de separação), marca e semântico (destrutivo, aviso, sucesso). Sem valores hex aleatórios — tudo mapeia para primitivas.

Hierarquia de Texto

Não tenha apenas "texto" e "texto cinza." Construa quatro níveis — primário, secundário, terciário, silenciado. Cada um serve um papel diferente: texto padrão, texto de suporte, metadados e desabilitado/placeholder. Use todos os quatro consistentemente. Se você está usando apenas dois, sua hierarquia é muito plana.

Progressão de Bordas

Bordas não são binárias. Construa uma escala que combine intensidade com importância — separação padrão, separação mais suave, ênfase, ênfase máxima. Nem todo limite merece o mesmo peso.

Tokens de Controle

Controles de formulário têm necessidades específicas. Não reutilize tokens de superfície — crie dedicados para fundos de controle, bordas de controle e estados de foco. Isso permite que você ajuste elementos interativos independentemente das superfícies de layout.

Espaçamento

Escolha uma unidade base e mantenha múltiplos. Construa uma escala para diferentes contextos — micro espaçamento para lacunas de ícone, espaçamento de componente dentro de botões e cartões, espaçamento de seção entre grupos, separação maior entre áreas distintas. Valores aleatórios sinalizam nenhum sistema.

Preenchimento

Mantenha simétrico. Se um lado tem um valor, os outros devem corresponder, a menos que o conteúdo naturalmente requeira assimetria.

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

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

UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search 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