Communitygithub.com

Frontend Resume

Converta currículos em sites HTML interativos e animados de página única com estilos visuais marcantes.

O que é Frontend Resume?

Esta skill permite que agentes de IA (como Claude Code) extraiam conteúdo de currículos em formatos como PDF, DOCX, Markdown, JSON Resume e texto puro, estruturem os dados em seções padronizadas e gerem sites HTML autônomos e interativos. O processo é guiado por uma abordagem de descoberta visual: o agente faz perguntas sobre o tom e a prioridade das seções, gera até 3 prévias de estilos diferentes e, após a escolha do usuário, produz um arquivo HTML único com animações de scroll, navegação flutuante, barras de habilidades animadas, suporte a impressão e acessibilidade. A skill é ideal para profissionais de tecnologia, design e marketing que desejam um portfólio online diferenciado sem precisar de conhecimentos avançados em desenvolvimento web. Suporta macOS, Linux e Windows.

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

Perguntar na sua IA favorita

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

Documentação

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

  1. Zero Dependências — Arquivos HTML únicos com CSS/JS inline. Sem npm, sem ferramentas de build.
  2. Mostre, Não Conte — Gere prévias visuais, deixe o usuário escolher o que gosta.
  3. Design Marcante — Evite estéticas genéricas de "IA genérica". Cada currículo deve parecer feito sob medida.
  4. Pronto para Impressão — Todo currículo DEVE incluir estilos @media print para saída limpa em PDF.
  5. 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:

FormatoExtensõesDependência PythonObservações
PDF.pdfpdfplumber (preferido) ou PyPDF2pip install pdfplumber
Word.docxpython-docxpip install python-docx
Markdown.mdNenhumaAnalisa títulos, listas, negrito/itálico
Texto Plano.txtNenhumaLinhas em MAIÚSCULO são inferidas como títulos
JSON Resume.jsonNenhuma (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çãoVibraçãoMelhor Para
Arquiteto da Meia-NoiteSofisticado, premiumExecutivos, consultores
Terminal NeonEstilo hacker, desenvolvedorEngenheiros de software, DevOps
Luxo EscuroElegante, editorialDiretores criativos, marketing
Profundidade CósmicaOusado, futuristaFundadores de tecnologia, engenheiros IA/ML
Tela LimpaMinimalista, estilo suíçoDesigners, gerentes de produto
Artesanato em PapelAconchegante, tátilEscritores, educadores, acadêmicos
Projeto SuaveTécnico, acessívelEngenheiros, cientistas de dados
Monocromático BrutalistaCru, anti-designEstrategistas de marca, quem busca destaque
Jardim SábioInspirado na natureza, calmanteRH, bem-estar, educadores
Tinta RetrôEditorial vintageJornalistas, 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:

ClimaEscuroClaroEspecialidade
ProfissionalArquiteto da Meia-Noite, Luxo EscuroTela Limpa, Projeto Suave—
CriativoLuxo Escuro, Profundidade CósmicaArtesanato em PapelMonocromático Brutalista, Tinta Retrô
Moderno/TécnicoTerminal Neon, Profundidade CósmicaProjeto SuaveMonocromático Brutalista
AconcheganteLuxo EscuroArtesanato em Papel, Jardim SábioTinta 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ção
  • references/RESUME_COMPONENTS.md — Padrões de CSS/JS de componentes interativos
  • references/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

  1. Revelações com acionamento por rolagem — Elementos animam via IntersectionObserver
  2. Navegação flutuante — Nav fixa com rastreamento de seção ativa
  3. Barras de habilidades animadas — Preenchem ao entrar na visualização
  4. Barra de progresso de rolagem — Barra fina no topo
  5. Botão de voltar ao topo — Aparece após rolar
  6. Folha de estilo para impressão — @media print com fundo branco, sem animações, URLs visíveis
  7. Movimento reduzido — @media (prefers-reduced-motion: reduce) desabilita animações
  8. 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

  1. Limpeza — Exclua .claude-design/resume-previews/ se existir
  2. Abrir — Abra no navegador: open [nome_arquivo].html
  3. 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.

Habilidades Relacionadas