Communitygithub.com

Homepage pessoal em movimento

Constrói um site pessoal cujo personagem segue o cursor e atua entre secções ao scroll, e depois publica a página.

O que é Homepage pessoal em movimento?

Entrevista a pessoa, fixa uma personagem e um fundo, gera olhares e transições, monta uma página estática e publica. O progresso do scroll é a atuação.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/yaohuicong/motion-homepage/tree/HEAD

Perguntar na sua IA favorita

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

Documentação

Página Inicial Animada

O produto final é um site estático (HTML/CSS/JS, sem necessidade de build), composto por três camadas:

  1. Palco do Personagem: Tela cheia com canvas desenhando quadros de vídeo do personagem gerado por IA. Na primeira tela, reproduz os quadros correspondentes ao "loop de rastreamento ocular" na direção do mouse; ao rolar para a próxima seção, reproduz o "clipe de transição" entre as duas seções, com o progresso da rolagem funcionando como progresso da reprodução. Em dispositivos móveis na vertical, o personagem fica na metade superior da tela.
  2. Seções de Conteúdo: Primeira tela / Currículo / Portfólio / Trabalho em Destaque / Final. O texto fica sobreposto ao palco, evitando o lado onde o personagem está.
  3. Decorações e Efeitos Especiais Desenhados à Mão: Rabiscos (aparecem com traço contínuo, depois tremem como animação feita à mão), manchas de tinta que se deformam lentamente, balões de diálogo que seguem a cabeça do personagem, círculos desenhados à mão e sublinhados com pincel, distorção ondulatória ao passar o mouse sobre o personagem (React Bits "Ripple Distortion", WebGL, distorcendo apenas o palco; fallback para rastro de marcador fluorescente), texto que aparece letra por letra e adesivos flutuantes.

O template padrão é no estilo "rabisco escuro + protagonista 3D" (fundo quase preto + verde fluorescente/roxo/azul/laranja, títulos em letra de marcador, personagem cartoon 3D com adesivos rabiscados 2D). O site é todo em inglês. A troca de estilo é feita alterando theme (cores, fontes) e decor de cada seção, sem precisar modificar o motor.

A qualidade do site depende 70% da consistência dos assets (mesmo personagem, mesmo fundo, o último quadro de uma seção é o primeiro da próxima) e 30% do layout. Por isso, esta skill dedica a maior parte do esforço ao planejamento e verificação dos assets; o código já está pronto em template/, normalmente alterando apenas site.config.js e um pouco de CSS.

Estrutura de Diretórios

template/                 Template executável (com assets de placeholder em assets/demo/)
  site.config.js          Todo o texto, caminhos dos assets, parâmetros de sensibilidade
  js/  css/               Motor e estilos, geralmente não precisam ser alterados
  tools/calibrate.html    Ferramenta de calibração de quadros-chave para rastreamento ocular
scripts/frames.py         Vídeo/imagem → sequência de quadros para a web (requer ffmpeg)
scripts/check-site.mjs    Verifica se a configuração e os assets estão completos
scripts/fetch-reactbits.mjs   Baixa o React Bits "Ripple Distortion" para o site (licença impede distribuição com o template)
scripts/cutout.py         Adesivos/personagens com fundo sólido → webp com fundo transparente (--split para separar coleções de adesivos)
scripts/serve.py          Servidor local de preview (sem cache, recarregar mostra a versão nova)
scripts/shoot.mjs         Capturas de tela de validação: Chrome headless + eventos reais de mouse, captura por seção (desktop/mobile)
scripts/make-demo-assets.py   Regenera assets de placeholder (geralmente não necessário)
references/
  01_planejamento.md      Lista de perguntas para entrevista, definição de seções e linha de movimento do personagem
  02_prompts_de_assets.md Modelos de prompt para personagem, fundo, rastreamento, transições, imagens de trabalho e validação (inclui método prático para ferramentas que só aceitam primeiro quadro)
  03_construcao_e_iteracao.md  Descrição dos campos de configuração, problemas comuns e soluções, como dar feedback
  04_deploy.md            Netlify / Vercel / GitHub Pages / Cloudflare, e como adicionar trabalhos futuros
  05_referencias_de_design.md  Ideias de portfólios open source que valem a pena estudar (leia quando o usuário disser "não é elegante o suficiente")

Fluxo de Trabalho

Mostre ao usuário o resultado real (captura de tela, mosaico de quadros ou preview local) após cada etapa, e confirme antes de prosseguir. Se o usuário não for técnico, não o faça ler configurações — mostre apenas a imagem.

1. Entrevista e Planejamento → Leia references/01_planejamento.md

Primeiro, descubra: de quem é a página inicial? Qual conteúdo será incluído (currículo, trabalhos, contato)? De onde vem o personagem (foto real, IP existente ou novo design)? Qual estilo o usuário prefere (peça 1-2 imagens de referência ou sites). Quais ferramentas de geração de imagem/vídeo ele tem? Depois, escreva um plan.md no diretório do site: ordem das seções, texto de cada seção, pose e posição do personagem em cada seção, e quais ações o personagem faz em cada transição. Esta "linha de movimento do personagem" será a base para todos os assets subsequentes — pose e posição devem combinar com o layout (se o texto está à esquerda, o personagem fica à direita).

2. Assets → Leia references/02_prompts_de_assets.md

A ordem é importante, pois cada etapa usa o resultado da anterior como referência:

  1. Imagem final do personagem: De frente, corpo inteiro ou meio corpo, expressão marcante. Se já existe um IP, mantenha características reconhecíveis (rosto, cabelo, acessórios icônicos); as roupas podem mudar conforme o tema.
  2. Fundo de base: Uma imagem sem personagem, compartilhada por todo o site e usada como fundo de todos os vídeos, evitando que o fundo pisque ao trocar de clipe.
  3. Imagens-chave de pose: Uma para cada seção (personagem + mesmo fundo + mesma câmera), correspondendo à pose e posição planejadas.
  4. Loop de rastreamento ocular: Começa de frente, olha em 8 direções e volta para frente. Quando a ferramenta de vídeo aceitar primeiro e último quadro, gere segmentos e use frames.py gaze-join para unir; quando só aceitar o primeiro quadro (como muitas ferramentas de imagem para vídeo), use o método "estrela": 8 vídeos curtos, cada um partindo do quadro-chave da primeira tela para uma direção diferente, com uma expressão. Use frames.py gaze-star para compor (uma única linha de vídeo com 8 direções faz o modelo desviar cada vez mais do original).
  5. Clipe de transição: Use duas imagens-chave de poses adjacentes como primeiro e último quadro para gerar a animação intermediária. Quando só puder enviar o primeiro quadro, gere em cadeia (último quadro do clipe anterior = primeiro quadro do próximo). Se o rosto do personagem não estiver visível no primeiro quadro de um clipe, use o método "reverso" (primeiro, gere a imagem final da pose final, depois gere a ação reversa e inverta), caso contrário o modelo alterará o rosto no final.
  6. Capa do trabalho: Se o usuário já tiver imagens dos trabalhos, use diretamente; formato 16:10 na horizontal é o mais adequado.

Se o usuário só puder gerar imagens, não vídeos, o template ainda funciona: o rastreamento usa 9 imagens (frente + 8 direções, com transição por dissolução), e as transições usam duas imagens de pose com blend: true. Veja a "Rota C" em 02 para comandos e configurações específicos. O resultado será mais fraco, mas informe claramente a diferença ao usuário.

Quando não houver nenhum asset (primeira versão sem assets): Monte o site primeiro para o usuário ver o layout e a interação — copie o template, preencha o texto, cores e trabalhos em site.config.js com as informações do usuário, mantendo o personagem placeholder do template. Aqui, atenção:

  • Nos balões de diálogo e textos, não diga algo como "sou uma raposa" que não combine com o placeholder; use frases neutras.
  • Na entrega, explique primeiro: "O personagem na tela é um placeholder. Para substituí-lo pelo seu personagem, você precisará gerar estas imagens/vídeos" e anexe a lista de assets do plan.md.
  • O check-site.mjs alertará sobre assets placeholder ainda em uso; repita esse aviso textualmente para o usuário antes da entrega.

Se o ambiente atual tiver ferramentas de geração de imagem/vídeo (como MCP de geração de imagem e vídeo), use-as diretamente; se a ferramenta só aceitar o primeiro quadro, siga a "geração em cadeia" do 02, um segmento após o outro. Quando não houver ferramenta de vídeo, o usuário gerará em plataformas como Jimeng, Keling, Vidu, Conch etc. — então forneça prompts completos, especifique qual imagem enviar como primeiro e último quadro, duração e proporção, e explique como verificar o vídeo recebido.

Verifique cada lote de assets antes de integrar: Extraia quadros e monte em uma imagem (ffmpeg -i x.mp4 -vf "fps=2,scale=320:-1,tile=6x3" sheet.jpg) e verifique item por item conforme a lista de verificação em 02. Se houver problemas, descreva-os especificamente (em qual segundo, o que mudou, como ficou) e ajuste o prompt para regenerar.

3. Construção do Site → Leia references/03_construcao_e_iteracao.md

cp -r <skill>/template <diretorio_do_site>          # Copie o template, não altere o original
cd <diretorio_do_site>
node <skill>/scripts/fetch-reactbits.mjs .                            # Distorção ao passar o mouse; fallback automático para liquid se falhar o download
python3 <skill>/scripts/frames.py extract transicao1.mp4 assets/clips/t1     # Cada transição
python3 <skill>/scripts/frames.py gaze-join assets/clips/gaze segmento1.mp4 segmento2.mp4 …   # Rastreamento (segmentos com primeiro e último quadro)
python3 <skill>/scripts/frames.py gaze-star assets/clips/gaze L=esquerda.mp4 UL=superior_esquerda.mp4 …   # Rastreamento (só primeiro quadro: método estrela)
node <skill>/scripts/check-site.mjs .
python3 <skill>/scripts/serve.py 8000                                  # Abra http://localhost:8000 (sem cache)

Cole a configuração impressa pelo frames.py no site.config.js, depois preencha o texto, cores (theme.bg deve usar a cor de fundo informada pelo script para que página e vídeo se encaixem perfeitamente) e fontes. Se o vídeo de rastreamento não for composto por segmentos, use http://localhost:8000/tools/calibrate.html para calibrar os quadros-chave e a posição da cabeça.

Use as imagens de referência para definir theme e decor: primeiro, conforme 03 "Estilo a partir da imagem de referência", anote a cor de fundo, cor de destaque, fonte do título, linguagem decorativa e estilo do personagem; depois altere a configuração. O template padrão é todo em inglês (o texto fixo da interface pode ser alterado em ui). Para texto misto em chinês e inglês, a fonte do título em inglês deve ser seguida por uma fonte chinesa (ex: "Permanent Marker", "ZCOOL QingKe HuangYou"). Quando a imagem de referência for de outra pessoa, use apenas a direção do estilo, não copie personagem, nome, texto ou layout.

4. Iteração

Role a página inteira no navegador e verifique item por item conforme a lista de verificação em 03: o rastreamento ocular na primeira tela funciona suavemente nas 8 direções? Ao sair da primeira tela, o personagem volta ao centro antes da transição? As transições têm saltos no início/fim? Texto e rabiscos cobrem o rosto do personagem? O portfólio abre e fecha corretamente? O carrossel de trabalhos funciona? O personagem no final não está coberto pelo painel? Funciona na vertical no celular?

Corrija apenas um tipo de problema por vez, depois verifique novamente. Assim, o efeito de cada alteração fica claro e você não estraga partes já satisfatórias. O 03 contém problemas comuns e suas soluções.

5. Deploy → Leia references/04_deploy.md

A recomendação padrão é Netlify Drop (arraste a pasta para a página e obtenha um link público). Antes do deploy, execute check-site.mjs novamente para confirmar que não há assets placeholder ou arquivos faltando.

Ao Entregar, Explique Claramente

  • Onde está o diretório do site, como fazer preview local, como alterar texto e trocar trabalhos (qual parte do site.config.js modificar).
  • Quais verificações foram realmente realizadas (em qual navegador e tamanho de tela; as capturas do shoot.mjs apenas provam que a tela está correta, a suavidade da animação deve ser vista no navegador real), e quais não foram (por exemplo, não testado em dispositivo móvel real).
  • O tamanho dos assets e o tempo de carregamento da primeira tela; se estiver grande, forneça métodos de compressão.

Habilidades Relacionadas