Communitygithub.com

wjdgus6480/portfolio

Define o padrão completo de UI/UX e design visual do portfólio de um desenvolvedor individual.

O que é portfolio?

Este skill define um sistema de design completo e rigoroso para portfólios de desenvolvedores (AI, Software, Produto). Ele prioriza uma identidade profissional, moderna, minimalista e técnica, onde o conteúdo e os projetos são os protagonistas, em vez de decorações excessivas. O sistema abrange desde filosofia central e paleta de cores até tipografia, layout, componentes e fluxo de trabalho de implementação, com foco em legibilidade, acessibilidade e responsividade. Suporta plataformas como Next.js, React, TypeScript e Tailwind CSS, e estabelece regras claras para separação de conteúdo/UI, integridade de dados (não inventar projetos ou métricas) e gerenciamento de mudanças, garantindo que o portfólio transmita a imagem de um desenvolvedor que resolve problemas reais com software e IA.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wjdgus6480/portfolio/tree/HEAD/claude/skills/design-theme

Perguntar na sua IA favorita

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

Documentação

Skill de Tema de Design

1. Identidade do Skill

  • Nome: design-theme
  • Propósito: Define o padrão completo de UI/UX e design visual do portfólio de um desenvolvedor individual.
  • Público-alvo: Portfólio de Desenvolvedor AI / Software / Produto
  • Objetivo Principal: Transmitir a impressão de um desenvolvedor que descobre problemas reais e cria produtos usando IA e software, e não apenas um portfólio que lista tecnologias.

2. Filosofia Central de Design

Este portfólio prioriza as seguintes impressões:

  • Profissional
  • Moderno
  • Minimalista
  • Técnico
  • Orientado a Produto
  • Legível
  • Confiável

Princípios Centrais

"O conteúdo e os projetos devem ser os protagonistas, não a decoração."

Ao ver a tela inicial, o usuário deve ser capaz de entender rapidamente:

  1. Quem é a pessoa?
  2. O que ela cria?
  3. Que problemas ela resolve?
  4. Quais projetos ela já fez?
  5. Quais tecnologias ela usa?
  6. Ela é realmente capaz de desenvolver?

3. Direção Visual

Direção Básica

  • Prioridade para o Modo Claro
  • Base em branco limpo / cinza claro
  • Destaque Azul limitado
  • Bordas finas
  • Espaçamento generoso
  • Tipografia forte
  • Grade organizada
  • Decoração excessiva minimizada

Direções a Evitar

Os seguintes designs não devem ser usados por padrão:

  • Gradientes excessivos
  • Brilho intenso
  • Glassmorfismo
  • Efeitos 3D exagerados
  • Animações sem sentido
  • Sombras excessivas
  • Cores de arco-íris
  • Badges em excesso
  • Ilustrações decorativas em demasia
  • Modelos genéricos comuns em portfólios de IA
  • Badges de tecnologia com cores diferentes para cada uma
  • Layouts onde o design chama mais atenção que o conteúdo

4. Sistema de Cores

Base

Background      #FAFAFA
Surface         #FFFFFF
Foreground      #18181B
Text Secondary  #52525B
Text Weak       #71717A
Placeholder     #A1A1AA
Border          #E4E4E7
Background Weak #F4F4F5

Destaque

Accent          #2563EB
Accent Hover    #1D4ED8
Accent Soft     #EFF6FF

A cor de destaque deve ser usada de forma limitada em toda a tela.

Locais de Uso do Destaque

  • CTA Principal
  • Links principais
  • Navegação ativa
  • Estados de foco
  • Informações importantes
  • Status de projeto que precisam de ênfase

Não use a cor de destaque excessivamente como fundo ou decoração em toda a tela.

Status

Success #16A34A
Warning #D97706
Error   #DC2626

As cores de status devem ser usadas apenas para representar estados reais.


5. Tipografia

Prioridade de Fontes

Priorize a legibilidade do coreano.

Ordem recomendada:

Pretendard
system-ui
sans-serif

Para código, nomes de tecnologia, números e metadados, você pode usar:

Geist Mono
monospace

Escala Tipográfica

Hero

Desktop:

56px ~ 72px
font-weight: 700 ~ 800
line-height: 1.05 ~ 1.15

Mobile:

40px ~ 48px
font-weight: 700 ~ 800
line-height: 1.1 ~ 1.2

H2

Desktop:

36px ~ 44px

Mobile:

30px ~ 34px

H3

20px ~ 24px

Corpo

16px ~ 18px
line-height: 1.6 ~ 1.75

Pequeno / Meta

13px ~ 14px

6. Sistema de Layout

Container

Largura máxima padrão:

1200px

Padding Horizontal

Desktop:

32px ~ 48px

Tablet:

24px

Mobile:

20px

Espaçamento entre Seções

Desktop:

120px ~ 160px

Mobile:

80px ~ 100px

Não force o mesmo espaçamento em toda a página. Ajuste o espaçamento de acordo com a importância do conteúdo.


7. Sistema de Grade

A área de projetos deve usar a seguinte estrutura por padrão:

Desktop

2 Colunas

Tablet

2 Colunas

Mobile

1 Coluna

Não use grades com 3 ou mais colunas sem um motivo específico. É mais importante que o conteúdo do cartão do projeto seja legível do que o número de colunas na grade.


8. Cabeçalho

O cabeçalho deve ser uma interface mínima para auxiliar a navegação no portfólio.

Estrutura recomendada:

Logo / Nome
Projetos
Sobre / Abordagem
Contato

Se desejar, você pode adicionar links para Currículo ou GitHub.

Princípios do Cabeçalho

  • Evite cabeçalhos excessivamente grandes.
  • Não aumente a navegação desnecessariamente.
  • Em mobile, reduza para um menu, se necessário.
  • Use a cor de destaque de forma limitada para o estado ativo.

9. Hero

O Hero é a área mais importante da tela inicial.

O objetivo não é parecer chamativo, mas transmitir imediatamente a identidade do desenvolvedor.

Estrutura recomendada:

Sublinha
↓
Título Principal
↓
Descrição Curta
↓
CTA Primário / CTA Secundário

Exemplo de direção:

Quando encontro um problema,
eu mesmo o resolvo.

Desenvolvedor que resolve problemas reais
com IA e software e os transforma em produtos, Jung Hyun Yoon

No entanto, o texto final real deve ser gerenciado em um arquivo de conteúdo separado. Não codifique o conteúdo diretamente no componente Hero.


10. Design do Projeto

Os projetos são o conteúdo principal do portfólio.

O Cartão do Projeto não deve ser apenas um cartão que mostra nomes de tecnologias. Sempre que possível, transmita as seguintes informações:

Nome do Projeto
Status
Resumo Curto
Problema
Solução
Tecnologia
Período

Não force todas as informações em um único cartão. Se houver muita informação, direcione para uma página de detalhes.


11. Cartão do Projeto

Estilo padrão:

Background: #FFFFFF
Border: 1px solid #E4E4E7
Border Radius: 12px ~ 16px
Padding: 24px ~ 32px
Shadow: nenhum ou muito sutil

Minimize os efeitos de hover.

Recomendado:

Alteração de border-color
Alteração de background
transform: muito pequeno

Não use efeitos de ampliação excessiva ou brilho.


12. Status do Projeto

Expresse o status do projeto claramente.

Exemplo:

Ativo
Em Andamento
Arquivado

Não transmita o significado apenas com cor ao expressar o status. Use texto ou ícones juntos.


13. Tags de Tecnologia

As tags de tecnologia são elementos auxiliares para identificar informações rapidamente. Não aplique cores de arco-íris para cada tecnologia. Use um estilo Neutro por padrão.

Exemplo:

Next.js
TypeScript
Python
FastAPI
Supabase
SQLite
AI Agent

As tags de tecnologia não devem chamar mais atenção do que a descrição do projeto.


14. Página de Detalhes do Projeto

Ao clicar no Cartão do Projeto, você pode usar a seguinte estrutura:

Cabeçalho do Projeto
↓
Visão Geral
↓
Problema
↓
Abordagem
↓
Implementação
↓
Desafios
↓
Resultado
↓
O que Aprendi
↓
Tecnologia
↓
Links

Nem todos os projetos precisam ter todas as seções. Exiba apenas as informações que realmente existem no projeto.


15. Projetos em Destaque

Na página inicial, não mostre todos os projetos com o mesmo peso. Selecione os projetos principais com base no status featured.

Exemplo:

featured: true

A UI deve exibir os projetos com base no valor featured. Portanto, não deve ser necessário modificar o código do componente para remover um projeto dos Destaques.


16. Mais Projetos

Abaixo dos Projetos em Destaque, você pode fornecer uma área para visualizar outros projetos.

Objetivo:

Não é para evitar que o portfólio pareça ter poucos projetos, mas para mostrar a diversidade de problemas que o desenvolvedor resolveu.

Mantenha a hierarquia visual entre os projetos em destaque e os projetos comuns.


17. Seção de Abordagem

Em vez de um "Sobre Mim" genérico, considere priorizar uma área que mostre o método de desenvolvimento.

Exemplo:

01 Problema
02 Descoberta
03 Aprendizado
04 Construção
05 Resultado

A mensagem principal é:

Descobrir um problema → Pesquisar → Aprender a tecnologia necessária → Criar a solução → Verificar o resultado.

Priorize mostrar o processo real de desenvolvimento e a forma de pensar em vez de uma simples auto-apresentação.


18. Habilidades

A seção de habilidades não deve apenas listar tecnologias, mas sim mostrar o contexto real de uso.

Classificação recomendada:

Frontend
Backend
IA / Automação
Banco de Dados
Ferramentas

Exemplo:

Frontend
Next.js
React
TypeScript
Tailwind CSS

Backend
Python
FastAPI
Flask

IA / Automação
AI Agent
RAG
LLM API
Automação

Banco de Dados
SQLite
PostgreSQL
Supabase

Ferramentas
Git
GitHub
VS Code

No entanto, não adicione tecnologias sem experiência real de uso.


19. Representação de Habilidades

Não represente a proficiência em tecnologias com números arbitrários ou estrelas.

Proibido:

Python ★★★★★
React 90%
IA 95%

Em vez disso, conecte a tecnologia aos projetos reais e ao propósito de uso.

Exemplo:

Python
→ Usado em projetos de AI Agent / Automação / Backend

20. Contato

A área de Contato deve ser simples e clara.

Recomendado:

Mensagem Curta
E-mail
GitHub
LinkedIn ou outros links reais

Não crie contatos ou links que não existem de fato.


21. Rodapé

O rodapé deve ser mínimo.

Exemplo:

© 2026 Jung Hyun Yoon
Construído com Next.js

Não coloque mais informações do que o necessário.


22. Design Responsivo

Considere obrigatoriamente os seguintes ambientes:

Desktop
Tablet
Mobile

Não implemente o design responsivo apenas reduzindo a tela. Especialmente em mobile:

  • Altere a estrutura de navegação
  • Ajuste a tipografia do Hero
  • Grade → 1 Coluna
  • Ajuste o tamanho dos botões
  • Reduza o padding
  • Verifique a quebra de linhas em textos longos
  • Priorize as informações no Cartão do Projeto

23. Acessibilidade

Considere a acessibilidade básica obrigatoriamente.

  • Hierarquia de títulos adequada
  • Contraste de cores suficiente
  • Foco do teclado
  • Botões / Links claros
  • Texto alternativo em imagens
  • Área de toque recomendada de 44px ou mais
  • Não diferenciar estados apenas com cores
  • Projete para que a informação seja transmitida mesmo sem animações

24. Animação

Use animações apenas quando elas ajudarem na funcionalidade.

Recomendado:

150ms ~ 300ms
ease-out

Áreas permitidas:

  • Hover em botões
  • Hover em links
  • Hover em cartões
  • Navegação
  • Revelação curta de seções

O que não usar:

  • Parallax
  • Animações de scroll excessivas
  • Movimento contínuo
  • Animações decorativas sem sentido
  • Efeitos exagerados na entrada da página

25. Modo Escuro

Na versão inicial, priorize o Modo Claro. O Modo Escuro será adicionado quando houver um requisito separado. Não complique o sistema de design atual ou a estrutura de componentes por causa do Modo Escuro.


26. Regras Técnicas de Design

Use Tailwind CSS como sistema de estilo padrão. Use CSS Variables para gerenciar tokens de design globais.

Recomendado:

Tailwind
+
CSS Variables

Não use estilos inline desnecessários.


27. Regras de Componentes

Use React Server Component como padrão. Use Client Component apenas nos seguintes casos:

  • Entrada do usuário
  • Gerenciamento de estado
  • APIs do navegador
  • Interações baseadas em eventos
  • Quando for necessária execução no cliente, como bibliotecas de animação

Não transforme a página inteira em um Client Component desnecessariamente.


28. Separação de Conteúdo / UI

Separe o conteúdo da UI.

Estrutura recomendada:

content/
├─ profile.ts
├─ projects.ts
├─ skills.ts
└─ types.ts

Não escreva informações do projeto diretamente dentro dos componentes da UI. Ao adicionar ou modificar um projeto, projete de forma que, sempre que possível, apenas a edição de:

content/projects.ts

seja refletida na tela.

---

# 29. Princípio dos Dados do Projeto

Gerencie os dados do projeto de forma estruturada.

Exemplo:

```ts
{
  slug,
  title,
  summary,
  problem,
  solution,
  tech,
  status,
  featured,
  period,
  image,
  links,
  highlights
}

Use apenas os valores necessários. Não preencha informações que não existem de fato.


30. Regras para Imagens

Se a imagem do projeto não existir de fato, não crie ou importe imagens arbitrárias. Se um placeholder for necessário, indique claramente que é um placeholder. Crie uma estrutura para que, quando a captura de tela real do projeto estiver disponível, ela possa substituir a imagem do projeto.


31. Integridade dos Dados

Este é um dos princípios mais importantes do portfólio.

Nunca crie arbitrariamente:

  • Projetos que não existem
  • Experiências com tecnologias que não existem
  • Resultados que não existem
  • Números que não existem
  • Clientes que não existem
  • Experiências profissionais que não existem
  • Links que não existem
  • Certificações/qualificações que não existem
  • Resultados de projetos que não existem

Se a informação for insuficiente, priorize:

Deixar em branco

ou

Confirmar com o usuário

32. Preservação de Projetos Existentes

Não altere arbitrariamente o significado dos projetos existentes. Trabalhe com base nas descrições ou requisitos fornecidos pelo usuário. Se for necessário excluir ou reduzir uma funcionalidade existente, explique o motivo primeiro e peça confirmação.


33. Arquitetura da Informação do Portfólio

A estrutura inicial da página inicial deve considerar o seguinte como prioridade:

Cabeçalho
↓
Hero
↓
Projetos em Destaque
↓
Mais Projetos
↓
Abordagem
↓
Habilidades
↓
Contato
↓
Rodapé

No entanto, pode ser ajustado de acordo com o conteúdo real e a usabilidade.


34. Prioridade de Decisão de Design

Em caso de conflito de design, siga esta prioridade:

1. Legibilidade do conteúdo
2. Hierarquia da informação
3. Acessibilidade
4. Usabilidade responsiva
5. Consistência
6. Estética visual
7. Efeitos decorativos

Priorize um design fácil de ler e entender em vez de um design bonito.


35. Fluxo de Trabalho de Implementação

Ao criar uma nova página ou UI, siga esta ordem:

PASSO 1. Analisar

Verifique primeiro a estrutura atual do projeto e a UI existente.

PASSO 2. Planejar

Proponha a estrutura de informação e a composição da tela necessárias.

PASSO 3. Projetar

Proponha uma direção visual com base nos princípios de design deste SKILL.md.

PASSO 4. Componente

Proponha a estrutura de componentes necessária.

PASSO 5. Confirmar

Para grandes mudanças estruturais ou novas funcionalidades, obtenha a confirmação do usuário antes da implementação.

PASSO 6. Implementar

Implemente apenas o escopo confirmado.

PASSO 7. Verificar

Verifique o seguinte:

TypeScript
Build
Responsivo
Acessibilidade
Consistência visual
Funcionalidade existente

36. Gerenciamento de Mudanças

Para pequenas alterações, mantenha a estrutura existente o máximo possível. Antes de grandes alterações, siga esta ordem:

  1. Verificar a estrutura atual
  2. Explicar o motivo da mudança
  3. Verificar o escopo do impacto
  4. Apresentar alternativas
  5. Obter aprovação do usuário
  6. Implementar

37. Dependências

Adicione novas bibliotecas apenas quando a necessidade for clara. Se você pode resolver o problema com as funcionalidades existentes do Next.js / React / TypeScript / Tailwind, não adicione uma nova biblioteca. Se for necessário adicionar uma biblioteca, primeiro analise:

Por que é necessário
O que resolve
Se existe uma alternativa

38. Princípio do Supabase / Backend

A versão inicial do portfólio atual começa com base em conteúdo estático. Use content/*.ts como prioridade. Adicione um backend como Supabase apenas quando os seguintes requisitos surgirem de fato:

  • Página de administração
  • CRUD de projetos
  • Blog
  • Registro de desenvolvimento
  • Armazenamento de contatos
  • Autenticação
  • Gerenciamento de dados dinâmicos

Não introduza um banco de dados em uma fase onde o backend não é necessário.


39. Fluxo de Trabalho Git

Faça commit quando uma unidade de trabalho significativa for concluída.

Fluxo básico:

git add .
git commit -m "Descrição do trabalho"
git push

Recomenda-se o formato Conventional Commit para mensagens de commit.

Exemplo:

feat: adicionar página inicial do portfólio
feat: adicionar seção de projetos
style: melhorar cartões de projeto
fix: corrigir layout mobile
refactor: simplificar componentes de projeto
docs: atualizar documentação do portfólio
chore: atualizar dependências

Não agrupe unidades de trabalho excessivamente grandes.


40. Padrão de Qualidade Final

A tela finalizada deve responder "Sim" para as seguintes perguntas:

  • A identidade do desenvolvedor é visível na primeira tela?
  • Os projetos são vistos como o conteúdo principal?
  • É compreensível o que cada projeto resolveu?
  • Os resultados e processos reais são enfatizados em vez de uma lista de tecnologias?
  • É fácil de ler em mobile?
  • O conteúdo e a UI estão separados?
  • É fácil adicionar novos projetos?
  • Não há informações falsas incluídas?
  • Transmite uma impressão profissional sem efeitos de design excessivos?
  • Funcionalidades existentes não foram excluídas desnecessariamente?

41. Regras Inegociáveis

Os seguintes princípios são sempre mantidos:

  1. A decoração não deve superar o conteúdo.
  2. Os projetos são o núcleo do portfólio.
  3. Não invente conteúdo que não seja baseado em experiência real.
  4. Não adicione resultados ou números que o usuário não forneceu.
  5. Separe o conteúdo da UI.
  6. O Design Responsivo é padrão.
  7. Considere a acessibilidade.
  8. Não adicione bibliotecas desnecessárias.
  9. Não exclua funcionalidades existentes arbitrariamente.
  10. Grandes mudanças estruturais devem ser confirmadas com o usuário antes da implementação.
  11. Mantenha a direção de design Profissional / Moderno / Minimalista / Técnico.
  12. Mantenha o Modo Claro como padrão da primeira versão.
  13. Projete de forma que não seja necessário modificar o código da UI ao adicionar projetos.
  14. Todas as decisões de design priorizam a legibilidade e a transmissão de informações.

Habilidades Relacionadas