Communitygithub.com

RiverAi7z/virtus

Construa um site pessoal impressionante a partir de um PDF de currículo. Use essa skill sempre que o usuário quiser criar um site pessoal, portfólio ou currículo online a partir de um PDF de currículo. Também acione quando o usuário mencionar converter um currículo em site, construir um portfólio a partir do CV ou quiser uma página de destino pessoal baseada em sua trajetória profissional.

O que é virtus?

Esta skill guia você na criação de um site pessoal de alto nível e produção a partir de um PDF de currículo, indo muito além de modelos genéricos. O processo começa extraindo o conteúdo do PDF (preferencialmente via script uv, ou via MCP pdf-reader como alternativa), analisando a profissão do usuário para determinar uma direção estética personalizada — combinando tipografia, paleta de cores e estilo visual que reflitam a identidade profissional e a personalidade do indivíduo. A skill impõe um mandato rigoroso de design para evitar a 'convergência estética' comum em sites gerados por IA, banindo fontes e combinações de cores genéricas e oferecendo princípios de design para tipografia, cor, movimento e fundos com profundidade. Ao longo do fluxo de trabalho, a skill interage com o usuário de forma adaptativa para refinar escolhas de design (tom, cor, tipografia), levando à geração de um site completo com HTML, CSS e JavaScript customizados, incluindo efeitos de animação e transições suaves, tudo hospedado via GitHub Pages ao final. O resultado final é um site profissional, distinto e tecnicamente sólido, que se destaca visualmente e comunica a marca pessoal do usuário de forma autêntica.

Funciona com✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/RiverAi7z/virtus/tree/HEAD/skills/pdf-resume-skills

Perguntar na sua IA favorita

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

Documentação

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: 0 como padrão e anime para opacity: 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 width ou clip-path parecem 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ãoDireção EstéticaPonto de Partida da FonteDireção de Cor
Engenheiro de Software / DesenvolvedorInspirado em terminal, preciso, prefere escuroJetBrains Mono ou IBM Plex Mono + sans limpaFundo escuro + acento elétrico (ciano, verde, âmbar)
Designer / Diretor CriativoOusado, experimental, forte presença tipográficaSerifa display expressiva + sans geométricaAlto contraste, combinações inesperadas
Cientista de Dados / AnalistaEstruturado, analítico, inspirado em visualização de dadosSans precisa + corpo serifado legívelAzul marinho/ardósia profundo + acento único nítido
Marketing / NegóciosSensação de revista editorial, confiante, direcionado por CTATítulo serifado de alto contraste + sans quenteDominante quente + acento ousado
Acadêmico / PesquisadorEscolar, pesado em serifa, minimalismo intelectualCormorant ou Spectral + corpo LoraCreme/marfim + tinta + um acento quente
Saúde / MédicoLimpo, confiável, autoridade calmaDM Sans ou Plus Jakarta Sans + corpo legívelNeutro calmante + acento confiável
Finanças / ConsultoriaLuxo, autoridade, refinadoCinzel ou Yeseva One + serifa corporal eleganteEscuro + dourado/champanhe ou azul marinho profundo + prata
Artista / FotógrafoTipo galeria, voltado para imagem, dramáticoAbril Fatface ou Syne + corpo minimalistaDepende do trabalho deles — geralmente quase preto + uma cor ousada
Gerente de ProdutoModerno, organizado, voltado para métricasInstrument Serif + sans limpaTom médio confiante + acento nítido
Professor / EducadorQuente, acessível, legívelFraunces ou DM Serif + corpo sans quentePaleta quente, brilho mais alto
JurídicoAutoritário, tradicional, estruturadoCinzel ou Playfair Display + corpo serifadoAzul marinho escuro ou carvão + dourado
Freelancer / GeneralistaExpressão de marca pessoal — use detalhes do currículo para decidirDepende da personalidade delesDepende 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 &amp; 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 :root no topo, use var(--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() e min() 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 alt em imagens, atributos aria-label em 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.

  1. 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.io para que o site fique disponível nesse URL.
  2. Rode git init, git add ., git commit -m "Initial commit: personal website".
  3. Rode git remote add origin <repository-url> e git push -u origin main.
  4. Vá para o repositório no GitHub.com → Settings → Pages. Em "Branch", selecione main e / (root), depois salve.
  5. Informe ao usuário que o site será implantado em https://username.github.io (ou https://username.github.io/repository-name se não usaram o formato de usuário). A implantação leva alguns minutos.
  6. 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.
  7. 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.

Habilidades Relacionadas