O que homepage-maker faz?
Skill para evitar que a IA crie páginas que pareçam artificiais (título centralizado, gradiente roxo, três cartões). Ele faz com que, como um designer, você primeiro veja sites reais bem feitos, declare de onde tirou cada coisa, e garanta que as informações essenciais de uma loja local não faltem. A renderização e a inspeção são feitas por scripts/homepage.mjs.
SK=.claude/skills/homepage-maker/scripts/homepage.mjs
node $SK init sites/<slug>
node $SK ref sites/<slug> <url> --note "Uma coisa que vou pegar deste site"
node $SK board sites/<slug>
node $SK copy sites/<slug>
node $SK check sites/<slug> [--draft]
node $SK shots sites/<slug> --compare <ref1>,<ref2>
node $SK deploy sites/<slug> [--prod]
Instalação inicial: na pasta do skill, execute npm install && npx playwright install chromium (veja README para procedimento completo). Os comandos são executados na raiz do projeto. A pontuação de artificialidade do texto só funciona se o projeto tiver humanize-korean em .claude/skills/humanize-korean/ (outro local pode ser especificado via HUMANIZE_KOREAN_ROOT).
Pesquisa prévia
Este skill constrói a página a partir de resultados de pesquisa. A única pesquisa feita diretamente é a coleta de referências de design; o restante deve estar concluído antes. Para detalhes de cada item, onde são usados e o que acontece se faltarem, veja references/prerequisites.md.
| Momento | Pesquisa necessária |
|---|---|
| Antes do briefing | Informações básicas do cliente (endereço, telefone, horário de funcionamento, estacionamento, reservas, cardápio, preços, origem dos ingredientes), situação do visitante (quem entra em qual contexto), regulamentações de publicidade do setor |
| Antes da proposta de três direções | Situação dos concorrentes e canais alternativos da loja (avaliações, textos de apresentação, existência de site), definição da marca |
| Antes da definição do texto | Palavras-chave, exposição em buscas |
| Antes do deploy | Titularidade do domínio e hospedagem, avisos obrigatórios (quando houver formulário de reserva ou contato) |
Valores não verificados devem ficar em facts.md com a marca "confirmar necessário"; o check impedirá que entrem na página.
Procedimento
Etapas marcadas com ⛔ não podem ser puladas sem aprovação humana.
- init — Verifique se a pesquisa prévia foi concluída usando a tabela acima. Em seguida, crie
sites/<slug>combrief.md,facts.md,refs.md,site/erefs/. - Briefing — Defina o propósito do site como uma única ação do visitante (encontrar o caminho, reservar, ligar). Descreva quem entra e em qual contexto (ex.: um cliente que vem de carro no fim de semana e verifica no celular antes de sair).
- Ficha de fatos — Registre endereço, telefone, horário de funcionamento, dias de fechamento, estacionamento, link de reserva, link do mapa Naver, cardápio, preços e origem dos ingredientes, com a fonte. O que não for confirmado deve ficar como "confirmar necessário" e não será usado na página. Se um número aparecer na página e não estiver em facts.md, o check falhará.
- Busca de referências — Encontre 8 a 12 candidatos em pelo menos três fontes da lista em
references/sources.md. Não olhe apenas para o mesmo setor; escolha sites que resolvam bem o mesmo problema (mostrar cardápio, indicar localização, exibir o processo). - Captura e registro — Capture de 5 a 8 lugares escolhidos com
ref. Capturas de desktop e mobile, além de dados de fonte, tamanho, cor, largura do texto e nível de movimento, são salvos emrefs/<slug>/e registrados emrefs.md. Para cada referência, anote "o que foi pego" em uma linha. Não pegue layout, fotos ou textos. Veja o método emreferences/moves.md. - ⛔ Proposta de três direções — Use
boardpara gerarout/board.pnge uma pasta compartilhávelout/board/(sem indexação para busca, cada cartão com link para o site original, o que foi pego e a seção onde é usado). Proponha três direções que partam de referências diferentes. Para cada direção, especifique o que foi pego de qual referência. Não construa até que uma pessoa escolha uma. - Construção por seção — Crie
site/index.html(com css/imagens emsite/) seção por seção. Coloquedata-ref="<nome da pasta refs>"em cada<section>para declarar a origem. Antes de criar uma seção, revise novamente a seção correspondente na referência. Blocos obrigatórios para lojas locais estão emreferences/korea-local.md. - Revisão do texto — Use
copypara extrair blocos de texto visível na página parasites/<slug>/_workspace/<data>-NNN-<tag>/01_input.txt(linhas de crédito de foto, licenças e áreasdata-copy-skipsão omitidas). Se o projeto tiver humanize-korean (epoko77-ai/im-not-ai), o mesmo comando mostra o caminho (light, standard, heavy) e o nível de risco. Revise a pasta da execução com o skill humanize-korean para gerarfinal.md, passe porverify_gates.pye mova apenas as frases alteradas parasite/. Não altere números, nomes próprios ou citações. Se a ferramenta não estiver disponível, esta etapa apenas extrai o texto. - check — Corrija até que falhas (✗) sejam zero. Durante o trabalho, use
--draftpara rebaixar falhas para avisos, mas a entrega/deploy deve passar sem--draft. - Comparação visual — Use
shots --comparepara gerarout/compare.pnge veja lado a lado com as referências escolhidas. Abra tambémout/site-mobile.png. Verifique: na primeira tela, dá para ver que tipo de loja é e onde fica? A "coisa pega" da referência está realmente viva? Não parece um template? Se houver ajustes, volte ao passo 7. - ⛔ Aprovação — Obtenha aprovação com
compare.png,site-mobile.pngeout/report.json. - Deploy —
deploysobe para a Vercel somente se o check passar. Na primeira vez, ele conecta um projeto Vercel com o nome da pasta (slug desites/<slug>). Como a Vercel sempre faz o primeiro deploy de um novo projeto como produção (<slug>.vercel.app), se houver informações temporárias, coloque um aviso "informação temporária" no topo da página antes de fazer o deploy. A partir da segunda vez, um endereço de preview é gerado; use--prodapenas após a aprovação. A conexão de domínio próprio também é feita somente após a aprovação.
Regras
- Use apenas fontes da lista de permitidos em
references/sources.md. Sites que bloqueiam agentes Claude no robots.txt (Godly, GDWEB) serão rejeitados peloref. Nesse caso, a pessoa deve ver manualmente e deixar apenas anotações. - As capturas de referência são para análise. Não suba
refs/para o repositório (.gitignore). Não use fotos, textos ou logotipos das referências no site. - Use apenas fotos tiradas pela própria loja na versão final. Não use imagens de comida geradas por IA ou pessoas sintéticas. Em versões de rascunho, podem ser usados placeholders com licença clara (ex.: CC), com a marca "placeholder" e a fonte da foto na página e em facts.md.
- Ao criar rascunhos com informações não confirmadas, marque-as como temporárias em facts.md e coloque um aviso "informação temporária" na página. Use apenas números de telefone que não pertençam a ninguém (ex.: 031-000-0000).
- Expressões exclusivas (primeiro, maior, único, original, Nº em ranking) só podem ser usadas se houver respaldo em facts.md. Se houver cardápio com preços, é obrigatória a indicação de origem (Lei de Origem). Mesmas regras do carousel-maker.
- Imagens: até 500 KB cada (recomendado WebP/AVIF), site inteiro até 3 MB.
Gates
| Gate | Condição de falha |
|---|---|
| refs | Menos de 3 referências com "o que foi pego" registrado |
| attribution | Seção sem data-ref, ou seção apontando para referência que não está em refs/ |
| fact | Número na página que não está em facts.md |
| placeholder | Restos de [...], 【...】, lorem, TODO |
| claim · origin | Expressão exclusiva sem respaldo; cardápio de carne com preço sem linha de origem |
| local | Ausência de LocalBusiness/Restaurant JSON-LD, link tel:, link de mapa Naver/Kakao, horário de funcionamento |
| meta | Falta de og:title, og:image, lang="ko", viewport |
| korean | Ausência de word-break: keep-all no body |
| a11y · contrast | Imagem sem alt, contraste abaixo de WCAG AA |
| mobile | Scroll horizontal em 390px, texto abaixo de 16px (botão abaixo de 44px vira aviso) |
| template · weight | Gradiente roxo, frases-feitas, imagens pesadas (aviso) |
| copy-style | Pontuação do humanize-korean não é risco baixo, ou caminho não é light, ou vírgula após conector >3, ou padrão 'A가 아니라 B' 2+ vezes (aviso). Se a ferramenta não existir, é ignorado (i) |
Comparação com Muzli MCP
| Muzli MCP | homepage-maker | |
|---|---|---|
| Referências | Curadoria editorial do Muzli (um lugar) | Coleções públicas do Muzli + SiteInspire, Land-book, Lapa Ninja, One Page Love, Awwwards |
| Atribuição de origem | Diz em conversa | Obrigatório via data-ref por seção; falha se faltar |
| Análise de referência | Imagem e descrição | Captura desktop + mobile + tokens de fonte, tamanho, cor, largura |
| Inspeção do resultado | Nenhuma | Gates de fatos, leis, informações de loja local, mobile, contraste, coreano + pontuação de artificialidade (humanize-korean) |
| Revisão visual | Nenhuma | Imagem comparativa lado a lado com referências |
| Deploy | muzli.space (sem indexação, sem formulário, limite de 10) | Vercel (indexável, domínio próprio) |
| Setor coreano | Nenhum | Mapa Naver, reservas, JSON-LD, origem dos ingredientes, quebra de linha coreana |
| Vantagens do Muzli | Curadoria baseada em 900 mil designers, uso da própria coleção salva | Usa apenas coleções públicas, sem personalização |