Communitygithub.com

RiverAi7z/pdf-resume-skills

Crie um site pessoal impressionante a partir de um PDF de currículo. Use esta habilidade 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 landing page pessoal baseada em sua trajetória profissional.

O que é pdf-resume-skills?

Esta habilidade constrói um site pessoal personalizado e de alto nível de design a partir de um PDF de currículo, com foco na diferenciação estética para evitar a aparência genérica de templates. Ela combina uma extração robusta do PDF (usando scripts uv ou MCP pdf-reader), análise detalhada da profissão do usuário e uma seleção criteriosa de tipografia, paleta de cores, animações e fundos com textura. A ferramenta interage com o usuário por meio de perguntas adaptativas para definir o estilo, garantindo que cada site reflita sua personalidade e área de atuação. Compatível com plataformas como Claude Code, Cursor e Codex, ela gera código HTML/CSS/JS completo, otimizado e modular, com suporte a temas claro e escuro, responsividade e boas práticas de SEO.

Funciona com✓Claude Code~Codex CLI✓Cursor
npx skills add RiverAi7z/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 diferenciado 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 — sem 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 bonitas, incomuns e adequadas à área da pessoa. O objetivo é uma combinação que alguém notaria e comentaria — não um fallback seguro.

Fontes proibidas (exageradamente usadas a ponto de se tornarem 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 Fonts para usar (escolha as certas para a profissão e estética — não use todas):

Editoriais / Serifas Expressivas:

  • Cormorant Garamond — romântica, literária, luxo editorial de moda
  • Playfair Display — impressão editorial clássica, traços de alto contraste
  • Fraunces — serifa óptica peculiar, personalidade surpreendente
  • Instrument Serif — refinada e contemporânea, confiança discreta
  • DM Serif Display — serifa moderna com força
  • Abril Fatface — ultra-alto contraste, manchetes marcantes
  • Yeseva One — calor Art Déco, autoridade acessível
  • Cinzel — gravidade clássica romana

Sans-Serifas Limpas, mas Distintas:

  • Syne — geométrica, voltada ao design, contemporânea
  • Unbounded — ousada, perfeita em grid, 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, distinta):

  • 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-tech, estruturada
  • Space Mono — retrô-digital, com 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, é perfeita)
  • Rajdhani — energia técnica angular

Princípio de pareamento: 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 sem serifa limpo, ou um título monoespaçado preciso com um corpo serifado quente. Pareamentos entediantes são aqueles onde ambas as fontes têm 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 marcante + neutros cuidadosos é quase sempre mais forte que três cores com pesos iguais.

Combinações de cores proibidas (clichês, esperadas):

  • Gradientes roxo/violeta sobre branco (a "estética IA" padrão)
  • Azul-petróleo + coral sobre branco (paleta de startup exagerada)
  • Modo escuro genérico: fundo #1a1a1a + texto branco + acento azul
  • Pastéis planos sem contraste ou tensão

Arquétipos de paletas distintas para usar (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 + limão ácido #a8d729 + branco — vantagem técnica
  • Ardósia #2c3e50 + coral profundo #ff6b4a + creme — modernismo quente
  • Off-white #fafaf8 + tinta #1a1a2e + terracota #c4602a — calor fundamentado
  • Violeta escuro #1a0533 + rosa choque #ff6b9d + branco — maximalismo criativo

Varie ativamente entre temas claro e escuro para diferentes usuários. Não use escuro como 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 gera mais encantamento 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ápido o suficiente para parecer responsivo
  • Revelações acionadas por scroll: use IntersectionObserver + alternância de classe CSS para seções que entram no 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 compete com 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 — múltiplos 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 sutil de grade */
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 granular via filtro SVG */
filter: url(#grain); /* defina um filtro SVG feTurbulence */

/* Acento de faixa 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 dev com estética de terminal pode usar um efeito sutil de scanline; um site de finanças de luxo pode usar uma textura de linho muito leve.


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 gerencia as 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-curriculo.pdf>

Se o 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 instalar, 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 estiver, instale-o:

claude mcp add pdf-reader -- npx @sylphx/pdf-reader-mcp

Após instalar, 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 (e-mail, telefone, localização, LinkedIn, GitHub, links de portfólio)
  • Título profissional / manchete
  • Experiência profissional (empresas, cargos, datas, realizações)
  • Educação (graus, 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ética diferente de um em uma agência de design.

Categoria de ProfissãoDireção EstéticaPonto de Partida para FontesDireção de Cor
Engenheiro de Software / DesenvolvedorInspirado em terminal, preciso, escuro-preferidoJetBrains Mono ou IBM Plex Mono + sem serifa limpaFundo escuro + acento elétrico (ciano, verde, âmbar)
Designer / Diretor CriativoOusado, experimental, forte presença tipográficaSerifa expressiva de exibição + sem serifa geométricaAlto contraste, combinações inesperadas
Cientista de Dados / AnalistaEstruturado, analítico, inspirado em visualização de dadosSem serifa precisa + corpo serifado legívelAzul-marinho/ardósia profundo + acento único marcante
Marketing / NegóciosSensação de revista editorial, confiante, orientado a CTATítulo serifado de alto contraste + sem serifa quenteDominante quente + acento ousado
Acadêmico / PesquisadorErudito, 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 de corpo eleganteEscuro + dourado/champanhe ou azul-marinho profundo + prata
Artista / FotógrafoComo galeria, voltado para imagem, dramáticoAbril Fatface ou Syne + corpo mínimoDepende do trabalho deles — geralmente quase preto + uma cor ousada
Gerente de ProdutoModerno, organizado, voltado a métricasInstrument Serif + sem serifa limpaMeio-tom confiante + acento nítido
Professor / EducadorQuente, acessível, legívelFraunces ou DM Serif + corpo sem serifa 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 os 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 reunir as 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 antecipadamente 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 juntos, pois estes 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".

Assim que você tiver a resposta deles, mantenha-a como a âncora para tudo 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 coerentes com a vibe que 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 cores, gere um arquivo temporário color_preview.html e abra-o no navegador para que o usuário possa ver amostras reais. Então peça a eles para escolher 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

…

[cortado para tradução]

Habilidades Relacionadas