Communitygithub.com

homepage-maker

Mostra como um agente pode criar landing pages, homepages ou portfólios com curadoria de referências reais, rastreio de atribuição e verificações de qualidade local (coreano).

O que é homepage-maker?

O skill homepage-maker capacita agentes de IA (como Claude Code, Cursor ou Codex) a produzir páginas institucionais, portfólios ou landing pages que não pareçam geradas por IA. Ele segue um fluxo estruturado que começa com pesquisa prévia obrigatória (dados do cliente, concorrência, regras publicitárias) e procede por inicialização de projeto, definição de objetivo único, coleta de fatos verificados, busca de referências em fontes curadas (SiteInspire, Land-book, Lapa Ninja, One Page Love, Awwwards), captura de desktop e mobile com métricas tipográficas/cromáticas, proposta de três direções visuais, desenvolvimento seccional com atribuição obrigatória via `data-ref`, revisão de texto com suporte opcional ao humanize-korean (para naturalidade em coreano), verificação automatizada com gates (fatos, acessibilidade, mobile, legal local), comparação visual lado a lado com referências e deploy para Vercel. É ideal para negócios locais coreanos, pois inclui regras para informações obrigatórias (endereço, telefone, horários, estacionamento, reservas, links de mapa Naver/Kakao, origem de ingredientes) e validação de JSON-LD. O skill é mantido por scripts em Node.js (`scripts/homepage.mjs`) e depende de Playwright para capturas.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/min9lin9/min9maker-homepage/tree/HEAD

Perguntar na sua IA favorita

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

Documentação

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.

MomentoPesquisa necessária
Antes do briefingInformaçõ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çõesSituaçã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 textoPalavras-chave, exposição em buscas
Antes do deployTitularidade 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.

  1. init — Verifique se a pesquisa prévia foi concluída usando a tabela acima. Em seguida, crie sites/<slug> com brief.md, facts.md, refs.md, site/ e refs/.
  2. 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).
  3. 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á.
  4. 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).
  5. 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 em refs/<slug>/ e registrados em refs.md. Para cada referência, anote "o que foi pego" em uma linha. Não pegue layout, fotos ou textos. Veja o método em references/moves.md.
  6. ⛔ Proposta de três direções — Use board para gerar out/board.png e uma pasta compartilhável out/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.
  7. Construção por seção — Crie site/index.html (com css/imagens em site/) seção por seção. Coloque data-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 em references/korea-local.md.
  8. Revisão do texto — Use copy para extrair blocos de texto visível na página para sites/<slug>/_workspace/<data>-NNN-<tag>/01_input.txt (linhas de crédito de foto, licenças e áreas data-copy-skip sã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 gerar final.md, passe por verify_gates.py e mova apenas as frases alteradas para site/. 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.
  9. check — Corrija até que falhas (✗) sejam zero. Durante o trabalho, use --draft para rebaixar falhas para avisos, mas a entrega/deploy deve passar sem --draft.
  10. Comparação visual — Use shots --compare para gerar out/compare.png e veja lado a lado com as referências escolhidas. Abra também out/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.
  11. ⛔ Aprovação — Obtenha aprovação com compare.png, site-mobile.png e out/report.json.
  12. Deploy — deploy sobe para a Vercel somente se o check passar. Na primeira vez, ele conecta um projeto Vercel com o nome da pasta (slug de sites/<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 --prod apenas 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 pelo ref. 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

GateCondição de falha
refsMenos de 3 referências com "o que foi pego" registrado
attributionSeção sem data-ref, ou seção apontando para referência que não está em refs/
factNúmero na página que não está em facts.md
placeholderRestos de [...], 【...】, lorem, TODO
claim · originExpressão exclusiva sem respaldo; cardápio de carne com preço sem linha de origem
localAusência de LocalBusiness/Restaurant JSON-LD, link tel:, link de mapa Naver/Kakao, horário de funcionamento
metaFalta de og:title, og:image, lang="ko", viewport
koreanAusência de word-break: keep-all no body
a11y · contrastImagem sem alt, contraste abaixo de WCAG AA
mobileScroll horizontal em 390px, texto abaixo de 16px (botão abaixo de 44px vira aviso)
template · weightGradiente roxo, frases-feitas, imagens pesadas (aviso)
copy-stylePontuaçã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 MCPhomepage-maker
ReferênciasCuradoria editorial do Muzli (um lugar)Coleções públicas do Muzli + SiteInspire, Land-book, Lapa Ninja, One Page Love, Awwwards
Atribuição de origemDiz em conversaObrigatório via data-ref por seção; falha se faltar
Análise de referênciaImagem e descriçãoCaptura desktop + mobile + tokens de fonte, tamanho, cor, largura
Inspeção do resultadoNenhumaGates de fatos, leis, informações de loja local, mobile, contraste, coreano + pontuação de artificialidade (humanize-korean)
Revisão visualNenhumaImagem comparativa lado a lado com referências
Deploymuzli.space (sem indexação, sem formulário, limite de 10)Vercel (indexável, domínio próprio)
Setor coreanoNenhumMapa Naver, reservas, JSON-LD, origem dos ingredientes, quebra de linha coreana
Vantagens do MuzliCuradoria baseada em 900 mil designers, uso da própria coleção salvaUsa apenas coleções públicas, sem personalização

Habilidades Relacionadas