Communitygithub.com

moat-landing

Construye una landing page 3D con desplazamiento a partir del sitio web de una empresa o de su diferenciador: investigación, narrativa, color, un héroe 3D reconocible, imágenes fijas, animación, datos SEO, seguimiento de conversiones y verificación de capturas de pantalla en escritorio y móvil. Un solo archivo de contenido impulsa un motor compartido, manteniendo cada página de cliente distinta.

¿Qué es moat-landing?

Esta skill permite convertir una empresa (su sitio web en vivo o una frase que describa su diferenciador) en una landing page 3D completamente funcional, lista para producción y con verificación visual. El motor principal está en `template/`; para cada cliente solo se escribe un archivo, `src/content.js`, se genera el material gráfico y se verifica el resultado. Los cambios en el motor se integran de vuelta en `template/` para que el próximo cliente los herede automáticamente. La skill es compatible con agentes como Claude Code, Cursor y Codex, y su flujo de trabajo es exhaustivo: comienza con la investigación y el análisis del sitio del cliente, seguido de la estrategia (definición del tipo de diferenciador, metáfora visual, plan de capítulos), dirección artística (paleta de color 60·30·30 basada en la marca, tipografía propia, sin glow), generación de imágenes (fotografías o renders), construcción del código, verificación obligatoria en cada iteración (presupuesto de assets, capturas de pantalla en escritorio y móvil, checklist de SEO y comportamiento) y finalmente la entrega al cliente. El diseño se rige por reglas estrictas: reconocimiento en un segundo, sin glow ni texturas sobre el texto, paletas luminosas para negocios físicos, etiquetas ancladas en lugar de rayos X, y nunca enviar placeholders visibles. También impone condiciones no negociables como un solo héroe 3D por página, texto siempre en HTML (nunca incrustado en texturas), honestidad absoluta en métricas y datos, respeto a la marca del cliente, y un presupuesto de assets muy ajustado (JS ≤ 55 KB, stage ≤ 205 KB, imágenes ≤ 500 KB, etc.).

Compatible con✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/thisisshivamtiwari/3d-landing-pages-skill/tree/HEAD/moat-landing

Preguntar en tu IA favorita

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

Documentación

Moat → Página de aterrizaje 3D

Conviertes una empresa (su sitio en vivo, o una frase de su diferenciador) en una página de aterrizaje terminada, en funcionamiento y verificada con capturas de pantalla. El motor está escrito (template/); por cada cliente escribes un solo archivo, src/content.js, generas imágenes y verificas. Los cambios en el motor se trasladan a template/ para que cada siguiente cliente los reciba.

Lee según sea necesario (todo en references/): intake.md investiga al cliente · narrative.md diferenciador → historia → texto · art-direction.md teoría del color, tipografía, luz, legibilidad · scenes.md objeto vs escena, cortes de sección · engine.md esquema y módulos · qa.md scripts de captura y rúbrica · advanced.md assets reales y hoja de ruta de tendencias · lessons.md cada error hasta ahora — hojéalo antes de empezar. Investigación de referencia (guardada con la skill): references/research/oryzo-teardown.md, graphify-teardown.md, video-and-writeup-research.md. Clientes trabajados: pages/poolco/, pages/secureco/, pages/hotelsaas/.

Las referencias en un párrafo

Oryzo mantiene un solo objeto héroe en el centro del escenario y cambia el mundo a su alrededor (cámara, modo de renderizado, gradación, luz/oscuridad) — texto breve e inexpresivo, una declaración + una prueba por compás; un solo lienzo WebGL fijo detrás de un DOM alto, cada valor suavizado es un resorte. Graphify usa el 3D como condimento: un "cómo funciona" pegajoso cuyo diagrama es la metáfora del producto (wireframes SVG proyectados), y vende con densidad de pruebas. Los fusionamos — y, para negocios físicos, reemplazamos el objeto abstracto con una escena real y reconocible que se pueda abrir y etiquetar.

Flujo de trabajo (hazlo todo, en orden)

1 · Investigación y análisis → research/<slug>/brief.md

Si el cliente tiene un sitio web, raspa todas las páginas primero (intake.md): texto, servicios, proceso, ubicaciones, FAQ, términos/descargos, archivo de logotipo real, colores y fuentes de la marca muestreados, contacto público. Extrae: empresa, el diferenciador en una frase (su afirmación recurrente), compradores, la CTA real, pruebas que realmente existen. Pregunta al usuario una sola vez por lo que no se pueda encontrar o inferir. Credenciales / números de cuenta / datos personales en la entrada → detente y advierte primero.

2 · Estrategia (escrita en el brief antes del código)

  1. Tipo de diferenciador → metáfora (narrative.md §2).
  2. ¿Objeto o escena? Aplica la prueba del segundo uno (scenes.md). Lugares/instalaciones → escena (patrón pool); software sobre acceso/visibilidad → repo; software para lugares que funcionan con el reloj (hoteles, locales, venta minorista) → city; productos → formas de objeto.
  3. Línea de tesis (hábito de categoría vs lo que el diferenciador hace realidad).
  4. Plan de capítulos: 10–15 capítulos (narrative.md §3, o §3b orden de construcción para negocios de servicios). Cada capítulo cambia ≥ 2 de: cámara, escenario/modo, gradación, valor, forma de diseño.
  5. Todo el texto (§4): titular ≤ 7 palabras, cuerpo ≤ 35, una declaración + una prueba, solo del brief.
  6. Varía el formato — no dos clientes obtienen la misma página. Decide, y escribe en el brief, qué significa el desplazamiento (un viaje, una orden de construcción, un reloj…), qué hace el lector (leer, tocar, arrastrar, jugar), y a qué responde el 3D (solo desplazamiento, o widgets mediante send/receive). Para software con un repositorio, haz que los capítulos sean jugables (type: 'play'): copias pequeñas y honestas de los componentes reales del producto con datos de demostración que muevan el 3D (engine.md → HotelSaaS).

3 · Dirección artística

art-direction.md: paleta 60·30·10 basada en la luz a partir de la marca + color del producto + un acento complementario (explica la teoría en la entrega), las fuentes propias del cliente, bloom 0 para realismo, tarjetas de texto sobre 3D recargado, fotogramas clave móviles para cada capítulo 3D.

4 · Material gráfico (en paralelo)

Escribe research/<slug>/images.json (una foto por servicio + og) y ejecuta node .claude/skills/moat-landing/tools/gen-batch.mjs research/<slug>/images.json en segundo plano mientras construyes. Revisa la hoja de contactos; regenera los rechazos. Los archivos originales se quedan en research/, nunca en public/. Clave: GEMINI_API_KEY en tu entorno de shell — nunca la imprimas ni la pases como argumento. Marcas de software / desarrolladores: omite la fotografía; haz public/og.jpg a partir de tu propio render del héroe (captura de pantalla de 1200×630) una vez que el héroe esté aprobado.

5 · Construcción

SLUG=<slug>; ROOT="${CLAUDE_PROJECT_DIR:-$(pwd)}"
mkdir -p "$ROOT/pages/$SLUG" && rsync -a --exclude node_modules --exclude dist "$ROOT/.claude/skills/moat-landing/template/" "$ROOT/pages/$SLUG/"
cd "$ROOT/pages/$SLUG" && npm install

Reescribe src/content.js (esquema: parte superior del content.js de la plantilla + engine.md), incluyendo meta.url/image, business, brand.copyCards, quickActions, notas de capítulo notes/cover/mobile. El CSS específico de la página va en brand.css. Nueva capacidad → constrúyela en template/, luego rsync -a --exclude content.js template/src/ pages/<slug>/src/.

5b · Otras páginas (cuando el sitio del cliente las tiene)

Reconstruye cada página del sitio original en su URL original (src/pages/<slug>.js, engine.md → Multi-página): cada subpágina mantiene el mismo mundo 3D, el lenguaje de tarjetas y una pieza jugable (características → un explorador, precios → un selector de planes, acerca de → un widget de historia); las páginas legales usan el tipo doc con el texto en vivo (marca fechas y jurisdicción para revisión); el contacto usa el formulario de WhatsApp/correo electrónico (sin backend sin aprobación).

6 · Verificación (obligatorio, cada iteración, ambos tamaños)

npm run check (puerta de presupuesto) → vista previa → captura todos los capítulos a 1440×900 y 390×844 → hojas de contactos → comprobaciones de comportamiento + SEO → la rúbrica en qa.md. Espera 2–3 rondas.

7 · Entrega

Dónde se ejecuta (npm run dev / URL de vista previa), tesis, mapa de capítulos, la justificación de la teoría del color, qué debe proporcionar el cliente todavía (pruebas reales, endpoint del formulario, IDs de analytics, dominio), valores predeterminados elegidos, y las 2–3 mejoras principales de advanced.md §9. Recuerda que las cifras, las afirmaciones regulatorias y comparativas deben verificarse antes de publicar. Actualiza lessons.md y la memoria con cualquier cosa aprendida.

Reglas de diseño (a partir de comentarios de clientes — aplica por defecto)

  • Reconocimiento en un segundo. Construye lo real primero; luego ábrelo.
  • Sin glow. Bloom 0 para cualquier cosa real; la luz proviene del sol, el cielo y las fuentes dentro de la escena.
  • Paletas claras y soleadas para negocios físicos/de servicios; oscuro solo para temas nocturnos/técnicos.
  • Nunca texto sobre textura. Tarjetas sobre agua, azulejos y 3D recargado.
  • Explica con cortes de sección + etiquetas ancladas, no con glow de rayos X.
  • Nunca envíes placeholders visibles. Prueba faltante → omite el capítulo, enuméralo en la entrega.

No negociables

  • Un héroe (objeto o escena) para toda la página; el contenido de flujo vive en los capítulos cover.
  • Limpia el escenario, activa el texto (el texto se reproduce al volver a entrar; nunca de una sola vez).
  • El texto es HTML, nunca horneado en texturas o imágenes; los datos estructurados solo declaran lo que la página muestra.
  • Honestidad. Sin métricas inventadas, clientes, logotipos, citas, certificaciones o datos de competidores; las imágenes generadas etiquetadas como ilustrativas; las personas generadas nunca presentadas como clientes.
  • Nunca te hagas pasar por una marca que el usuario no tiene derecho a representar; los demos ficticios lo dicen.
  • Marca. Siempre la marca propia del cliente (fuentes, colores, logotipo) — léelos del sitio en vivo.
  • Presupuesto (npm run check): JS de página ≤ 55 KB gz, stage ≤ 205 KB gz, imágenes ≤ 500 KB, un lienzo, DPR ≤ 1.75; funciona con WebGL desactivado, movimiento reducido activado, a 390 px; 0 errores de consola; 0 desbordamiento.
  • Sin despliegues, endpoints de formulario, IDs de analytics o cuentas externas sin la aprobación explícita del usuario.

Skills relacionados