Communitygithub.com

ChuchoMonster/claude-code-skills

Pipeline completa que pega uma URL e produz uma revisão completa de landing page com vídeo de fundo gerado para o hero, e a implanta ao vivo no Netlify. Encadeia quatro etapas sem perguntas intermediárias.

O que é claude-code-skills?

Esta skill implementa um pipeline automatizado de quatro etapas que transforma uma URL de referência em uma landing page revisada e animada, implantada no Netlify. Primeiro, extrai o guia de marca (brand book) do site original e o publica em um repositório público no GitHub. Em seguida, gera um vídeo de fundo para o hero usando uma combinação de Nano Banana 2 (imagem) e Seedance 2 (vídeo), a partir da identidade visual extraída. Na terceira etapa, constrói uma página HTML completa com Tailwind CSS, ícones Lucide e fontes do Google, incorporando o vídeo como background do hero. Por fim, implanta o resultado no Netlify como um site independente. O pipeline foi projetado para ser executado sem interrupções — o usuário fornece apenas a URL e recebe quatro links: site ao vivo, repositório do brand book, caminho do vídeo e caminho local. A skill é idempotente: se um artefato já existir (como o vídeo ou o HTML), ele é reutilizado para economizar tempo e créditos. Ideal para prototipagem rápida e comparação de design, ela funciona com Claude Code, Cursor e Codex, exigindo apenas uma chave de API KIE.ai, Playwright, Netlify CLI e Node.js no ambiente.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ChuchoMonster/claude-code-skills/tree/HEAD/skills/animated-website

Perguntar na sua IA favorita

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

Documentação

Pipeline de Site Animado

Pontas a pontas — URL de entrada, URL Netlify implantada de saída. Quatro etapas, sem perguntas no meio. As saídas são organizadas em $PWD/sites/<slug>/, permitindo que múltiplos sites coexistam em um único projeto pai.

Quando acionado

  1. Extraia a URL da mensagem do usuário ou do argumento $1. Se de alguma forma não houver URL, pergunte uma vez e pare. Caso contrário, prossiga silenciosamente.
  2. Derive o slug e o nome do site a partir do host da URL:
    • host acmegrowthpartners.com → slug acme-growth, nome do site Acme Growth Partners (título capitalizado)
    • Remova www., remova o TLD, substitua pontos por hífens, minúsculas. Para nomes de site amigáveis, use um título capitalizado sensato baseado no reconhecimento da marca (ex.: acmegrowthpartners.com → Acme Growth Partners, não Acmegrowthpartners). Use o slug apenas para nomes de arquivo e URLs.
  3. Confirme os pré-requisitos em paralelo:
    • npx playwright --version (dependência da extração do brand book)
    • grep -l KIE_AI_API_KEY "$PWD/.env" || grep -l KIE_AI_API_KEY "$HOME/<seu-diretório-do-projeto>/.env" (chave de API KIE.ai)
    • command -v netlify (Netlify CLI para a etapa de deploy)
    • mkdir -p "$PWD/sites/<slug>"

Se algum pré-requisito falhar, exiba o problema exato e pare. Não tente instalar Playwright, Netlify ou adivinhar chaves de API.

Etapa 1 — Brand Book (pulável)

Condição de pulo: todos os arquivos $PWD/sites/<slug>/brand/typography.md, colors.md, tailwind.snippet.js, reference.png existem E reference.png foi modificado nas últimas 24h. Se pulado, registre "→ brand book reutilizado do cache" e prossiga.

  1. Execute o extrator de brand book:
    node ~/.claude/skills/brand-book/extract.js "<URL>" "$PWD/sites/<slug>/brand"
    
  2. Leia sites/<slug>/brand/type-styles.json, sites/<slug>/brand/css-variables.json e veja sites/<slug>/brand/reference.png.
  3. Escreva sites/<slug>/brand/typography.md, colors.md, tailwind.snippet.js, README.md seguindo o formato da skill do brand book — inconsistências primeiro, tabela de escala tipográfica, grupos de paleta, tokens Tailwind com nomes semânticos. Aplique a regra "racionalize, não codifique".
  4. Publique automaticamente no GitHub sem perguntar (isso cria um repositório público na sua conta do GitHub — configure <seu-usuário-github> abaixo, ou remova esta etapa se não quiser brand books publicados):
    • Nome do repositório: Brand-Book-<SlugEmTítuloCapitalizado> (ex.: Brand-Book-Acme-Growth-Partners). Hífens entre palavras.
    • Use mcp__github__create_repository (owner: <seu-usuário-github>, public, autoInit: true), depois mcp__github__push_files com todos os 6 arquivos (pule reference.png — grande demais para o limite de argumento da ferramenta).
    • Se o repositório já existir (HTTP 422 do create), continue — chame mcp__github__push_files diretamente para atualizar.

Capture: BRAND_REPO_URL, mais os valores hex primário, acento, neutro, superfície-escuro racionalizados de colors.md (você os relerá na etapa 3).

Etapa 2 — Vídeo do Loop do Hero (pulável)

Condição de pulo: $PWD/sites/<slug>/hero-loop-7s.mp4 existe. Registre "→ vídeo do hero reutilizado do cache" e prossiga.

  1. Derive o conceito visual dos artefatos do brand book que você acabou de escrever:
    • Inspecione a paleta racionalizada em colors.md → escolha a emoção dominante da marca (ex.: trajetória + desbloqueio para marcas orientadas a crescimento; calor + artesanato para paletas quentes; contenção + precisão para monocromático minimalista).
    • Dê uma olhada em reference.png em busca de motivos visuais (direção de gradiente, traçado, tratamento de partículas/grão, formas geométricas).
    • Sintetize uma metáfora de vídeo de uma frase que mapeie o posicionamento verbal da marca para movimento.
    • Isso é trabalho criativo — leve a sério, não recorra a um modelo genérico. Olhe a captura de tela.
  2. Construa o prompt de imagem do Nano Banana 2 como um still 1:1 que capture o "antes" do loop. Faça referência aos códigos hex exatos da marca. Termine com "sem texto, sem logotipos, cinematográfico, estética B2B premium."
  3. Envie para o Nano Banana 2:
    source "$PWD/.env" 2>/dev/null || source "$HOME/<seu-diretório-do-projeto>/.env"
    curl -s -X POST "https://api.kie.ai/api/v1/playground/createTask" \
      -H "Authorization: Bearer $KIE_AI_API_KEY" \
      -H "Content-Type: application/json" \
      --data-binary @- <<EOF
    { "model": "nano-banana-2", "input": { "prompt": "<PROMPT_IMAGEM>", "output_format": "png", "image_size": "1:1" } }
    EOF
    
    Capture taskId. Faça polling de https://api.kie.ai/api/v1/playground/recordInfo?taskId=<ID> até que state == "success". Analise data.resultJson (é uma string JSON) para obter a URL. Não baixe — mantenha a URL da nuvem.
  4. Construa o prompt do Seedance como batidas com marcação de tempo ao longo de 7 segundos. Sempre inclua:
    • 0-2s: estabelecer (deriva da câmera, atmosfera)
    • 2-4s: construir (movimento acelera / converge)
    • 4-5s: liberar (o momento de "desbloqueio" da marca — geralmente a cor de acento florescendo)
    • 5-7s: resolver (estabilizar de volta a um estado que pode ser colocado em loop)
    • Final: "Câmera lenta e controlada, sem tremor. Física de bloom de luz realista. Sem texto, sem logotipos."
  5. Envie para o Seedance 2 com a URL da imagem na nuvem como image_url:
    cat > /tmp/seedance-payload.json <<'EOF'
    { "model": "bytedance/seedance-2",
      "input": { "prompt": "<PROMPT_VIDEO>", "image_url": "<URL_IMAGEM_NUVEM>",
                 "duration": 7, "resolution": "480p", "aspect_ratio": "16:9" } }
    EOF
    curl -s -X POST "https://api.kie.ai/api/v1/playground/createTask" \
      -H "Authorization: Bearer $KIE_AI_API_KEY" \
      -H "Content-Type: application/json" \
      --data-binary @/tmp/seedance-payload.json
    
    Capture o taskId. Execute um loop de polling em segundo plano (run_in_background: true) — geração típica de 3-5 min. Quando notificado de conclusão, acesse o endpoint recordInfo diretamente para ler state (o parser de polling python-in-bash é frágil — prefira um curl direto após a notificação em segundo plano).
  6. Baixe o vídeo final para $PWD/sites/<slug>/hero-loop-7s.mp4.

Capture: VIDEO_PATH.

Etapa 3 — Construção do Design Frontend (pulável)

Condição de pulo: $PWD/sites/<slug>/index.html existe. Registre "→ site reutilizado do cache" e prossiga. (Se o usuário quiser uma reconstrução, ele excluirá o arquivo ou passará --force na solicitação.)

Este é o produto de trabalho que o usuário está comparando com os Artifacts do claude.ai. Qualidade importa.

  1. Carregue o contexto para a subskill de design frontend:
    • Leia sites/<slug>/brand/tailwind.snippet.js (conteúdo completo)
    • Leia sites/<slug>/brand/typography.md e colors.md (apenas os resumos da racionalização)
    • Anote o caminho local do vídeo: ./hero-loop-7s.mp4 (irmão do index.html — IMPORTANTE: não use ../references/... como na estrutura antiga)
    • Anote a URL de origem (para referência de conteúdo/cópia — a página deve ser uma revisão, não um clone)
  2. Invoque a skill frontend-design:frontend-design através da ferramenta Skill. Passe um único prompt autocontido com tudo:
    • Caminho de saída - $PWD/sites/<slug>/index.html (único arquivo, autocontido). O vídeo está em ./hero-loop-7s.mp4 ao lado.
    • Tokens da marca - cole o bloco completo theme.extend do Tailwind de sites/<slug>/brand/tailwind.snippet.js
    • Vídeo do hero - referência com src ./hero-loop-7s.mp4 como <video autoplay loop muted playsinline> como background no hero, com um gradiente escuro para legibilidade do texto.
    • URL de origem para conteúdo - diga à subskill de design para criar um rascunho de revisão da landing page de <URL>: mantenha a proposta de valor e as seções principais (hero, prova social, serviços/soluções, CTA, rodapé), mas eleve a qualidade do design, a hierarquia tipográfica e o polimento de movimento.
    • Padrão de qualidade - "grau de produção, distinto, evite estética genérica de IA. O usuário está comparando isso com a saída dos Artifacts do claude.ai - mire mais alto."
    • Stack técnica - HTML vanilla + Tailwind via CDN (https://cdn.tailwindcss.com) + ícones Lucide + Google Fonts. Coloque a configuração do Tailwind inline para consumir os tokens da marca.
    • Autenticidade do conteúdo - se o site ao vivo tiver produtos/módulos/serviços nomeados, use-os textualmente. Se estiver em dúvida, use WebFetch na URL para enumerar os módulos reais antes de escrever o texto. Não invente produtos que não existam.
  3. Após a subskill terminar, verifique se $PWD/sites/<slug>/index.html existe e refere-se a ./hero-loop-7s.mp4.

Capture: SITE_PATH.

Etapa 4 — Deploy no Netlify

  1. Crie ou reutilize um site Netlify para este slug. Use um padrão de nome de site claro e estável: animated-<slug> (ex.: animated-acme-growth).
  2. A partir de $PWD/sites/<slug>/, faça deploy para produção:
    cd "$PWD/sites/<slug>" && netlify deploy --prod --dir=. --site=animated-<slug> 2>&1
    
    • Na primeira execução para um slug, o Netlify dirá que o site não existe. Nesse caso, crie-o explicitamente: netlify sites:create --name=animated-<slug> e depois execute o deploy novamente.
    • Capture a Website URL: da saída do deploy (a URL *.netlify.app ao vivo).
  3. Verificação rápida: curl -sI <LIVE_URL> | head -1 deve retornar HTTP/2 200. Caso contrário, exiba a falha, mas ainda informe o caminho local.

Capture: LIVE_URL.

Saída final

Quando todas as quatro etapas forem bem-sucedidas, envie ao usuário uma mensagem curta — quatro links e nada mais:

Ao vivo   - <LIVE_URL>
Brand book - <BRAND_REPO_URL>
Vídeo hero - <VIDEO_PATH>
Site local - <SITE_PATH>

Não resuma o que foi construído. Não faça recapitulação. Não abra automaticamente o arquivo local — a URL ao vivo é a entrega agora.

Armadilhas

  • Não pergunte ao usuário durante a execução. O objetivo é zero handoffs. Se algo estiver genuinamente faltando (nenhuma URL, nenhuma chave de API, nenhum Netlify CLI), exiba o bloqueio e pare — não peça contribuição criativa.
  • Pule etapas que já foram executadas. Todas as três etapas de artefatos são idempotentes com base na existência do arquivo. Refazê-las desperdiça créditos.
  • O caminho do vídeo deve ser relativo ao seu HTML irmão. Use ./hero-loop-7s.mp4, não ../references/.... Cada site é completamente autocontido em sites/<slug>/.
  • Cada site é seu próprio site Netlify, não um subcaminho. Deploys com --site=animated-<slug> para que você obtenha sua própria URL *.netlify.app. Não tente montar cinco sites em um único projeto Netlify.
  • A URL da imagem hospedada pela KIE é temporária — envie a tarefa Seedance na mesma sessão.
  • data.resultJson é uma string JSON, não um objeto. Analise-a.
  • Repositório GitHub já existe? Não falhe — apenas envie os novos arquivos para atualizar.
  • Não instale automaticamente o netlify-cli. Se command -v netlify falhar, diga ao usuário para executar npm install -g netlify-cli && netlify login e pare.
  • Fidelidade à marca > liberdade criativa para nomes de produtos. Sempre use os nomes reais de produtos/módulos do site ao vivo. Execute WebFetch para verificar antes de escrever o texto da página.
  • A qualidade da captura de tela do brand book é importante para a derivação do conceito. Se a captura de tela estiver vazia (cookie banner sobreposto, seções carregadas preguiçosamente não foram renderizadas), ainda prossiga — use o JSON de estilos tipográficos + paleta de cores + seu conhecimento do posicionamento da marca para derivar o conceito.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas