¿Qué hace homepage-maker?
Skill para evitar páginas con aspecto de IA (título centrado, gradiente púrpura, tres tarjetas) y, en su lugar, actuar como un diseñador: primero observar sitios reales bien hechos, declarar qué se tomó y de dónde, y asegurarse de que no falte información esencial para la página de inicio de un negocio. El renderizado y la verificación los realiza scripts/homepage.mjs.
SK=.claude/skills/homepage-maker/scripts/homepage.mjs
node $SK init sites/<slug>
node $SK ref sites/<slug> <url> --note "Una cosa que tomar de este sitio"
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]
Instalación inicial: en la carpeta del skill, ejecuta npm install && npx playwright install chromium (consulta README para la instalación completa). Los comandos se ejecutan desde la raíz del proyecto. La puntuación de "aspecto AI" en los textos solo se activa si el proyecto tiene humanize-korean en .claude/skills/humanize-korean/ (si está en otra ruta, usa la variable HUMANIZE_KOREAN_ROOT).
Investigación previa
Este skill construye la página basándose en investigación. La única investigación que realiza directamente es la recopilación de referencias de diseño. Lo siguiente debe estar completado de antemano. Para más detalles sobre cada elemento, dónde se usa y qué ocurre si falta, consulta references/prerequisites.md.
| Momento | Investigación necesaria |
|---|---|
| Antes del briefing | Información básica del negocio (dirección, teléfono, horario, estacionamiento, reservas, menú, precios, origen de ingredientes), situación del visitante (quién entra y en qué contexto), regulaciones publicitarias del sector |
| Antes de proponer tres direcciones | Canales de competidores y negocios alternativos (reseñas, textos promocionales, existencia de web), definición de la marca |
| Antes de finalizar textos | Palabras clave, posicionamiento en buscadores |
| Antes del despliegue | Titular del dominio y hosting, avisos obligatorios (si hay formulario de reservas o consultas) |
Los valores no verificados se marcan como "pendiente de verificación" en facts.md; el comando check impedirá que aparezcan en la página.
Procedimiento
Los pasos marcados con ⛔ no pueden avanzar sin aprobación humana.
- init — Verifica con la tabla anterior que la investigación previa esté completa, luego crea
sites/<slug>conbrief.md,facts.md,refs.md,site/yrefs/. - Brief — Define el propósito del sitio como una sola acción del visitante (encontrar la ubicación, reservar, llamar). Describe quién entra y en qué contexto (ej.: un cliente que llega en coche el fin de semana y consulta el móvil antes de salir).
- Ficha de datos (facts) — Anota dirección, teléfono, horario, días de cierre, estacionamiento, enlace de reservas, enlace al mapa Naver, menú, precios y origen de ingredientes, con sus fuentes. Lo no verificado se marca como "pendiente de verificación" y no se incluye en la página. Si en la página aparece un número que no está en facts.md,
checkfallará. - Buscar referencias — Busca de 8 a 12 candidatos de tres o más fuentes de
references/sources.md. No te limites al mismo sector; elige sitios que resuelvan bien el mismo problema (mostrar un menú, indicar una ubicación, mostrar un proceso). - Capturar y registrar — Captura con
refde 5 a 8 sitios seleccionados. Se guardan capturas de escritorio y móvil, junto con fuente, tamaño, color, ancho del texto y nivel de animación enrefs/<slug>/y se registran enrefs.md. Anota en una línea "qué se tomó" de cada referencia. No copies el layout, las fotos ni los textos. Ver método enreferences/moves.md. - ⛔ Proponer tres direcciones — Con
board, generaout/board.pngy una carpetaout/board/para compartir (sin indexar, con enlace al sitio original, qué se tomó y en qué sección se usa). Propón tres direcciones que partan de referencias diferentes. Anota qué se tomó de cada referencia. No construyas hasta que una persona elija una. - Construcción por secciones — Crea
site/index.html(con CSS e imágenes dentro desite/) sección por sección. Cada<section>debe llevardata-ref="<nombre de carpeta refs>"para indicar la fuente. Antes de crear una sección, revisa de nuevo la sección correspondiente de esa referencia. Los bloques obligatorios para negocios locales están enreferences/korea-local.md. - Edición de textos — Con
copy, extrae los textos visibles de la página por bloques y guárdalos ensites/<slug>/_workspace/<fecha>-NNN-<tag>/01_input.txt(se excluyen líneas de atribución de fotos y áreasdata-copy-skip). Si el proyecto tiene humanize-korean (epoko77-ai/im-not-ai), el mismo comando muestra la ruta (light, standard, heavy) y el nivel de riesgo. Procesa esa carpeta con el skill humanize-korean para obtenerfinal.md, pásalo porverify_gates.pyy luego traslada solo las frases cambiadas asite/. No modifiques números, nombres propios ni citas. Si no hay herramienta, este paso solo extrae los textos. - Verificación (check) — Corrige hasta que no haya fallos (✗). Durante el trabajo puedes usar
--draftpara bajar los fallos a advertencias, pero la entrega y el despliegue deben pasar sin--draft. - Comparación visual — Con
shots --compare, generaout/compare.pngpara ver la página junto a las referencias seleccionadas. También abreout/site-mobile.png. Verifica: ¿en la primera pantalla se ve qué tipo de negocio es y dónde está? ¿La "cosa tomada" de la referencia realmente se nota? ¿No parece una plantilla? Si hay que corregir, vuelve al paso 7. - ⛔ Aprobación — Obtén la aprobación con
compare.png,site-mobile.pngyout/report.json. - Despliegue —
deploysolo sube a Vercel sicheckpasa. La primera vez, vincula el nombre de la carpeta (sites/<slug>) como proyecto de Vercel. Como Vercel sube el primer despliegue siempre como producción (<slug>.vercel.app), si hay información provisional, coloca un aviso "Información provisional" en la parte superior de la página. A partir del segundo despliegue se genera una URL de previsualización;--prodsolo se usa después de la aprobación. La conexión de dominio propio también es posterior a la aprobación.
Reglas
- Las fuentes de referencia solo pueden ser las permitidas en
references/sources.md. Los sitios que bloquean agentes de Claude en robots.txt (Godly, GDWEB) serán rechazados porref. En esos casos, una persona debe verlos manualmente y dejar solo notas. - Las capturas de referencia son solo para análisis.
refs/no se sube al repositorio (está en.gitignore). No uses las fotos, textos ni logotipos de las referencias en el sitio. - Las fotos de la entrega final deben ser tomadas por el propio negocio. No uses fotos de comida generadas por IA ni personas sintéticas. En la fase de maquetación se pueden usar fotos placeholder con licencia clara (CC, etc.), marcadas como "placeholder" en la página, con la fuente en facts.md.
- Al crear maquetas con información no confirmada, márcala como provisional en facts.md y coloca un aviso "Información provisional" en la página. Para números de teléfono usa solo valores que no pertenezcan a nadie (ej.: 031-000-0000).
- Las expresiones exclusivas (primero, más grande, único, original, puesto N) solo se usan si hay evidencia en facts.md. Si se muestran menú y precios, debe indicarse el origen de los ingredientes (Ley de Origen). Mismas reglas que carousel-maker.
- Las imágenes deben pesar 500 KB o menos cada una (recomendado WebP/AVIF), y el sitio completo debe ocupar 3 MB o menos.
Compuertas (gates)
| Compuerta | Condición de fallo |
|---|---|
| refs | Menos de 3 referencias con "qué se tomó" anotado |
| attribution | Sección sin data-ref, o que apunta a una referencia no existente en refs/ |
| fact | Número en la página que no está en facts.md |
| placeholder | Quedan [...], 【...】, lorem, TODO |
| claim · origin | Expresión exclusiva sin evidencia, o menú de carne + precio sin línea de origen |
| local | Falta JSON-LD LocalBusiness/Restaurant, enlace tel:, enlace al mapa Naver/Kakao, horario de atención |
| meta | Falta og:title, og:image, lang="ko", viewport |
| korean | El body no tiene word-break: keep-all |
| a11y · contrast | Imagen sin alt, incumplimiento de WCAG AA en contraste |
| mobile | Scroll horizontal a 390px, texto del cuerpo menor a 16px (botón menor a 44px es advertencia) |
| template · weight | Gradiente púrpura, frases cliché, imágenes pesadas (advertencia) |
| copy-style | La puntuación de humanize-korean no es riesgo bajo, o la ruta no es light, o número de comas después de conectores z>3, o 'A가 아니라 B' 2+ veces (advertencia). Si no hay herramienta, se salta (i) |
Comparación con Muzli MCP
| Muzli MCP | homepage-maker | |
|---|---|---|
| Referencias | Una sola fuente: curación editorial de Muzli | Colecciones públicas de Muzli + SiteInspire, Land-book, Lapa Ninja, One Page Love, Awwwards |
| Atribución de fuente | Se indica en la conversación | Obligatorio por sección con data-ref; sin ello, falla |
| Análisis de referencias | Imagen y descripción | Capturas escritorio + móvil + tokens de fuente, tamaño, color, ancho |
| Verificación de resultado | Ninguna | Compuertas de hechos, legalidad, negocio local, móvil, contraste, coreano + puntuación de aspecto AI (humanize-korean) |
| Revisión visual | Ninguna | Imagen comparativa lado a lado con referencias |
| Despliegue | muzli.space (sin indexar, sin formularios, límite 10) | Vercel (indexable, dominio propio posible) |
| Sectores coreanos | Ninguno | Mapa Naver, reservas, JSON-LD, origen de ingredientes, salto de línea coreano |
| Ventaja de Muzli | Curación basada en 900k diseñadores, uso de colecciones propias | Solo usa colecciones públicas, sin personalización |