Communitygithub.com

BitCrowder/website-builder-skill

Construa sites polidos com IA a partir de uma ideia vaga, passando por clarificação, análise de referências visuais, estrutura de página, correspondência de ativos, iteração, QA responsivo e preparação para implantação.

O que é website-builder-skill?

Esta skill guia o agente de IA em um fluxo de trabalho direcional, semelhante ao de um diretor de design, para transformar ideias vagas de sites em projetos reais e utilizáveis. Ela é útil para criar, redesenhar ou melhorar qualquer tipo de site, como landing pages, portfólios, sites de produtos, serviços locais, e-commerce ou projetos web onde o agente deve atuar como um estrategista de produto e diretor de design antes de escrever código. A skill suporta qualquer plataforma de desenvolvimento web com IA, como Claude Code ou Cursor, e é baseada em um workflow de 7 etapas: clarificação do projeto, design da arquitetura da informação, análise de referências visuais, construção do esqueleto do site, processamento de imagens, iteração focada em qualidade visual e verificação final para implantação. O principal valor está em fazer o agente fazer as perguntas certas e preservar a intenção do design durante a implementação, evitando pular direto para o código sem um briefing claro.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BitCrowder/website-builder-skill/tree/HEAD/build-website-with-ai

Perguntar na sua IA favorita

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

Documentação

Construir Site Com IA

Visão Geral

Use esta skill para transformar ideias vagas de sites em sites reais e utilizáveis por meio de um fluxo de trabalho direcional: esclareça o projeto, analise referências, construa um rascunho estruturado, mapeie ativos reais, itere em pequenos passes, verifique a qualidade em desktop/mobile e prepare-se para a implantação.

Não pule direto para o código, a menos que o usuário já tenha fornecido um briefing claro do projeto, direção visual, conteúdo e destino de construção. O principal valor desta skill é fazer a IA fazer as perguntas certas e preservar a intenção do design durante a implementação.

Fluxo de Trabalho

1. Esclareça Antes de Construir

Comece fazendo 8 a 12 perguntas de alto impacto quando o projeto estiver vago. Cubra:

  • usuários-alvo
  • intenção do usuário ao chegar
  • ação de conversão desejada
  • diferencial em relação a concorrentes ou categoria
  • mensagem da página inicial
  • páginas ou seções necessárias
  • conteúdo obrigatório
  • personalidade visual
  • informações ausentes necessárias para tornar o site real

Se o usuário não puder responder, faça suposições razoáveis e explícitas e rotule-as como suposições.

Converta as respostas em um brief de posicionamento do projeto:

  • posicionamento em uma linha
  • usuários-alvo
  • pontos de dor
  • oferta principal ou pontos de venda
  • meta de conversão
  • estrutura da página
  • ordem das seções da página inicial
  • palavras-chave visuais
  • conteúdo necessário
  • conteúdo adiado

Leia references/prompts.md quando precisar de prompts prontos em chinês para a fase de clarificação e posicionamento.

2. Projete a Arquitetura da Informação

Antes de codificar, produza uma tabela com:

  • ordem das seções
  • nome da seção
  • o que o usuário vê
  • por que o usuário continua lendo
  • ativos necessários

Faça a página inicial ler como um caminho de decisão natural, não uma pilha de módulos genéricos. Cada seção deve responder a uma pergunta do usuário, construir confiança ou mover o usuário em direção à ação de conversão.

3. Analise Referências Visuais

Se o usuário fornecer capturas de tela, sites, telas de aplicativos, cartazes, imagens de marca ou páginas de concorrentes, analise-os antes de construir. Não os copie diretamente.

Extraia:

  • palavras-chave de estilo
  • comportamento de cor e contraste
  • hierarquia tipográfica
  • espaçamento e ritmo de layout
  • padrões de cartões, botões, navegação e seções
  • proporção de imagem para texto
  • dicas de movimento ou sensação premium
  • o que se encaixa neste projeto e o que deve ser descartado

Sintetize uma direção visual que se encaixe no projeto do usuário. Preserve qualidades úteis como espaço em branco, hierarquia, moderação, ritmo e movimento, enquanto redesenha a estrutura e o texto para o objetivo real do negócio.

4. Construa o Esqueleto do Site

Crie uma primeira versão executável com ordem completa das seções, títulos reais, texto de rascunho, chamadas para ação, interações básicas e espaços reservados para imagens.

Para cada espaço reservado, rotule o tipo de imagem pretendido, como visual herói, foto de produto, imagem de estudo de caso, imagem de equipe, diagrama de processo, logotipo, retrato de depoimento ou textura de fundo.

Priorize:

  • lógica do projeto
  • ritmo da página
  • clareza da primeira tela
  • direção visual
  • estrutura responsiva
  • texto legível e específico

Não espere por imagens perfeitas antes de produzir um rascunho útil.

5. Processe e Corresponda Imagens

Quando o usuário fornecer muitas imagens, peça que coloquem os originais em assets/raw-images/. Preserve os arquivos originais.

Então:

  1. inspecione o conteúdo da imagem
  2. classifique por uso provável
  3. renomeie ou copie versões processadas com nomes de arquivo claros em inglês
  4. coloque versões otimizadas para web em assets/processed/
  5. corresponda imagens às seções da página
  6. evite imagens esticadas ou distorcidas
  7. mantenha posicionamentos incertos como espaços reservados e explique o que está faltando

Produza uma tabela de atribuição de imagens antes ou junto com as alterações de código. Quando o usuário corrigir o posicionamento da imagem, altere apenas o mapeamento e os estilos necessários; não reescreva a página inteira.

6. Itere Como um Diretor de Design

Revise o resultado visualmente, não apenas o código. Verifique:

  • se a primeira tela explica para quem é e o que é oferecido em até 3 segundos
  • se a ordem dos módulos suporta um caminho natural de vendas ou construção de confiança
  • se o texto parece específico em vez de texto genérico de marketing de IA
  • se as imagens correspondem ao conteúdo
  • se os botões e caminhos de conversão são claros
  • se os layouts desktop e mobile funcionam
  • se há sobreposição de texto, distorção de imagens ou espaçamento caótico

Prefira pequenas iterações de 3 a 5 problemas por vez. Preserve características visuais fortes que já funcionam, como hierarquia, espaço em branco, ritmo de cartões e movimento moderado.

Leia references/checklists.md ao preparar o QA final ou quando o usuário perguntar o que inspecionar.

7. Verifique e Prepare-se para o Lançamento

Antes de considerar o site completo:

  • execute o comando de construção ou validação estática disponível no projeto
  • inspecione as visualizações desktop e mobile quando uma ferramenta de navegador estiver disponível
  • verifique caminhos de imagem, links, botões, formulários e navegação
  • remova conteúdo não utilizado apenas de espaço reservado se o conteúdo real existir
  • relate suposições restantes ou ativos ausentes

Para implantação, escolha a plataforma que corresponda ao projeto ou solicitação do usuário, como Vercel, Netlify, Cloudflare Pages, GitHub Pages ou uma hospedagem existente. Não exclua ativos de origem durante a limpeza.

Pastas de Projeto Sugeridas

Use ou adapte esta estrutura ao começar do zero:

meu-site/
  references/        referências visuais e capturas de tela de concorrentes
  assets/
    raw-images/      imagens originais não tocadas
    processed/       imagens otimizadas para web
  notes/             notas do projeto e texto
  prompts/           prompts e decisões salvos
  website/           código do site gerado

Pontos de Partida Comuns

  • Portfólio: esclareça o posicionamento pessoal, categorias de trabalho, serviços, provas e caminho de contato.
  • Site de produto: esclareça o nome do produto, ponto de dor, diferenciação, prova e caminho de conversão.
  • Site de serviço local: esclareça a área de atendimento, evidências de confiança, fluxo de agendamento ou consulta.
  • Vitrine de e-commerce: esclareça categorias de produto, motivações de compra, conteúdo do cartão e estrutura da página de detalhes.
  • Página de landing de curso: esclareça a dor do aluno, resultado prometido, currículo, prova, preço e caminho de inscrição.

Habilidades Relacionadas