O que Frontend Resume faz?
Crie páginas HTML de currículo ricas em animação, sem dependências externas, que rodam inteiramente no navegador. Ajude os usuários a descobrir sua estética preferida por meio de exploração visual e, em seguida, gere currículos interativos prontos para produção.
Filosofia Central
- Zero Dependências — Arquivos HTML únicos com CSS/JS inline. Sem npm, sem ferramentas de build.
- Mostre, Não Conte — Gere prévias visuais, deixe o usuário escolher o que gosta.
- Design Marcante — Evite estéticas genéricas de "IA genérica". Cada currículo deve parecer feito sob medida.
- Pronto para Impressão — Todo currículo DEVE incluir estilos
@media printpara saída limpa em PDF. - Acessível — HTML semântico, navegação por teclado, suporte a movimento reduzido, contraste WCAG AA.
Fase 0: Detectar Modo
Determine o que o usuário deseja:
Modo A: De Arquivo — O usuário fornece um arquivo de currículo (.pdf, .docx, .md, .txt, .json) → Fase 1 Modo B: De Texto — O usuário fornece o conteúdo do currículo como texto → Fase 1 Modo C: Aprimoramento — O usuário tem um HTML de currículo existente para melhorar → Leia o arquivo e vá para a Fase 2
Fase 1: Extração e Estruturação de Conteúdo
Passo 1.1: Extração de Arquivo (apenas Modo A)
Execute o script scripts/extract_resume.py no arquivo de currículo do usuário:
python [skill-dir]/scripts/extract_resume.py <arquivo_curriculo>
Formatos suportados e dependências:
| Formato | Extensões | Dependência Python | Observações |
|---|---|---|---|
pdfplumber (preferido) ou PyPDF2 | pip install pdfplumber | ||
| Word | .docx | python-docx | pip install python-docx |
| Markdown | .md | Nenhuma | Analisa títulos, listas, negrito/itálico |
| Texto Plano | .txt | Nenhuma | Linhas em MAIÚSCULO são inferidas como títulos |
| JSON Resume | .json | Nenhuma (biblioteca json nativa) | Esquema de jsonresume.org; já estruturado — pode pular o Passo 1.2 |
Se uma dependência necessária estiver faltando, o script imprime instruções de instalação.
Apresente o conteúdo extraído ao usuário para confirmação. Para arquivos JSON Resume, os dados já estão estruturados — apresente as seções mapeadas diretamente e pule para o Passo 1.3, a menos que o usuário queira ajustar.
Passo 1.2: Estruturar Conteúdo
Analise o texto bruto em seções estruturadas:
- header: nome, título/tagline, localização, contato (email, telefone, LinkedIn, GitHub, portfólio)
- about: resumo profissional
- experience[]: empresa, cargo, datas, localização, marcadores
- education[]: instituição, diploma, datas, honras/CR
- skills{}: agrupadas por categoria com níveis de proficiência opcionais (0-100)
- projects[]: nome, descrição, stack de tecnologia, link
- certifications[]: nome, emissor, data (opcional)
- languages[]: idioma, proficiência (opcional)
Apresente o conteúdo estruturado ao usuário para revisão. Pergunte: "Isso parece correto? Alguma seção para adicionar, remover ou modificar?"
Passo 1.3: Prioridade das Seções
Pergunte via AskUserQuestion:
- Cabeçalho: "Layout"
- Pergunta: "Quais seções devem ser mais proeminentes?"
- Opções:
- "Foco em Experiência" — Histórico profissional em destaque (profissionais seniores)
- "Foco em Habilidades" — Habilidades técnicas no centro (desenvolvedores/engenheiros)
- "Foco em Projetos" — Portfólio/projetos em destaque (designers/freelancers)
- "Equilibrado" — Peso igual para todas as seções
Fase 2: Descoberta de Estilo
Passo 2.0: Caminho do Estilo
Pergunte: "Como você gostaria de escolher o estilo do seu currículo?"
- "Mostre-me opções" — Gere 3 prévias visuais (recomendado) → Passo 2.1
- "Eu sei o que quero" — Escolha diretamente de uma lista predefinida → Mostre o seletor de predefinições abaixo
Predefinições Disponíveis:
| Predefinição | Vibração | Melhor Para |
|---|---|---|
| Arquiteto da Meia-Noite | Sofisticado, premium | Executivos, consultores |
| Terminal Neon | Estilo hacker, desenvolvedor | Engenheiros de software, DevOps |
| Luxo Escuro | Elegante, editorial | Diretores criativos, marketing |
| Profundidade Cósmica | Ousado, futurista | Fundadores de tecnologia, engenheiros IA/ML |
| Tela Limpa | Minimalista, estilo suíço | Designers, gerentes de produto |
| Artesanato em Papel | Aconchegante, tátil | Escritores, educadores, acadêmicos |
| Projeto Suave | Técnico, acessível | Engenheiros, cientistas de dados |
| Monocromático Brutalista | Cru, anti-design | Estrategistas de marca, quem busca destaque |
| Jardim Sábio | Inspirado na natureza, calmante | RH, bem-estar, educadores |
| Tinta Retrô | Editorial vintage | Jornalistas, marcas pessoais |
Se o usuário escolher uma diretamente, pule para a Fase 3.
Passo 2.1: Descoberta Guiada
Pergunta 1 — Clima (multiSeleção até 2):
- "Profissional/Autoritário" — Estabelecido, confiável
- "Criativo/Marcante" — Único, com foco em design
- "Moderno/Técnico" — Limpo, orientado a desenvolvedores
- "Aconchegante/Acessível" — Amigável, pessoal
Pergunta 2 — Tom:
- "Claro" — Limpo, imprimível
- "Escuro" — Ousado, otimizado para tela
- "Qualquer um" — Deixe o estilo decidir
Passo 2.2: Gerar 3 Prévias
Com base no clima + tom, selecione 3 predefinições. Leia o arquivo references/STYLE_PRESETS.md para definições completas das predefinições.
Mapeamento clima-para-predefinição:
| Clima | Escuro | Claro | Especialidade |
|---|---|---|---|
| Profissional | Arquiteto da Meia-Noite, Luxo Escuro | Tela Limpa, Projeto Suave | — |
| Criativo | Luxo Escuro, Profundidade Cósmica | Artesanato em Papel | Monocromático Brutalista, Tinta Retrô |
| Moderno/Técnico | Terminal Neon, Profundidade Cósmica | Projeto Suave | Monocromático Brutalista |
| Aconchegante | Luxo Escuro | Artesanato em Papel, Jardim Sábio | Tinta Retrô |
Gere 3 mini prévias HTML em .claude-design/resume-previews/:
.claude-design/resume-previews/
├── estilo-a.html
├── estilo-b.html
└── estilo-c.html
Cada prévia: autocontida (~80-120 linhas), mostra seção de herói + uma entrada de experiência + barras de habilidades. Suficiente para transmitir a estética.
NUNCA use estes padrões genéricos:
- Inter, Roboto, Arial como fontes de exibição
- Gradientes roxos em branco, índigo genérico
#6366f1 - Tudo centralizado sem variação
- Glassmorphism gratuito
Passo 2.3: Escolher
Apresente as prévias, peça ao usuário para escolher uma ou misturar elementos.
Fase 3: Gerar Currículo
Leia estes arquivos de referência para a predefinição escolhida:
references/STYLE_PRESETS.md— Variáveis CSS completas, URLs de fontes, paleta de cores, estilo de animaçãoreferences/RESUME_COMPONENTS.md— Padrões de CSS/JS de componentes interativosreferences/HTML_ARCHITECTURE.md— Template HTML base, CSS obrigatório, arquitetura JS, estilos de impressão, checklist de acessibilidade
Saída
Gere um único arquivo HTML autocontido:
- Todo CSS inline em
<style> - Todo JS inline em
<script> - Fontes do Google / Fontshare via
<link>(com degradação suave) - Estrutura HTML5 semântica
Recursos Obrigatórios
- Revelações com acionamento por rolagem — Elementos animam via IntersectionObserver
- Navegação flutuante — Nav fixa com rastreamento de seção ativa
- Barras de habilidades animadas — Preenchem ao entrar na visualização
- Barra de progresso de rolagem — Barra fina no topo
- Botão de voltar ao topo — Aparece após rolar
- Folha de estilo para impressão —
@media printcom fundo branco, sem animações, URLs visíveis - Movimento reduzido —
@media (prefers-reduced-motion: reduce)desabilita animações - Responsivo — Todos os tamanhos usam
clamp(), funciona em mobile e desktop
Checklist de Verificação
Antes de entregar, verifique:
- Toda a tipografia usa
clamp(min, preferred, max) - Todos os espaçamentos usam
clamp()ou unidades de viewport - HTML semântico (
<header>,<main>,<section>,<nav>) - Estilos de impressão incluídos e funcionais
- Movimento reduzido respeitado
- Rótulos ARIA na navegação, botões, barra de progresso
- Contraste de cores atende WCAG AA
- Links externos têm
target="_blank" rel="noopener"
Fase 4: Entrega
- Limpeza — Exclua
.claude-design/resume-previews/se existir - Abrir — Abra no navegador:
open [nome_arquivo].html - Resumo:
Seu currículo interativo está pronto!
Arquivo: [nome_arquivo].html
Estilo: [Nome do Estilo]
Seções: [lista]
Recursos:
- Animações acionadas por rolagem
- Barras de habilidades animadas
- Linha do tempo interativa
- Navegação flutuante
- Pronto para impressão (Ctrl+P)
- Responsivo em todos os tamanhos de tela
Para personalizar:
- Cores: Edite as variáveis CSS :root no topo
- Fontes: Altere o link de importação da fonte
- Animações: Modifique os tempos da classe .reveal
- Conteúdo: Edite o texto diretamente no HTML
Deseja que eu faça algum ajuste?
Solução de Problemas
Extração de PDF retorna pouco texto: O PDF pode ser baseado em imagem (scaneado). Peça ao usuário para fornecer o conteúdo em texto diretamente.
Extração de DOCX com estrutura faltando: Alguns arquivos DOCX não usam estilos de título padrão (Heading 1/2/3). O extrator recorre ao tamanho da fonte de execuções individuais. Se a estrutura ainda estiver pouco clara, peça ao usuário para confirmar quais linhas são cabeçalhos de seção.
Campos JSON Resume ausentes: O JSON pode omitir seções opcionais (projetos, certificados, etc.). Apresente o que está disponível e pergunte ao usuário se deseja adicionar seções ausentes manualmente.
Interferência de frontmatter Markdown: Delimitadores de frontmatter YAML (---) são ignorados automaticamente. Se o conteúdo do currículo usar --- como linhas horizontais, eles também serão ignorados — isso geralmente é inofensivo.
Fontes não carregando: Verifique a URL da fonte. Certifique-se de que a declaração font-family inclui fallback de fonte do sistema.
Animações não acionando: Verifique se o IntersectionObserver foi inicializado. Verifique se a classe .visible está sendo adicionada.
Saída de impressão com aparência estranha: Certifique-se de que o bloco @media print existe. Verifique se as animações estão desabilitadas e os fundos estão brancos.