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 todosite.jsonDEVE satisfazerreferences/sections.md— os 14 tipos de seção (incl.posts): quando usar, campos, limites de textoreferences/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ção | Comando |
|---|---|
| Validar | node ${HERMES_SKILL_DIR}/scripts/validate.mjs <site.json> |
| Renderizar | node ${HERMES_SKILL_DIR}/scripts/render.mjs <site.json> <dir-saida> |
| Publicar | bash ${HERMES_SKILL_DIR}/scripts/deploy.sh <dir-saida> <dominio> |
Procedimento
-
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).
-
Rascunhar
site.jsonconformereferences/site.schema.json. Estude o exemplo correspondente primeiro (innoe.site.jsonpara página única,multipage.site.jsonpara várias páginas). Escolha 5–8 seções por página que correspondam ao conteúdo real (vejareferences/sections.mdpara o mapa objetivo→espinha dorsal da seção).- Página única: tudo vai nas
sectionsde nível superior. - Várias páginas: o início fica nas
sectionsde nível superior; adicionepages[](uma entrada por subpágina, cada uma com suas própriassections). A navegação deriva automaticamente das páginas. Um blog é uma página com uma seçãoposts(leve: cards de título, sem páginas de artigo). Escolha a aparência (vejareferences/theme.md): ou escolha um template estilizado (newchinese/cyber/portfolio) quando a marca tiver uma estética forte e óbvia, ou — o padrão — usetemplate:"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 conformereferences/assets.md.
- Página única: tudo vai nas
-
Validar. Execute
validate.mjs. Em caso de falha, leia os erros, corrija o JSON, execute novamente. Nunca prossiga com um arquivo inválido. -
Renderizar. Execute
render.mjs <site.json> <dir-saida>→ um site estático em<dir-saida>/dist. SeUNSPLASH_ACCESS_KEYestiver definido, a renderização substitui automaticamente placeholdersunsplashpor fotos reais (creditadas); sem ele, placeholders temáticos são renderizados — ambos são adequados para publicação. -
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.jsoncompleto, depois re-valide + re-renderize. -
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 umaquery(foto de conteúdo); use"image"apenas com uma URL real fornecida pelo usuário. O logotipo assume como padrãotype:"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
darkou doisprimaryconsecutivos. Sempre abra comhero, feche comctaoucontact. - 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.mjssai com código0(ele imprime a ordem de seção resolvida).render.mjsproduz<dir-saida>/dist/index.html.- Após a publicação,
curl -I https://<dominio>retorna200.