Communitygithub.com

ulasalyesil/personal-website-v2

Conduza entrevistas de design, gere cinco variações distintas de UI em um laboratório de design temporário, colete feedback e produza planos de implementação. Use quando o usuário quiser explorar opções de design de UI, redesenhar componentes existentes ou criar novas UIs com múltiplas abordagens para comparar.

O que é personal-website-v2?

Esta skill implementa um fluxo de trabalho completo de exploração de design: entrevista, geração de variações, coleta de feedback, refinamento, pré-visualização e finalização. Ela é útil para desenvolvedores e designers que desejam explorar opções de design de UI de forma sistemática, comparar múltiplas abordagens e obter feedback interativo antes de implementar. A skill suporta plataformas como Next.js, Vite, Remix, Nuxt e Astro, e detecta automaticamente o sistema de estilização (Tailwind CSS, Material UI, Chakra UI, etc.) e o gerenciador de pacotes do projeto. Ela cria um laboratório de design temporário (`.claude-design/`) com cinco variações de UI baseadas em diferentes eixos de design, coleta feedback através de um sistema de overlay interativo e, ao final, gera um plano de implementação detalhado. É crucial que todos os arquivos temporários sejam deletados ao final do processo, seja por confirmação do usuário ou cancelamento.

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

Perguntar na sua IA favorita

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

Documentação

Skill de Laboratório de Design

Esta skill implementa um fluxo de trabalho completo de exploração de design: entrevista, gerar variações, coletar feedback, refinar, pré-visualizar e finalizar.

CRÍTICO: Comportamento de Limpeza

Todos os arquivos temporários DEVEM ser deletados quando o processo terminar, seja por:

  • Usuário confirmar o design final → limpeza, depois gerar plano
  • Usuário abortar/cancelar → limpeza imediata, nenhum plano gerado

Nunca deixe .claude-design/ ou rotas __design_lab para trás. Se o usuário disser "cancelar", "abortar", "parar" ou "deixa pra lá" em qualquer ponto, confirme e então delete todos os artefatos temporários.


Fase 0: Detecção de Pré-voo

Antes de iniciar a entrevista, detecte automaticamente:

Gerenciador de Pacotes

Verifique arquivos de lock na raiz do projeto:

  • pnpm-lock.yaml → use pnpm
  • yarn.lock → use yarn
  • package-lock.json → use npm
  • bun.lockb → use bun

Detecção de Framework

Verifique arquivos de configuração:

  • next.config.js ou next.config.mjs ou next.config.ts → Next.js
    • Verifique diretório app/ → App Router
    • Verifique diretório pages/ → Pages Router
  • vite.config.js ou vite.config.ts → Vite
  • remix.config.js → Remix
  • nuxt.config.js ou nuxt.config.ts → Nuxt
  • astro.config.mjs → Astro

Detecção de Sistema de Estilização

Verifique dependências do package.json e arquivos de configuração:

  • tailwind.config.js ou tailwind.config.ts → Tailwind CSS
  • @mui/material em dependências → Material UI
  • @chakra-ui/react em dependências → Chakra UI
  • antd em dependências → Ant Design
  • styled-components em dependências → styled-components
  • @emotion/react em dependências → Emotion
  • Arquivos .css ou .module.css → CSS Modules

Verificação de Memória de Design

Procure por arquivo de Memória de Design existente:

  • docs/design-memory.md
  • DESIGN_MEMORY.md
  • .claude-design/design-memory.md

Se encontrado, leia e use para preencher valores padrão e pular perguntas redundantes.

Inferência de Estilo Visual (CRÍTICO)

NÃO use estilos predefinidos/genéricos. Extraia a linguagem visual do projeto:

Se Tailwind detectado, leia tailwind.config.js ou tailwind.config.ts:

// Extraia e use:
theme.colors      // Paleta de cores
theme.spacing     // Escala de espaçamento
theme.borderRadius // Valores de borda
theme.fontFamily  // Tipografia
theme.boxShadow   // Sistema de elevação

Se Variáveis CSS existirem, leia globals.css, variables.css ou definições :root:

:root {
  --color-*     /* Tokens de cor */
  --spacing-*   /* Tokens de espaçamento */
  --font-*      /* Tokens de tipografia */
  --radius-*    /* Tokens de raio de borda */
}

Se biblioteca de UI detectada (MUI, Chakra, Ant), leia a configuração do tema:

  • MUI: theme.ts ou chamada createTheme()
  • Chakra: theme/index.ts ou chamada extendTheme()
  • Ant: prop de tema do ConfigProvider

Sempre escaneie componentes existentes para entender padrões:

  • Encontre 2-3 botões existentes → anote seus padrões de estilo
  • Encontre 2-3 cards existentes → anote padding, bordas, sombras
  • Encontre formulários existentes → anote estilos de input, posição de labels
  • Encontre tipografia existente → anote tamanhos de heading, texto corporal

Armazene estilos inferidos no Brief de Design para uso consistente em todas as variantes.


Fase 1: Entrevista

Use a ferramenta AskUserQuestion para todas as etapas da entrevista. Adapte perguntas com base na Memória de Design, se existir.

Passo 1.1: Escopo & Alvo

Faça estas perguntas (pode combinar em um único AskUserQuestion com múltiplas perguntas):

Pergunta 1: Escopo

  • Cabeçalho: "Escopo"
  • Pergunta: "Estamos projetando um único componente ou uma página completa?"
  • Opções:
    • "Componente" - Um elemento de UI reutilizável (botão, card, formulário, modal, etc.)
    • "Página" - Um layout de página ou tela completo

Pergunta 2: Novo ou Redesign

  • Cabeçalho: "Tipo"
  • Pergunta: "Isso é um novo design ou um redesign de algo existente?"
  • Opções:
    • "Novo" - Criando algo do zero
    • "Redesign" - Melhorando um componente/página existente

Se "Redesign" selecionado, pergunte: Pergunta 3: Caminho Existente

  • Cabeçalho: "Localização"
  • Pergunta: "Qual é o caminho do arquivo ou rota da UI existente?"
  • Opções: (deixe o usuário fornecer via "Outro")

Se o alvo não estiver claro, proponha um nome baseado nos padrões do repositório e confirme.

Passo 1.2: Pontos Problemáticos & Inspiração

Pergunta 1: Pontos Problemáticos

  • Cabeçalho: "Problemas"
  • Pergunta: "Quais são os principais pontos problemáticos com o design atual (ou o que este novo design deve evitar)?"
  • Opções:
    • "Muito poluído/denso" - Sobrecarga de informação, difícil de escanear
    • "Hierarquia pouco clara" - Ações primárias não são óbvias
    • "Experiência mobile ruim" - Não funciona bem em telas pequenas
    • "Aparência desatualizada" - Parece antigo ou inconsistente com a marca
  • multiSelect: true

Pergunta 2: Inspiração Visual

  • Cabeçalho: "Estilo visual"
  • Pergunta: "Quais produtos ou marcas devo referenciar para inspiração visual?"
  • Opções:
    • "Stripe" - Limpo, minimalista, confiável
    • "Linear" - Denso, focado em teclado, voltado para desenvolvedores
    • "Notion" - Flexível, focado em conteúdo, divertido
    • "Apple" - Premium, espaçoso, refinado
  • multiSelect: true

Pergunta 3: Inspiração Funcional

  • Cabeçalho: "Interações"
  • Pergunta: "Quais padrões de interação devo emular?"
  • Opções:
    • "Edição inline" - Editar no local sem modais
    • "Divulgação progressiva" - Mostrar mais conforme necessário
    • "Atualizações otimistas" - Feedback instantâneo, sincronizar em segundo plano
    • "Atalhos de teclado" - Eficiência para usuários avançados

Passo 1.3: Direção de Marca & Estilo

Pergunta 1: Adjetivos da Marca

  • Cabeçalho: "Tom da marca"
  • Pergunta: "Quais 3-5 adjetivos descrevem a sensação desejada da marca?"
  • Opções:
    • "Minimalista" - Limpo, simples, sem poluição
    • "Premium" - Alto padrão, polido, refinado
    • "Divertido" - Alegre, amigável, acessível
    • "Utilitário" - Funcional, eficiente, direto ao ponto
  • multiSelect: true

Pergunta 2: Densidade

  • Cabeçalho: "Densidade"
  • Pergunta: "Qual densidade de informação você prefere?"
  • Opções:
    • "Compacto" - Mais informação visível, espaçamento mais apertado
    • "Confortável" - Espaçamento equilibrado, fácil escaneamento
    • "Espaçoso" - Espaço em branco generoso, atenção focada

Pergunta 3: Modo Escuro

  • Cabeçalho: "Modo escuro"
  • Pergunta: "O modo escuro é necessário?"
  • Opções:
    • "Sim" - Deve suportar modo escuro
    • "Não" - Apenas modo claro
    • "Bom ter" - Suporte se for fácil, não obrigatório

Passo 1.4: Persona & Jobs-to-be-Done

Pergunta 1: Usuário Principal

  • Cabeçalho: "Usuário"
  • Pergunta: "Quem é o usuário final principal?"
  • Opções:
    • "Desenvolvedor" - Técnico, orientado a teclado
    • "Designer" - Visual, orientado a detalhes
    • "Usuário de negócios" - Focado em eficiência, menos técnico
    • "Consumidor final" - Público geral, habilidade técnica variada

Pergunta 2: Contexto

  • Cabeçalho: "Contexto"
  • Pergunta: "Qual é o contexto de uso principal?"
  • Opções:
    • "Desktop primeiro" - Usado principalmente em telas grandes
    • "Mobile primeiro" - Usado principalmente em celulares
    • "Ambos igualmente" - Deve funcionar bem em todos os dispositivos

Pergunta 3: Tarefas Principais

  • Cabeçalho: "Tarefas principais"
  • Pergunta: "Quais são as 3 principais tarefas que os usuários devem concluir?"
  • (Deixe o usuário fornecer via "Outro" - isso é aberto)

Passo 1.5: Restrições

Pergunta 1: Elementos a Manter

  • Cabeçalho: "Manter"
  • Pergunta: "Existem elementos que devem ser preservados?"
  • Opções:
    • "Cópias/rótulos existentes" - Manter texto atual
    • "Campos/inputs atuais" - Manter estrutura do formulário
    • "Estrutura de navegação" - Manter navegação atual
    • "Nenhum" - Livre para mudar tudo

Pergunta 2: Restrições Técnicas

  • Cabeçalho: "Restrições"
  • Pergunta: "Alguma restrição técnica?"
  • Opções:
    • "Sem novas dependências" - Usar apenas bibliotecas existentes
    • "Usar componentes existentes" - Construir sobre o sistema de design atual
    • "Deve ser acessível (WCAG)" - Requisitos estritos de acessibilidade
    • "Nenhuma" - Sem restrições especiais
  • multiSelect: true

Fase 2: Gerar Brief de Design

Após a entrevista, crie um Brief de Design estruturado como JSON e salve em .claude-design/design-brief.json:

{
  "scope": "componente|pagina",
  "isRedesign": true|false,
  "targetPath": "src/components/Exemplo.tsx",
  "targetName": "Exemplo",
  "painPoints": ["Muito denso", "Ação primária pouco clara"],
  "inspiration": {
    "visual": ["Stripe", "Linear"],
    "functional": ["Validação inline"]
  },
  "brand": {
    "adjectives": ["minimalista", "confiável"],
    "density": "confortável",
    "darkMode": true
  },
  "persona": {
    "primary": "Desenvolvedor",
    "context": "desktop-first",
    "keyTasks": ["Finalizar checkout", "Revisar pedido", "Aplicar desconto"]
  },
  "constraints": {
    "mustKeep": ["campos existentes"],
    "technical": ["sem novas dependências", "acessível WCAG"]
  },
  "framework": "nextjs-app",
  "packageManager": "pnpm",
  "stylingSystem": "tailwind"
}

Exiba um resumo ao usuário antes de prosseguir.


Fase 3: Gerar Laboratório de Design

Estrutura de Diretórios

Crie todos os arquivos dentro de .claude-design/:

.claude-design/
├── lab/
│   ├── page.tsx                 # Página principal do laboratório (específica do framework)
│   ├── variants/
│   │   ├── VariantA.tsx
│   │   ├── VariantB.tsx
│   │   ├── VariantC.tsx
│   │   ├── VariantD.tsx
│   │   └── VariantE.tsx
│   ├── components/
│   │   └── LabShell.tsx         # Wrapper de layout do laboratório
│   ├── feedback/                # Sistema de feedback interativo
│   │   ├── types.ts             # Interfaces TypeScript
│   │   ├── selector-utils.ts    # Identificação de elementos
│   │   ├── format-utils.ts      # Formatação de feedback
│   │   ├── FeedbackOverlay.tsx  # Componente principal de overlay
│   │   └── index.ts             # Exportações do módulo
│   └── data/
│       └── fixtures.ts          # Dados mock compartilhados
├── design-brief.json
└── run-log.md

Configuração do Sistema de Feedback (CRÍTICO - NUNCA PULAR)

O FeedbackOverlay é a característica PRINCIPAL do Laboratório de Design. Sem ele, os usuários não podem fornecer feedback interativo. NUNCA gere um Laboratório de Design sem o FeedbackOverlay.

Estratégia de Confiabilidade: Para evitar problemas de caminho de importação em diferentes configurações de projeto, crie o FeedbackOverlay diretamente no diretório da rota (por exemplo, app/design-lab/FeedbackOverlay.tsx), NÃO em .claude-design/. Isso garante que uma importação relativa simples (./FeedbackOverlay) sempre funcione.

Arquivos Necessários no Diretório da Rota:

app/design-lab/           # ou app/__design_lab/ se underscores funcionarem
├── page.tsx              # Página principal do laboratório com variantes
└── FeedbackOverlay.tsx   # Componente de overlay autocontido (copie dos templates)

Fonte do Template: design-and-refine/templates/feedback/FeedbackOverlay.tsx

Por que esta abordagem:

  • Caminhos de .claude-design/ podem falhar devido a configurações do bundler
  • Importações relativas do mesmo diretório sempre funcionam
  • O diretório da rota é deletado durante a limpeza de qualquer maneira

Integração de Rota

Next.js App Router: Crie app/__design_lab/page.tsx que importa de .claude-design/lab/

Next.js Pages Router: Crie pages/__design_lab.tsx que importa de .claude-design/lab/

Vite React:

  • Se React Router existir: adicione rota para /__design_lab
  • Se não houver roteador: crie uma renderização condicional em App.tsx baseada no parâmetro de consulta ?design_lab=true

Outros frameworks: Crie a rota temporária mais apropriada para o framework detectado.

Diretrizes de Geração de Variantes

IMPORTANTE: Leia DESIGN_PRINCIPLES.md para melhores práticas de UX, interação e movimento. Mas NÃO use estilos visuais predefinidos—inferi-los do projeto.

Aplique princípios universais (de DESIGN_PRINCIPLES.md):

  • UX: Heurísticas de Nielsen, redução de carga cognitiva, divulgação progressiva
  • Comportamento do componente: Estados de botão, anatomia de formulário, estrutura de card
  • Interação: Padrões de feedback, tratamento de estado, atualizações otimistas
  • Movimento: Timing (150-300ms), easing (entradas ease-out, saídas ease-in)
  • Acessibilidade: Estados de foco, padrões ARIA, alvos de toque (mín. 44px)

Inferir estilos visuais do projeto:

  • Cores → do config do Tailwind, variáveis CSS ou componentes existentes
  • Tipografia → de headings existentes, texto corporal no código-fonte
  • Espaçamento → da escala de espaçamento do projeto ou padrões existentes
  • Raio de borda → de cards, botões, inputs existentes
  • Sombras → de componentes elevados existentes

Cada variante DEVE explorar um eixo de design diferente. Não crie variações menores—faça-as significativamente distintas. Use a linguagem visual existente do projeto para todas as variantes.

Variante A: Foco na Hierarquia da Informação

  • Reestruturar hierarquia de conteúdo (o que é mais importante?)
  • Aplicar proximidade Gestalt—agrupar itens relacionados mais próximos
  • Uma ação primária por visualização
  • Usar a escala de tipografia existente para criar níveis claros

Variante B: Exploração de Modelo de Layout

  • Tentar uma abordagem de layout diferente (card vs lista vs tabela vs painel dividido)
  • Aplicar anatomia de card ou padrões de comportamento de tabela do DESIGN_PRINCIPLES
  • Considerar comportamento responsivo em cada ponto de quebra
  • Usar o sistema de grid/layout existente do projeto

Variante C: Variação de Densidade

  • Se o brief disser "confortável", tente uma versão mais compacta
  • Se o brief disser "compacto", tente uma versão mais espaçosa
  • Usar os tokens de espaçamento existentes do projeto—apenas aplicá-los de forma diferente
  • Mostrar os trade-offs: mais dados visíveis vs escaneamento mais fácil

Variante D: Modelo de Interação

  • Padrão de interação diferente (modal vs inline vs painel vs gaveta)
  • Aplicar padrões de feedback: imediato → progresso → conclusão
  • Implementar todos os estados necessários (carregamento, erro, vazio, desabilitado)
  • Considerar atualizações otimistas para ações não destrutivas

Variante E: Direção Expressiva

  • Avançar na direção da marca que o usuário descreveu na entrevista
  • Explorar diferentes usos dos tokens de design existentes do projeto
  • Mais ou menos uso de sombras, bordas, cores de fundo
  • Aplicar movimento onde adiciona significado (hover, foco, transições)

Requisitos da Página do Laboratório

A página do Laboratório de Design deve incluir:

  1. Cabeçalho com:

    • Resumo do Brief de Design (alvo, escopo, requisitos principais)
    • Instruções para revisão
  2. Grade de Variantes com:

    • Rótulos claros (A, B, C, D, E)
    • Breve justificativa para cada variante ("Por que isso existe")
    • A variante realmente renderizada

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

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

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