Communitygithub.com

webbuild

Construa sites profissionais, distintos e prontos para apresentação — incluindo heróis "3D" com rolagem (vídeo IA sincronizado com scroll), cenas Three.js / React Three Fiber em tempo real, animações GSAP + Lenis e shaders de vídeo tratados — que NÃO parecem gerados por IA.

O que é webbuild?

O webbuild é uma skill especializada para construção de sites que pareçam ter sido feitos por um profissional humano, não por IA. Ela cobre todo o processo, desde a coleta de requisitos de negócio até a entrega e apresentação, passando por análise de referências, planejamento de direção visual, criação de heróis 3D ou com vídeo tratado, implementação com animações sutis e verificação de qualidade. A skill suporta projetos novos (HTML/CSS/JS modular sem build) ou existentes (Next.js, Astro, etc.) e oferece scripts para capturar screenshots, medir desempenho e detectar indícios de 'slop' de IA. O foco está em criar um momento memorável único para o site, com um sistema de design próprio do negócio, cópia realista e performance em dispositivos móveis. Ela é especialmente útil para quem quer reconstruir o site de um negócio local para vendê-lo, criar sites dignos de prêmios Awwwards ou simplesmente evitar que o resultado pareça genérico.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Harishisonline/webbuild-skill/tree/main

Perguntar na sua IA favorita

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

Documentação

O que webbuild faz?

Faça sites pelos quais um empresário pagaria: específicos para ele, rápidos no celular, um momento memorável e nada que grite "um IA fez isso". O capricho está principalmente nas escolhas antes do código e em olhar honestamente para o resultado depois.

Os caminhos abaixo são relativos à pasta desta skill (scripts/, references/, assets/).

0. Configurar o projeto (2 min)

  • Novo site → copie assets/starter/ para dentro da pasta do projeto (HTML + CSS + ES modules puros, importações CDN fixas, sem etapa de build: implanta em qualquer lugar, fácil de editar). Use Next.js / Astro / R3F apenas se o usuário pedir ou o projeto já os utilizar (references/3d-playbook.md §5).
  • Projeto existente → mantenha seu framework, tokens e componentes; esta skill adiciona direção, movimento e QA, não uma reescrita.
  • Crie BUILD_NOTES.md no projeto. É a memória entre reinícios de contexto: resumo, decisões, perguntas em aberto, correções que funcionaram.

1. Briefing — entenda o negócio real

Colete (do usuário, do site atual do negócio, Google Business Profile, Instagram): nome, o que vendem, onde, desde quando, a única ação principal (ligar / agendar / encomendar / pedir orçamento / visitar), prova real (avaliação + quantidade, anos, licenças, imprensa), fotos reais, logo/cores, horários, endereço, telefone. Escreva o briefing de 5 linhas de references/design-system.md §2 em BUILD_NOTES.md.

Nunca invente fatos — avaliações, estatísticas, preços ou endereços fabricados em uma apresentação destroem a confiança no momento em que o proprietário os lê. Em vez disso:

  • Escreva em torno das incógnitas para que o demo ainda pareça finalizado: "Koregaon Park, Pune" em vez de um número de rua inventado; "Avaliado com 4,7 no Google" em vez de citações inventadas; nomes de serviços sem preços, ou "a partir de R$…" apenas se souber.
  • Quando um fato for realmente necessário (telefone, endereço exato, horários), use um {{placeholder}} visível — o slop_check.py bloqueia o envio até que seja preenchido.
  • Coloque todas as incógnitas e suposições em uma lista "Perguntar ao cliente" para o relatório final.

Para um site de criador ou canal, peça (ou extraia) os números do painel e a foto de perfil com antecedência: capturas de tela do YouTube Studio / Instagram Insights, além de vidIQ ou similar, se conectado. Uma seção de Resultados construída a partir de números reais é o que vende.

Se o briefing for superficial e o usuário estiver por perto, faça no máximo 3 perguntas (negócio + cidade, ação principal, algum site que eles amam). Se eles quiserem que você apenas vá, faça suposições sensatas, escreva-as e continue.

2. Referência (quando o usuário nomear um site, enviar uma gravação ou quiser uma "reconstrução")

Siga references/reverse-engineer.md: node scripts/teardown.mjs <url> mede a stack, fontes, paleta, mídia e evidências de shader e captura a rolagem; gravações de tela se tornam quadros que você lê e transforma em uma especificação de movimento passo a passo. Quando essa passagem rápida não conseguir explicar um efeito, vá mais fundo com o mecanismo REA: scripts/rea-teardown.sh <url> captura a página, identifica o bundle e exporta todos os scripts para que você possa ler como ele realmente é construído (guias em references/rea/). Registre OBSERVADO → INFERÊNCIA → DECISÃO. Aprenda a técnica; nunca copie marca, texto, ativos ou código.

3. Direção — planeje, depois ataque o plano

Leia references/design-system.md (as regras anti-slop — clássicas e os sinais "IA de bom gosto" mais novos, como creme + terracota, sobrancelhas EM CAIXA ALTA, linhas editoriais). Em BUILD_NOTES.md escreva:

  • 4–6 tokens de cor nomeados, extraídos do negócio, par de tipos + funções, linguagem de raio
  • Wireframe ASCII de cada seção (varie o ritmo — sem herói → 3 cards → logotipos → depoimentos)
  • o momento de assinatura (exatamente um) e por que ele se encaixa neste negócio
  • 3 princípios que o tornam distinto

Em seguida, revise o plano contra a lista de sinais e, para cada escolha que pareça padrão, justifique-a para este negócio ou mude-a. Perguntar "isso poderia pertencer a outro negócio se euro trocar o logotipo?" detecta a maioria dos problemas aqui, onde são baratos.

Para uma direção indecisa sobre a qual o usuário queira escolher, mostre 2–3 direções genuinamente diferentes (uma imagem estática ou um esboço HTML rápido cada) antes de construir — 21st-ui-explore pode ajudar, se instalado.

4. Herói — escolha o modo que atende ao negócio

references/3d-playbook.md §1 tem a tabela de decisão. Versão resumida:

  • estático (ótima foto/tipografia) — lugares, comida, salões, clínicas, serviços. Muitas vezes a escolha certa.
  • vídeo — loop de atmosfera, idealmente tratado com assets/starter/grade.js para que o material de IA/stock receba uma gradação personalizada (grão, halação, lift/gamma/gain, vinheta). Escolha um VISUAL e mantenha-o sutil.
  • quadros — o "site 3D de R$ 50 mil": keyframes de IA de início/fim → vídeo do primeiro/último quadro → scripts/frames.sh → canvas controlado pela rolagem. Leia references/scroll-video-playbook.md para as regras de keyframe, prompts e mesclagem.
  • cena — Three.js / R3F ao vivo quando o 3D é a história do produto (produto configurável, arquitetura, tecnologia). O assunto deve ser a coisa do negócio, nunca o nó placeholder.
  • página inteira — quando o proprietário pede um "site 3D", ele geralmente quer 3D em toda parte, não um herói 3D. Use uma cena fixa com uma câmera por seção (references/3d-playbook.md §6).

Gere ativos com o que estiver conectado (Higgsfield / Kling / kie.ai / Nano Banana MCPs ou skills), ou peça ao usuário para colocar os arquivos. Se nada estiver disponível, construa com um placeholder claramente identificado e liste exatamente qual ativo gerar, com o prompt.

5. Construir

Ordem: tokens (styles.css :root) → seções HTML semânticas com texto real → layout em 390px e 1440px → modo herói → movimento por último.

  • Regras de texto: references/design-system.md §8 (resultado + lugar + especificidades, verbos reais de CTA, palavras proibidas).
  • Obrigatório para um site empresarial: um CTA óbvio acima da dobra e novamente no final, tel: / agendamento / formulário, horários + endereço + link do mapa, prova real, título + descrição + imagem OG, JSON-LD de LocalBusiness, favicon, barra fixa de ligar/agendar no celular quando a ação for uma ligação.
  • Movimento: um momento de assinatura + microfeedback silencioso de 150–300 ms; ease-out, nunca bounce; apenas transform/opacity; movimento reduzido mostra estados finais.
  • Componentes: pesquise nos registros references/resources.md (21st.dev, React Bits, Aceternity, Motion Primitives…) antes de escrever efeitos complexos à mão, depois reestilize para os tokens. Em um site estático, reconstrua componentes React em vanilla em vez de adicionar React para um efeito.
  • Rodapé: construa-o de acordo com references/design-system.md §11 (bloco de marca, colunas de links com logotipos de plataforma, botões de contato, logotipo grande, linha inferior). Os proprietários julgam o site inteiro por ele. O pequeno crédito do construtor já está no starter; o cliente pode pedir para removê-lo.
  • Botões e rolagem: siga references/design-system.md §12 (botões táteis de 0,16 s, anel do cursor via cursor.js do starter, sem barra de rolagem nativa: o blockbar.js do starter a substitui).
  • Antes de considerar concluído, releia references/design-system.md §10: as coisas que os proprietários ainda chamam de slop depois que todas as regras passam.

6. Olhe para ele — é aqui que os bons sites são feitos

Sirva localmente (npx serve . ou o servidor de desenvolvimento do projeto), então:

  1. node scripts/shoot.mjs http://localhost:3000 ./shots — capturas de tela de celular / laptop / desktop ao longo da rolagem + erros de console, overflow, LCP, peso. Leia os PNGs. (Ou use o painel do navegador / MCP do Playwright, se disponível.) Execute também uma vez com --reduced-motion.
  2. python3 scripts/slop_check.py . — deve terminar com 0 FAIL. Trate WARNs como perguntas. (npx impeccable detect é uma boa segunda opinião, se instalado.)
  3. Critique honestamente contra o briefing: hierarquia, tipo, cor, o momento de assinatura, mobile, especificidade do texto. Corrija em lotes com intenção clara ("seções inferiores parecem genéricas — torne-as mais caras, não mais ocupadas").
  4. Remova um elemento decorativo antes de considerar concluído.

Espere 3–6 rodadas; ninguém acerta de primeira. Registre o que corrigiu o quê em BUILD_NOTES.md.

7. Enviar + apresentar

  • Implante: Vercel / Netlify / Cloudflare Pages / GitHub Pages. Faça commit da pasta de frames (o bug mais comum de "o herói desapareceu em produção"). Adicione <meta name="robots" content="noindex"> em demos para especulação até que o cliente compre.
  • Se for uma apresentação, leia references/pitch-and-sell.md: vídeo antes/depois, scripts de divulgação, âncoras de preço, lista de verificação pronta para apresentação, entrega.

Relatório final ao usuário

Mantenha-o curto e concreto:

  • O que foi construído (direção em uma linha, momento de assinatura, modo herói) e onde (caminhos, URL)
  • Como executar (npx serve . ou o comando de desenvolvimento)
  • Resultados do QA: contagens de FAIL/WARN do slop_check, LCP / erros por viewport do shoot.mjs, o que você examinou e corrigiu
  • Lista Perguntar ao cliente: cada {{placeholder}} e suposição
  • Ativos ainda a serem gerados (com prompts prontos para uso), se houver

Mapa de referência

LeiaQuando
references/design-system.mdSempre, antes de escolher cor/tipo/layout/texto
references/3d-playbook.mdEscolher o herói; qualquer Three.js/R3F; orçamento de desempenho + acessibilidade
references/scroll-video-playbook.mdHerói "3D" controlado por rolagem a partir de vídeo de IA
references/reverse-engineer.mdUm site de referência, uma gravação ou reconstruir o site de um cliente potencial
references/rea/README.mdAprofundar-se além do teardown.mjs com as ferramentas REA
references/resources.mdRegistros de componentes, ferramentas de efeitos, inspiração, skills complementares
references/pitch-and-sell.mdSite de especulação para um cliente potencial, preço, divulgação, entrega
ScriptFaz
scripts/teardown.mjs <url>Medir um site de referência (stack, fontes, paleta, mídia, shaders, capturas de tela)
scripts/rea-teardown.sh <url>Dissecação profunda com o mecanismo REA: captura de página, impressões digitais do bundle, scripts exportados
scripts/frames.sh <video> <out>Vídeo → sequências de quadros WebP (desktop + mobile) + manifesto
scripts/shoot.mjs <url> [out]Capturas de tela em 3 larguras ao longo da rolagem + erros/LCP/overflow
scripts/slop_check.py <dir>Linter de slop de IA + prontidão para envio (0 FAIL para enviar)

Playwright para os scripts .mjs: npm i -D playwright && npx playwright install chromium.

Habilidades Relacionadas