Communitygithub.com

Personal Site Builder — do currículo ao site pessoal

Transforma currículo, perfis sociais, portfólio e produções dispersas em um site pessoal estático pronto para deploy: entrevista e verifica evidências, define a hierarquia por objetivo × profundidade, escolhe um de 6 estilos visuais (ou extrai de um site de referência), gera, valida no navegador e só publica com autorização.

O que é Personal Site Builder — do currículo ao site pessoal?

Personal Website, passo 1 (compor): spacezephyr-personal-site-builder. Conteúdo → estrutura → visual → código, sem inventar fatos e com privacidade por padrão; entrega HTML/CSS/JS puro para Cloudflare Pages, Vercel ou GitHub Pages. Depois: página Sobre e hub link-in-bio.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add SpaceZephyr/personal-site-builder

Perguntar na sua IA favorita

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

Documentação

Gerador de Site Pessoal

Transforme "um currículo + uma lista de links + trabalhos dispersos" em um site estático com estrutura de informação, estilo visual e pronto para implantação.

Resultado: um conjunto de HTML/CSS/JS puramente estático (sem build, sem framework, CSS em arquivo único), diretamente implantável no Cloudflare Pages / Vercel / GitHub Pages.

Princípios Centrais

  • A ordem não pode ser invertida: primeiro conteúdo → depois estrutura → depois visual → por último código. Não comece com um template ou perguntando sobre cores e fontes.
  • Diferencie quatro tipos de informação: fatos confirmados pelo usuário / resumos de fontes originais / textos redigidos pela IA / inferências a serem confirmadas. Não invente experiências, números, clientes, avaliações, identidades ou relações de parceria.
  • Proteja a privacidade por padrão: confirme separadamente antes de divulgar número de telefone, endereço, e-mail pessoal ou materiais de clientes.
  • Não crie seções vazias para preencher o template: se faltarem informações, reduza a profundidade do conteúdo ou liste os itens ausentes, não use casos fictícios para preencher.
  • Ofereça opções com recomendação: para cada ponto de decisão, forneça 2–3 opções com diferenças substanciais + uma recomendação clara, não jogue toda a escolha para o usuário.
  • Implantação é uma ação de publicação: só execute com autorização explícita do usuário.

Fluxo de Trabalho

① Definir escopo → ② Coletar materiais → ③ Definir hierarquia de informações → ④ Definir estilo visual → ⑤ Gerar → ⑥ Validar → ⑦ Implantar após autorização

① Definir Escopo

Primeiro, determine se é novo site ou reforma de site existente.

  • Se houver projeto: leia a estrutura de diretórios, páginas existentes, fontes de conteúdo, comandos de build, configuração de implantação e status do git; mantenha a stack técnica e as restrições de design existentes, não comece do zero.
  • Novo projeto: por padrão, site estático responsivo e leve; só introduza um framework ou backend se realmente precisar de CMS, login ou dados dinâmicos.

Em seguida, faça apenas uma pergunta para definir a direção:

"Para quem é este site principalmente? O que você espera que ele(a) faça depois de vê-lo?"

Não pergunte sobre cores, fontes ou animações nesta etapa.

② Coletar Materiais

Leia references/intake.md (contém: materiais mínimos para início, ordem progressiva de perguntas, campos de entidades de conteúdo, níveis de evidência, regras de privacidade, tabela de fontes coletáveis).

Pontos importantes:

  • A primeira resposta deve ser leve. O usuário já disse o que tem; na primeira resposta, peça apenas que ele envie esses materiais; depois de ler o primeiro lote, faça a próxima pergunta. Pergunte apenas uma coisa de cada vez, a que mais impacta o próximo passo, não jogue uma lista de uma dúzia de itens.
  • Leia primeiro o que puder, não pergunte. Currículo (Read / docx / pdf), GitHub, blog, artigos do WeChat (WebFetch), plataformas que exigem login (claude-in-chrome). Se encontrar bloqueio de login, CAPTCHA ou anti-raspagem, pare imediatamente e peça ao usuário que forneça arquivos exportados, textos, lista de links ou capturas de tela.
  • Números antes de adjetivos, e use apenas métricas verificáveis. "10 produtos, 50 mil usuários, quase 200 Skills" é melhor que "experiência rica"; não adicione estimativas para itens não verificáveis.
  • Conteúdo repetido em várias plataformas combine em uma única entidade de conteúdo, mantendo links de várias fontes; se houver conflito de informações, mantenha ambas as versões para o usuário confirmar.

Após a coleta, produza uma lista de verificação de materiais (já obtidos / a confirmar / ausentes / sugestões de complemento). Aguarde a confirmação do usuário antes de prosseguir.

③ Definir Hierarquia de Informações

Leia references/architectures.md. Use uma decisão em dois eixos:

Eixo 1: Objetivo do site (escolha um objetivo principal, no máximo um secundário)

Perfil do usuário principalObjetivo principal
Experiência de trabalho, habilidades, formação acadêmica, buscando empregoConversão para recrutamento
Projetos / Design / Fotografia / Vídeo, muitos materiais visuaisPortfólio
Uma história de vida + interesses + valores, poucos produtos concretosApresentação pessoal
Artigos escritos / livros lidos / caminhos percorridos, quer arquivarRegistro de longo prazo
Quer receber consultorias, encomendas, mentorias, trabalhos comerciaisCaptação de clientes via consultoria
WeChat / X / Xiaohongshu / Podcast, com seguidores e ativos de conteúdoPágina do criador de conteúdo
Já lançou produtos, projetos open source, quer que as pessoas usem/compremDesenvolvedor independente

Eixo 2: Profundidade do conteúdo (determinada pela quantidade de materiais, não pelo desejo)

  • L1 Cartão de visita — Página única, apenas identidade / posicionamento / ação principal / 3 links representativos. Para materiais escassos ou lançamento rápido.
  • L2 Camada de prova — Página inicial + páginas de detalhes de projetos/experiências. Requer contribuições pessoais, processos, resultados, materiais de mídia.
  • L3 Sistema de conteúdo — Página inicial + detalhes + índice de categorias + arquivo + mecanismo de atualização contínua. Requer fonte de conteúdo estável e disposição para atualizar.

Se os materiais não suportam L2, vá para L1; se não houver capacidade de atualização contínua, não escolha L3.

Use o template de architectures.md para produzir 2–3 opções realmente diferentes (a diferença deve vir das tarefas do visitante, não apenas da renomeação de seções). Para cada opção, especifique: para quem é / promessa da primeira tela / ação principal / navegação / ordem da página inicial / quais materiais existentes usa / o que mais precisa / principais trade-offs. Recomende claramente uma opção. Aguarde a confirmação do usuário antes de prosseguir para o visual.

④ Definir Estilo Visual

Primeiro pergunte: "Você tem algum site ou design de que goste? Se sim, me mande o link ou uma captura de tela." Ter uma referência é muito mais preciso do que fazer o usuário escolher entre adjetivos.

Três caminhos, escolha com base no que o usuário tem:

  1. O usuário deu URLs de referência / capturas de tela / guias de estilo → Leia references/style-extraction.md. De preferência, use o claude-in-chrome para abrir o site de referência e execute o script para amostrar os estilos computados reais (font stack, valores de cor, bordas arredondadas, sombras, largura do container), amostrando tanto o tema claro quanto o escuro. Se não conseguir abrir ou precisar de login, recorra à análise de captura de tela. Extraia a essência, não clone o site inteiro, não use logotipo, textos, ilustrações ou layouts originais.
  2. O usuário mencionou uma marca ("Faz um estilo Notion", "Estilo Apple") → Chame o skill brand-design-md para obter o DESIGN.md e mapeie para as variáveis :root do site.css.
  3. O usuário não tem referências → Leia references/visual-styles.md, escolha 2–3 direções dentre 6 estilos integrados + razões para a recomendação, cada um com valores de variáveis CSS prontos para copiar.

Se o usuário deu vários sites de referência, primeiro pergunte: "Qual deles você mais gosta da sensação? O que especificamente você gosta nos outros?" — A maioria das pessoas gosta do layout de A + da paleta de cores de B; fazer a interseção diretamente resulta em algo sem identidade.

Quando o usuário mencionar WordPress / Framer / Webflow / Notion, tome emprestada a organização da informação e a essência, mas não finja gerar um tema ou projeto para a plataforma correspondente.

Independentemente do caminho, no final, altere apenas as variáveis :root, não reescreva a parte de componentes do site.css. Escreva o código somente após a escolha.

⑤ Gerar o Site

Copie assets/starter/:

  • site.css — Variáveis CSS + linha de base tipográfica + componentes de cartão/lista, temas claro/escuro. Mudar estilo = mudar variáveis :root, não reescreva o arquivo inteiro.
  • nav.js — Barra superior fixa injetada em arquivo único (alternância de tema escuro + ocultação ao rolar). Na área de configuração no topo, altere SITE_NAME / LINKS / THEME_KEY. O 760px no CSS inline deve corresponder ao --max do site.css.
  • index.html — Esqueleto da página inicial. Seções adicionadas/removidas conforme o plano.

Deve atender a:

  • Na primeira tela, deve aparecer o nome do usuário ou apelido comum + posicionamento + uma ação principal; apenas uma ação principal, no máximo uma ação secundária.
  • A navegação reflete a arquitetura de informações confirmada, não copiando seções de templates de plataformas; 4–6 itens.
  • Os trabalhos devem focar em problema / meu papel / abordagem / resultado, não apenas miniaturas.
  • Os links de redes sociais devem explicar o que pode ser visto nesta plataforma, não apenas uma fileira de ícones.
  • Cada página como xxx/index.html, compartilhando /site.css e /nav.js; sem CDN, frameworks ou etapas de build.
  • <title>, <meta name="description">, favicon, imagem de compartilhamento completos; links externos com target="_blank" rel="noreferrer".
  • Navegação suave em desktop e mobile; fluxo principal realizável via teclado; estrutura semântica e alt completos; suporte a prefers-reduced-motion.
  • Imagens: use trabalhos reais / pessoas reais / capturas de tela reais; se faltar, primeiro solicite o material; imagens geradas devem ser claramente identificadas como tal.
  • Não use frases como "Este é meu site pessoal" ou "Abaixo estão meus trabalhos" como elementos de design.

Tipografia em chinês: line-height ≥ 1,7, espaçamento entre parágrafos ≥ 18px, font stack deve incluir PingFang SC. Se precisar de habilidades de design front-end mais avançadas, chame o skill frontend-design.

⑥ Validar

Leia references/delivery-checklist.md e verifique item por item. Valide pelo menos:

  • Página inicial, navegação, páginas de detalhes, links externos, ação principal
  • Cinco larguras: 360 / 390 / 768 / 1280 / 1440
  • Nomes e títulos mais longos não transbordam; comportamento com conteúdo vazio, falha ao carregar imagem, links externos quebrados
  • Console sem erros que afetem o uso; sem rolagem horizontal inesperada ou sobreposição de layout
  • Ambos os temas (claro e escuro) legíveis (contraste ≥ 4,5:1)
  • Sem resquícios de TODO, números fictícios ou links de teste no site
  • Informações públicas consistentes com a lista confirmada pelo usuário

Use python3 -m http.server para pré-visualizar localmente, ou screenshots com claude-in-chrome, e peça ao usuário para confirmar antes da publicação.

⑦ Implantar Após Autorização

Primeiro explique onde será publicado, se é público, qual repositório/conta será usado, quais domínios ou variáveis de ambiente serão alterados; obtenha autorização explícita antes de executar.

  • Se houver projeto existente, mantenha o método de implantação atual; para novos sites estáticos, priorize Cloudflare Pages / Vercel / GitHub Pages (comando de build vazio, diretório de saída definido como raiz do site).
  • Primeiro construa → depois publique → verifique a URL de produção para o conteúdo crítico. Visualização bem-sucedida não significa que o domínio personalizado esteja ativo.
  • Não inclua chaves, currículos originais ou dados exportados de plataformas no site.

Especificações Finais de Entrega

Liste de forma concisa: objetivo e profundidade de conteúdo selecionados / páginas implementadas e conteúdo chave / URL de acesso / resultados da validação / conteúdo ainda não público ou a ser complementado. Não use longas repetições para encobrir código, validação ou implantação incompletos.

Lista de Práticas a Evitar

  • ❌ Página inicial abarrotada com todo o conteúdo — nos primeiros 3 segundos da primeira tela, diga "quem é você + o que você faz + como te encontrar", o resto é secundário
  • ❌ Frases vazias como "apaixonado por tecnologia, buscando excelência" — substitua por fatos e números verificáveis
  • ❌ Inventar experiências, projetos, números ou avaliações de clientes que o usuário não forneceu
  • ❌ Fazer uma dúzia de perguntas de uma vez; ou pular a confirmação de materiais e planos e ir direto para o código
  • ❌ Forçar L3 com materiais insuficientes, usando blogs vazios e casos fictícios para preencher
  • ❌ Animações complexas, acúmulo de gradientes, uma fonte diferente para cada seção — a credibilidade de um site pessoal vem da moderação
  • ❌ Copiar um site de referência inteiro e mudar o nome — extraia a essência das cores/tipografia/espaçamento, não o logotipo, textos, ilustrações ou layouts originais
  • ❌ Fazer push / implantar / divulgar informações de contato sem autorização

Habilidades Relacionadas