Construtor de Site de Currículo
Crie um site pessoal distinto e de nível profissional a partir de um PDF de currículo. O site deve refletir a profissão, personalidade e preferências de design do usuário — e não se parecer com um modelo genérico.
Mandamento de Estética de Design
Antes de escrever uma única linha de código, internalize isto: o maior modo de falha em sites gerados por IA é a convergência estética — todo site acaba parecendo vagamente igual. Evite isso a todo custo. Seu trabalho é fazer algo que pareça genuína e especificamente projetado para esta pessoa.
Tipografia
Escolha fontes que sejam bonitas, incomuns e apropriadas para a área da pessoa. O objetivo é uma combinação que alguém notaria e comentaria — não uma escolha segura.
Fontes proibidas (superutilizadas a ponto de serem invisíveis): Inter, Roboto, Arial, Helvetica, system-ui, -apple-system, Space Grotesk, Poppins. Estas são padrões, não escolhas.
Fontes distintas do Google para escolher (escolha as certas para a profissão e estética — não use todas):
Serifa Editorial / Expressiva:
- Cormorant Garamond — romântica, literária, luxo editorial de moda
- Playfair Display — editorial impresso clássico, traços de alto contraste
- Fraunces — serifa óptica peculiar, personalidade surpreendente
- Instrument Serif — refinada e contemporânea, confiança silenciosa
- DM Serif Display — serifa moderna com impacto
- Abril Fatface — alto contraste ultra, manchetes marcantes
- Yeseva One — calor Art Déco, autoridade acessível
- Cinzel — gravidade romana clássica
Sans-Serif Limpas mas Distintas:
- Syne — geométrica, voltada para design, contemporânea
- Unbounded — ousada, perfeita para grade, nativa da web
- Plus Jakarta Sans — quente e moderna, distinta da Inter
- Outfit — geométrica fresca com personalidade
- DM Sans — limpa mas não estéril
- Josefin Sans — minimalismo geométrico elegante
Para Corpo de Texto (legível, distinto):
- Lora — serifa quente, literária, legível em textos longos
- Source Serif 4 — confiabilidade editorial
- Spectral — serifa digital elegante
- Literata — projetada com precisão para leitura
Para Estética Técnica / Desenvolvedor:
- JetBrains Mono — credibilidade de desenvolvedor
- IBM Plex Mono — corporativo-técnico, estruturado
- Space Mono — retrô-digital, personalidade
- Fira Code — ligaduras, estética hacker
Para Estéticas Expressivas / Nicho:
- Exo 2 — precisão sci-fi
- Orbitron — era espacial (use com moderação — para a pessoa certa é perfeito)
- Rajdhani — energia técnica angular
Princípio de combinação: Escolha uma fonte de exibição/título e uma fonte de corpo. Elas devem contrastar — um título serifado de alto drama com um corpo sans limpo, ou um título monoespaçado preciso com um corpo serifado quente. Combinações entediantes são aquelas em que ambas as fontes parecem ter o mesmo peso.
Cor e Tema
Comprometa-se com uma paleta forte e coesa. Paletas tímidas que espalham a cor uniformemente parecem amadoras. Uma cor dominante + um acento nítido + neutros cuidadosos é quase sempre mais forte do que três cores igualmente pesadas.
Combinações de cores proibidas (clichês, esperadas):
- Gradientes roxo/violeta em branco (a "estética AI" padrão)
- Azul-petróleo + coral em branco (paleta inicial superutilizada)
- Modo escuro genérico: fundo #1a1a1a + texto branco + acento azul
- Pastéis planos sem contraste ou tensão
Arquétipos de paletas distintas para se inspirar (adapte, não copie exatamente):
- Floresta profunda
#1a2e1a+ dourado quente#c9a84c+ creme#f5f0e8— autoridade orgânica - Azul marinho meia-noite
#0d1b2a+ ciano elétrico#00d4ff+ branco — precisão técnica - Preto quente
#1a1208+ âmbar#f59e0b+ marfim — calor editorial - Carvão
#2a2a2a+ ferrugem#c0392b+ off-white#fafaf7— confiança ousada - Borgonha profundo
#3d0c02+ champanhe#e8d5b7+ marfim — luxo acadêmico - Quase preto
#0e0e0e+ lima ácida#a8d729+ branco — vantagem técnica - Ardósia
#2c3e50+ coral profundo#ff6b4a+ creme — modernismo quente - Off-white
#fafaf8+ tinta#1a1a2e+ terracota#c4602a— calor enraizado - Violeta escuro
#1a0533+ rosa choque#ff6b9d+ branco — maximalismo criativo
Varie ativamente entre temas claro e escuro entre diferentes usuários. Não use escuro por padrão porque "parece mais técnico" — um site claro com uma paleta editorial forte pode ser igualmente marcante.
Use propriedades personalizadas CSS para cada cor:
:root {
--color-bg: #1a2e1a;
--color-surface: #243824;
--color-accent: #c9a84c;
--color-text: #f5f0e8;
--color-muted: #8a9e8a;
}
Movimento
Uma sequência de entrada bem orquestrada cria mais encanto do que dez microinterações dispersas. Pense no carregamento da página como um único momento coreografado.
Padrões eficazes:
/* Revelação escalonada no carregamento — aplique com animation-delay crescente */
@keyframes fadeUp {
from { opacity: 0; transform: translateY(24px); }
to { opacity: 1; transform: translateY(0); }
}
.hero-name { animation: fadeUp 0.6s ease forwards; animation-delay: 0.1s; }
.hero-title { animation: fadeUp 0.6s ease forwards; animation-delay: 0.25s; }
.hero-tagline { animation: fadeUp 0.6s ease forwards; animation-delay: 0.4s; }
.hero-cta { animation: fadeUp 0.6s ease forwards; animation-delay: 0.55s; }
- Use
opacity: 0como padrão e anime paraopacity: 1— limpo, compositável - Estados de hover devem usar
transition: all 0.2s ease— rápidos o suficiente para parecerem responsivos - Revelações acionadas por rolagem: use
IntersectionObserver+ alternância de classe CSS para seções que entram na viewport - Para bordas, sublinhados e destaques: transformações animadas de
widthouclip-pathparecem precisas e intencionais
Evite: efeitos de partículas particle.js / canvas, saltos excessivos, parallax que luta contra o conteúdo, animações que atrasam a visibilidade do conteúdo por mais de ~1 segundo no total.
Fundos
Cores sólidas são o padrão preguiçoso. Cada fundo deve ter pelo menos uma camada de profundidade ou textura.
Técnicas:
/* Gradiente mesh — vários gradientes radiais em camadas */
background:
radial-gradient(ellipse at 20% 50%, rgba(201,168,76,0.15) 0%, transparent 60%),
radial-gradient(ellipse at 80% 20%, rgba(0,212,255,0.08) 0%, transparent 50%),
#0d1b2a;
/* Padrão de grade sutil */
background-image: linear-gradient(rgba(255,255,255,0.03) 1px, transparent 1px),
linear-gradient(90deg, rgba(255,255,255,0.03) 1px, transparent 1px);
background-size: 48px 48px;
/* Textura de granulação via filtro SVG */
filter: url(#grain); /* definir filtro SVG feTurbulence */
/* Acento de listra diagonal */
background: repeating-linear-gradient(
-45deg,
transparent,
transparent 8px,
rgba(201,168,76,0.05) 8px,
rgba(201,168,76,0.05) 9px
);
Combine a técnica de fundo com a estética geral — um site de dev com estética de terminal pode usar um efeito sutil de linha de varredura; um site de finanças de luxo pode usar uma textura de linho muito suave.
Fluxo de Trabalho
Etapa 1: Extrair o PDF do Currículo
Use a seguinte abordagem em ordem — tente o script primeiro, recorra ao MCP apenas se falhar.
Opção A: Script uv (preferido)
Execute o script de extração usando uv. Ele lida com dependências automaticamente, sem necessidade de configuração além de ter o uv instalado.
uv run .claude/skills/resume-website/scripts/pdf-extract.py <caminho-para-o-curriculo.pdf>
Se uv não estiver instalado, instrua o usuário a instalá-lo primeiro:
- macOS / Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh - Windows (PowerShell):
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
Após a instalação, execute novamente o comando do script acima.
Opção B: MCP pdf-reader (fallback)
Se o script falhar por qualquer motivo, recorra ao MCP pdf-reader. Verifique se está instalado — se não, instale-o:
claude mcp add pdf-reader -- npx @sylphx/pdf-reader-mcp
Após a instalação, reinicie o Claude Code para que o MCP fique disponível. Em seguida, use a ferramenta read_pdf do MCP para extrair o conteúdo do currículo.
Etapa 2: Ler e Analisar o Currículo
Use o MCP pdf-reader para ler o PDF do currículo do usuário. Extraia e organize:
- Nome e informações de contato (email, telefone, localização, LinkedIn, GitHub, links de portfólio)
- Cargo profissional / título
- Experiência profissional (empresas, cargos, datas, realizações)
- Educação (diplomas, instituições, datas)
- Habilidades (técnicas, comportamentais, idiomas)
- Projetos (se houver)
- Certificações, prêmios, publicações (se houver)
- Resumo / objetivo (se houver)
Etapa 3: Analisar a Profissão do Usuário
O trabalho do usuário determina a direção estética do site. Combine o design com sua identidade profissional — mas vá além da categorização superficial. Um "engenheiro de software" em um fundo de hedge tem estéticas diferentes de um que está em uma agência de design.
| Categoria de Profissão | Direção Estética | Ponto de Partida da Fonte | Direção de Cor |
|---|---|---|---|
| Engenheiro de Software / Desenvolvedor | Inspirado em terminal, preciso, prefere escuro | JetBrains Mono ou IBM Plex Mono + sans limpa | Fundo escuro + acento elétrico (ciano, verde, âmbar) |
| Designer / Diretor Criativo | Ousado, experimental, forte presença tipográfica | Serifa display expressiva + sans geométrica | Alto contraste, combinações inesperadas |
| Cientista de Dados / Analista | Estruturado, analítico, inspirado em visualização de dados | Sans precisa + corpo serifado legível | Azul marinho/ardósia profundo + acento único nítido |
| Marketing / Negócios | Sensação de revista editorial, confiante, direcionado por CTA | Título serifado de alto contraste + sans quente | Dominante quente + acento ousado |
| Acadêmico / Pesquisador | Escolar, pesado em serifa, minimalismo intelectual | Cormorant ou Spectral + corpo Lora | Creme/marfim + tinta + um acento quente |
| Saúde / Médico | Limpo, confiável, autoridade calma | DM Sans ou Plus Jakarta Sans + corpo legível | Neutro calmante + acento confiável |
| Finanças / Consultoria | Luxo, autoridade, refinado | Cinzel ou Yeseva One + serifa corporal elegante | Escuro + dourado/champanhe ou azul marinho profundo + prata |
| Artista / Fotógrafo | Tipo galeria, voltado para imagem, dramático | Abril Fatface ou Syne + corpo minimalista | Depende do trabalho deles — geralmente quase preto + uma cor ousada |
| Gerente de Produto | Moderno, organizado, voltado para métricas | Instrument Serif + sans limpa | Tom médio confiante + acento nítido |
| Professor / Educador | Quente, acessível, legível | Fraunces ou DM Serif + corpo sans quente | Paleta quente, brilho mais alto |
| Jurídico | Autoritário, tradicional, estruturado | Cinzel ou Playfair Display + corpo serifado | Azul marinho escuro ou carvão + dourado |
| Freelancer / Generalista | Expressão de marca pessoal — use detalhes do currículo para decidir | Depende da personalidade deles | Depende da personalidade deles |
Use isso como ponto de partida, depois adapte com base no que o currículo específico revela sobre sua personalidade, senioridade e contexto do setor.
Etapa 4: Perguntar as Preferências de Design do Usuário
Use a ferramenta AskUserQuestion para coletar preferências de design. Faça perguntas de forma amigável e não técnica, pois os usuários podem não conhecer a terminologia de design.
O princípio chave: cada pergunta deve se adaptar ao que o usuário já respondeu. Não agrupe todas as perguntas de uma vez e apresente opções pré-geradas — as escolhas em perguntas posteriores dependem do que o usuário escolheu anteriormente. Se você perguntar sobre tipografia antes de saber se eles querem claro ou escuro, sugerirá as fontes erradas.
Rodada 1 — A decisão âncora: vibe + tom
Pergunte sobre a vibe geral e a direção claro/escuro juntas, pois esses são os dois eixos dos quais tudo mais se ramifica. Gere 3-4 direções estéticas adaptadas à profissão deles (por exemplo, um engenheiro de software vê "terminal/precisão", um designer vê "editorial/expressivo"). Lidere com sua principal recomendação e explique por que ela se adequa especificamente a eles. Inclua uma opção "Me surpreenda".
Depois de obter a resposta, mantenha-a como a âncora para tudo o que se segue.
Rodada 2 — Cor + estilo visual (adaptado à Rodada 1)
Agora, gere opções de paleta de cores que realmente funcionem dentro do tema que eles escolheram. Se eles escolheram claro, mostre paletas claras — não "aqui estão 5 opções, 3 das quais são escuras". O mesmo para o estilo visual — mostre estilos que sejam coerentes com a vibe que eles escolheram. Use os arquétipos de paleta do Mandamento de Estética de Design como ponto de partida e adapte-os.
Mostrando cores visualmente: Antes de fazer a pergunta sobre cor, gere um arquivo temporário color_preview.html e abra-o no navegador para que o usuário possa ver amostras reais. Em seguida, peça que escolham pelo nome/número.
Gere de 3 a 4 opções de paleta. Cada paleta deve ter: cores de fundo, superfície, acento e texto. Escreva o HTML assim:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Escolha sua paleta</title>
<style>
body { font-family: sans-serif; padding: 32px; background: #f5f5f5; }
.palettes { display: flex; flex-wrap: wrap; gap: 24px; }
.palette { border-radius: 12px; overflow: hidden; width: 260px; box-shadow: 0 2px 12px rgba(0,0,0,0.12); }
.swatch { height: 56px; display: flex; align-items: center; padding: 0 16px; font-size: 13px; font-weight: 500; }
.label { padding: 14px 16px; background: white; }
.label h3 { margin: 0 0 4px; font-size: 15px; }
.label p { margin: 0; font-size: 12px; color: #666; }
</style>
</head>
<body>
<h2>Escolha uma paleta de cores</h2>
<div class="palettes">
<!-- Repita este bloco para cada opção de paleta -->
<div class="palette">
<div class="swatch" style="background:#1a2e1a; color:#f5f0e8;">Fundo</div>
<div class="swatch" style="background:#243824; color:#f5f0e8;">Superfície</div>
<div class="swatch" style="background:#c9a84c; color:#1a2e1a;">Acento</div>
<div class="swatch" style="background:#f5f0e8; color:#1a2e1a;">Texto</div>
<div class="label">
<h3>1. Floresta & Dourado</h3>
<p>Autoridade orgânica — verde profundo, dourado quente, creme</p>
</div>
</div>
</div>
</body>
</html>
Salve como color_preview.html no diretório atual e execute open color_preview.html. Diga ao usuário: "Abri uma prévia de cores no seu navegador — dê uma olhada e me diga qual número de paleta você gostou."
Após a escolha, exclua color_preview.html e continue.
Rodada 3 — Tipografia (adaptada às Rodadas 1 e 2)
Agora que você conhece a vibe (escura/clara, profissional/expressiva), use o Mandamento de Estética de Design para sugerir 2 a 3 combinações de fontes que se encaixem. Apresente cada uma com seu nome e uma descrição de uma linha de por que funciona.
Use o mesmo padrão font_preview.html para pré-visualização, se achar útil.
Rodada 4 — Conteúdo do site
Pergunte:
"Agora que temos o visual definido, vamos alinhar o conteúdo. Quer incluir alguma seção além do que está no seu currículo? Coisas comuns: 'Sobre mim' (biografia pessoal), depoimentos, um formulário de contato, links para redes sociais ou um blog. Também posso adicionar uma seção de projetos ou estudos de caso se você tiver material para isso. O que mais você gostaria de ver?"
Etapa 5: Construir e Visualizar o Site
Com base nas escolhas do usuário e no conteúdo do currículo, gere um site completo de página única como um único arquivo HTML. Inclua blocos <style> e <script> embutidos.
Estrutura
├── index.html # Arquivo do site completo — CSS e JS embutidos
├── assets/ # (opcional, crie se necessário)
│ ├── profile.jpg # Foto do usuário
│ └── resume.pdf # Cópia do currículo para download (opcional)
Diretrizes de Construção
- Todas as cores devem usar variáveis CSS — defina
:rootno topo, usevar(--color-*)em todo lugar. Sem valores hex hardcoded além da definição:root. - Responsivo: teste mentalmente em dispositivos móveis, tablets e desktop. Use
clamp()emin()para tamanhos de fonte. Use consultas de mídia para layouts de grade e navegação. - Acessibilidade: contraste de cores suficiente (verifique mentalmente as taxas de contraste WCAG AA), texto alternativo
altem imagens, atributosaria-labelem links e botões. - Seções de layout preferidas: use CSS Grid para layouts de página inteira (por exemplo, uma grade 2×2 para uma seção de destaques), e Flexbox para componentes unidirecionais (barras de navegação, cartões de projeto lado a lado). Evite float para layout.
- Adicione movimento usando os padrões e princípios na seção de movimento do Mandamento de Estética.
- Adicione profundidade de fundo — implemente pelo menos uma técnica de textura/subtileza da seção de fundos.
Etapa 6: Publicar no GitHub Pages
Peça ao usuário para criar um repositório no GitHub (a menos que já tenham um). Forneça instruções claras passo a passo.
- Peça ao usuário para fazer login no GitHub.com e criar um novo repositório (público). Se quiserem, podem nomeá-lo
username.github.iopara que o site fique disponível nesse URL. - Rode
git init,git add .,git commit -m "Initial commit: personal website". - Rode
git remote add origin <repository-url>egit push -u origin main. - Vá para o repositório no GitHub.com → Settings → Pages. Em "Branch", selecione
maine/ (root), depois salve. - Informe ao usuário que o site será implantado em
https://username.github.io(ouhttps://username.github.io/repository-namese não usaram o formato de usuário). A implantação leva alguns minutos. - Se eles já tiverem um site no GitHub Pages, crie uma nova pasta para este site e informe que eles podem implantá-lo em uma subpasta ou substituir o existente.
- Se eles não quiserem GitHub Pages, pergunte para onde devemos enviar os arquivos do site.
Diretrizes de Qualidade
- O site finalizado deve carregar em <2 segundos em uma conexão típica (sem scripts pesados, sem chamadas de API externas)
- Sem dependências externas (nada de CDNs, bibliotecas JS) — tudo deve ser autossuficiente em um único HTML
- O código deve passar por um validador HTML (tags fechadas corretamente, elementos aninhados corretamente, codificação UTF-8 declarada)
- A aparência deve ser marcante o suficiente para que alguém que veja o site pense "isso foi feito sob medida para essa pessoa" — não "isso saiu de um modelo"
Teste de convergência estética: Depois de terminar o design, pare e pergunte: "Este site poderia ser confundido com o de outra pessoa na mesma profissão?" Se sim, é porque você não foi específico o suficiente sobre a paleta, tipografia ou layout. Continue iterando.