Communitygithub.com

Construtor de Site por Conversa

Construa e publique um site através de conversa — colete requisitos, produza um site.json validado, renderize com o template Sitesmith e publique via Nginx. Use para 'cria/faça um site para mim', landing pages, sites pessoais/de negócios, portfólios.

O que é Construtor de Site por Conversa?

Sitesmith é uma habilidade para agentes de IA (como Claude Code) que transforma conversas curtas em sites completos e prontos para publicação, suportando opções monolíngues ou bilíngues. Em vez de gerar código HTML/CSS manualmente, o agente produz um único arquivo `site.json`, que é processado por um template fixo e bem projetado, garantindo estabilidade e facilidade de re-estilização. A habilidade guia o agente na coleta estruturada de requisitos (nome do negócio, objetivo, idiomas, escopo de páginas, serviços, identidade visual), na criação do `site.json` seguindo um esquema rigoroso, na validação com um script Node.js e na renderização estática. O resultado pode ser publicado automaticamente via Nginx com HTTPS. É ideal para landing pages, sites pessoais, portfólios e sites de negócios, evitando a complexidade de desenvolvimento manual e mantendo o resultado consistente.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YuukiMarine/websiteskills/tree/HEAD/skill

Perguntar na sua IA favorita

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

Documentação

Sitesmith — Construtor de Site por Conversa

Transforme algumas rodadas de conversa em um site completo, opcionalmente bilíngue e publique-o. Você produz dados, não código: um único site.json que um template fixo e bem projetado renderiza. Isso mantém a saída estável e facilmente re-estilizável.

Quando Usar

Quando o usuário quer criar ou atualizar um site, landing page, site pessoal ou de negócios, ou portfólio — por exemplo, "cria um site para mim", "quero um site", "atualize minha homepage", "faça uma landing page para minha padaria".

Referência Rápida

Arquivos de referência — carregue com skill_view("sitesmith", "<caminho>") apenas quando necessário:

  • references/site.schema.json — o contrato que todo site.json DEVE satisfazer
  • references/sections.md — os 14 tipos de seção (incl. posts): quando usar, campos, limites de texto
  • references/theme.md — tokens de tema (template, cores, fontes, raio, densidade)
  • references/assets.md — estratégia de imagens (placeholder / unsplash; nunca invente assets)
  • references/examples/innoe.site.json — um exemplo completo de página única (few-shot)
  • references/examples/multipage.site.json — um exemplo de várias páginas + blog (few-shot)

Scripts — execute via ferramenta de terminal:

AçãoComando
Validarnode ${HERMES_SKILL_DIR}/scripts/validate.mjs <site.json>
Renderizarnode ${HERMES_SKILL_DIR}/scripts/render.mjs <site.json> <dir-saida>
Publicarbash ${HERMES_SKILL_DIR}/scripts/deploy.sh <dir-saida> <dominio>

Procedimento

  1. Coletar (3–5 turnos, perguntas agrupadas — não interrogue).

    • Nome do negócio + uma linha sobre o que fazem; setor + quem são seus clientes.
    • Objetivo principal (ligações / reservas / inscrições / vender / mostrar).
    • Idiomas — padrão é o idioma do chat; ofereça bilíngue (ex.: pt + en).
    • Escopo: uma página ou várias páginas? Padrão é página única. Se quiserem mais (ou mencionarem um blog), ofereça o conjunto padrão (Início / Sobre / Serviços / Blog / Contato) e deixe-os ajustar — confirme a lista de páginas antes de construir.
    • Top 3–5 serviços/produtos; o que os torna diferentes; números reais; detalhes de contato
      • a principal chamada para ação.
    • Estilo em uma ou duas palavras (→ theme); assets (logotipo? cor da marca? fotos reais?).
    • Se o usuário for sucinto ou disser "apenas faça ficar bonito", prossiga com padrões sensatos (página única é o padrão seguro).
  2. Rascunhar site.json conforme references/site.schema.json. Estude o exemplo correspondente primeiro (innoe.site.json para página única, multipage.site.json para várias páginas). Escolha 5–8 seções por página que correspondam ao conteúdo real (veja references/sections.md para o mapa objetivo→espinha dorsal da seção).

    • Página única: tudo vai nas sections de nível superior.
    • Várias páginas: o início fica nas sections de nível superior; adicione pages[] (uma entrada por subpágina, cada uma com suas próprias sections). A navegação deriva automaticamente das páginas. Um blog é uma página com uma seção posts (leve: cards de título, sem páginas de artigo). Escolha a aparência (veja references/theme.md): ou escolha um template estilizado (newchinese/cyber/portfolio) quando a marca tiver uma estética forte e óbvia, ou — o padrão — use template:"pro" e projete uma paleta personalizada você mesmo (primary/accent/neutral/font/radius/density) a partir da sensação do negócio, para que cada site seja único. Lide com cada imagem conforme references/assets.md.
  3. Validar. Execute validate.mjs. Em caso de falha, leia os erros, corrija o JSON, execute novamente. Nunca prossiga com um arquivo inválido.

  4. Renderizar. Execute render.mjs <site.json> <dir-saida> → um site estático em <dir-saida>/dist. Se UNSPLASH_ACCESS_KEY estiver definido, a renderização substitui automaticamente placeholders unsplash por fotos reais (creditadas); sem ele, placeholders temáticos são renderizados — ambos são adequados para publicação.

  5. Visualizar e iterar. Resuma em linguagem simples o que você construiu ("um site bilíngue de 5 páginas: Início, Sobre, Serviços, Diário, Contato" — ou "uma página única de 6 seções"). Diga ao usuário que o site permanece totalmente editável — eles podem pedir a qualquer momento para adicionar/remover páginas ou seções, reescrever texto, mudar cores ou adicionar postagens de blog. Aplique edições reemitindo o site.json completo, depois re-valide + re-renderize.

  6. Publicar (apenas após o usuário aprovar a visualização). Execute deploy.sh <dir-saida> <dominio> → ativo via Nginx com HTTPS. Informe a URL ativa.

Armadilhas

  • Saída são dados, não código. Produza apenas site.json. Nunca escreva HTML/CSS manualmente.
  • Esquema é lei. Nomes de campos e valores de enum devem corresponder exatamente; omita campos desconhecidos.
  • Nenhum asset inventado. Use Media type:"placeholder" (decorativo) ou "unsplash" com uma query (foto de conteúdo); use "image" apenas com uma URL real fornecida pelo usuário. O logotipo assume como padrão type:"text" a menos que exista um arquivo de logotipo real.
  • Prefira ícones a imagens para recursos/serviços — nomes Lucide sempre renderizam e recolorizam.
  • Cada LocalizedText carrega todos os idiomas do site. Traduza de forma idiomática; nunca deixe um em branco.
  • Não construa demais. 5–8 seções. Alterne fundos de seção; nunca tenha dois dark ou dois primary consecutivos. Sempre abra com hero, feche com cta ou contact.
  • Sem alegações de risco de conformidade — sem certificações, endossos, subsídios/governamentais, prêmios ou estatísticas inventados que o usuário não declarou.
  • Página única é o padrão. Adicione pages[] apenas quando o usuário quiser um site mais rico/com várias páginas ou um blog — e confirme a lista de páginas com eles primeiro. O blog (posts) é uma lista de títulos, não artigos completos; diga isso e observe que artigos podem ser adicionados posteriormente.

Verificação

  • validate.mjs sai com código 0 (ele imprime a ordem de seção resolvida).
  • render.mjs produz <dir-saida>/dist/index.html.
  • Após a publicação, curl -I https://<dominio> retorna 200.

Individual skills in this repo

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

Habilidades Relacionadas