Communitygithub.com

homepage-maker

Muestra a un agente cómo art-dirigir y construir un "creador de páginas de inicio", de modo que la salida concreta sea una landing page, página principal o portafolio. El procedimiento avanza a través de investigación previa, procedimiento y reglas. Úsalo cuando un nuevo encargo requiera este oficio.

¿Qué es homepage-maker?

Este skill guía a un agente de IA (como Claude Code, Cursor o Codex) para que actúe como un diseñador real y cree páginas de inicio, páginas principales o portafolios que no parezcan generadas por IA. En lugar de usar plantillas típicas (título centrado, gradiente púrpura, tres tarjetas), el agente debe primero investigar sitios reales bien diseñados, documentar qué elementos toma de cada referencia, asegurarse de que la página incluya toda la información esencial para un negocio local (dirección, teléfono, horarios, etc.), y verificar el resultado mediante múltiples comprobaciones automáticas. Soporta plataformas como Vercel para despliegue y usa scripts Node.js (homepage.mjs) para inicializar, capturar referencias, generar tableros de propuestas, extraer textos, revisar cumplimiento y comparar visualmente con las referencias. El skill incluye un flujo detallado con pasos obligatorios que requieren aprobación humana, reglas estrictas sobre atribución de fuentes, uso de imágenes reales y comprobaciones de accesibilidad, legalidad (origen de alimentos, JSON-LD para negocio local) y calidad de redacción (usando humanize-korean si está disponible). Está diseñado específicamente para el mercado coreano, con soporte para mapas Naver/Kakao, etiquetado de origen de carnes, y tipografía coreana correcta.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿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.

MomentoInvestigación necesaria
Antes del briefingInformació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 direccionesCanales de competidores y negocios alternativos (reseñas, textos promocionales, existencia de web), definición de la marca
Antes de finalizar textosPalabras clave, posicionamiento en buscadores
Antes del despliegueTitular 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.

  1. init — Verifica con la tabla anterior que la investigación previa esté completa, luego crea sites/<slug> con brief.md, facts.md, refs.md, site/ y refs/.
  2. 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).
  3. 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, check fallará.
  4. 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).
  5. Capturar y registrar — Captura con ref de 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 en refs/<slug>/ y se registran en refs.md. Anota en una línea "qué se tomó" de cada referencia. No copies el layout, las fotos ni los textos. Ver método en references/moves.md.
  6. ⛔ Proponer tres direcciones — Con board, genera out/board.png y una carpeta out/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.
  7. Construcción por secciones — Crea site/index.html (con CSS e imágenes dentro de site/) sección por sección. Cada <section> debe llevar data-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 en references/korea-local.md.
  8. Edición de textos — Con copy, extrae los textos visibles de la página por bloques y guárdalos en sites/<slug>/_workspace/<fecha>-NNN-<tag>/01_input.txt (se excluyen líneas de atribución de fotos y áreas data-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 obtener final.md, pásalo por verify_gates.py y luego traslada solo las frases cambiadas a site/. No modifiques números, nombres propios ni citas. Si no hay herramienta, este paso solo extrae los textos.
  9. Verificación (check) — Corrige hasta que no haya fallos (✗). Durante el trabajo puedes usar --draft para bajar los fallos a advertencias, pero la entrega y el despliegue deben pasar sin --draft.
  10. Comparación visual — Con shots --compare, genera out/compare.png para ver la página junto a las referencias seleccionadas. También abre out/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.
  11. ⛔ Aprobación — Obtén la aprobación con compare.png, site-mobile.png y out/report.json.
  12. Despliegue — deploy solo sube a Vercel si check pasa. 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; --prod solo 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 por ref. 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)

CompuertaCondición de fallo
refsMenos de 3 referencias con "qué se tomó" anotado
attributionSección sin data-ref, o que apunta a una referencia no existente en refs/
factNúmero en la página que no está en facts.md
placeholderQuedan [...], 【...】, lorem, TODO
claim · originExpresión exclusiva sin evidencia, o menú de carne + precio sin línea de origen
localFalta JSON-LD LocalBusiness/Restaurant, enlace tel:, enlace al mapa Naver/Kakao, horario de atención
metaFalta og:title, og:image, lang="ko", viewport
koreanEl body no tiene word-break: keep-all
a11y · contrastImagen sin alt, incumplimiento de WCAG AA en contraste
mobileScroll horizontal a 390px, texto del cuerpo menor a 16px (botón menor a 44px es advertencia)
template · weightGradiente púrpura, frases cliché, imágenes pesadas (advertencia)
copy-styleLa 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 MCPhomepage-maker
ReferenciasUna sola fuente: curación editorial de MuzliColecciones públicas de Muzli + SiteInspire, Land-book, Lapa Ninja, One Page Love, Awwwards
Atribución de fuenteSe indica en la conversaciónObligatorio por sección con data-ref; sin ello, falla
Análisis de referenciasImagen y descripciónCapturas escritorio + móvil + tokens de fuente, tamaño, color, ancho
Verificación de resultadoNingunaCompuertas de hechos, legalidad, negocio local, móvil, contraste, coreano + puntuación de aspecto AI (humanize-korean)
Revisión visualNingunaImagen comparativa lado a lado con referencias
Desplieguemuzli.space (sin indexar, sin formularios, límite 10)Vercel (indexable, dominio propio posible)
Sectores coreanosNingunoMapa Naver, reservas, JSON-LD, origen de ingredientes, salto de línea coreano
Ventaja de MuzliCuración basada en 900k diseñadores, uso de colecciones propiasSolo usa colecciones públicas, sin personalización

Skills relacionados