Communitygithub.com

omd:landing — Landing abrumador de una página

Crea landing pages de una sola página con scroll nativo que abruman al visitante: concepto, composición, colocación de activos y coreografía de scroll derivados de DESIGN.md y el codex landing-craft. Activación: '랜딩 페이지', '원페이지', 'landing page', 'one-pager', 'hero to footer', '스크롤 랜딩', 'affinity.studio 같은'.

¿Qué es omd:landing — Landing abrumador de una página?

Esta skill, `omd:landing`, está diseñada para generar una landing page de una sola página, centrada en el scroll, que abruma al visitante mediante un concepto visual unificado, composiciones variadas y una coreografía de scroll precisa. Se basa en tres fuentes principales: el archivo `DESIGN.md` del proyecto (para la identidad de marca), el codex `landing-craft-codex.md` (para reglas de diseño probadas) y un brief proporcionado por el usuario. La skill orquesta todo el flujo de trabajo: desde la definición del concepto por el `omd-art-director`, la creación de un storyboard detallado con 6-8 secciones (incluyendo presupuesto de densidad, plan de activos y puntos de abrumamiento), la generación de activos visuales a través del canal `omd:media`, hasta la construcción de un archivo `render.html` independiente y responsivo. Finalmente, ejecuta un bucle de autoevaluación de hasta 3 iteraciones usando herramientas de integridad de renderizado, integridad de landing y contraste de texto, seguidas de una revisión de diseño y una verificación de comportamiento real (incluyendo interacción sin JS, modo de movimiento reducido y objetivos táctiles). La skill prohíbe inventar tokens de marca o reglas de diseño no respaldadas, y garantiza que el diseño final sea accesible, responsivo y estéticamente cohesivo, deteniéndose si encuentra fallos no resueltos.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/nococn/omd-landing/tree/HEAD

Preguntar en tu IA favorita

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

Documentación

¿Qué hace omd:landing — Landing abrumador de una página?

Una sola página que, con el scroll, se acumula y abruma al visitante. No se trata de colocar una cuadrícula de tarjetas, sino de que un concepto visual único nazca en el héroe, varíe en cada sección con una composición diferente y se cierre en el CTA. La base de marca se obtiene del proyecto DESIGN.md, las observaciones de composición del Códex Landing Craft (reglas ID LC-n), y la autoridad sobre el comportamiento del producto y las decisiones locales se lee del brief. Ubicación del códex — repositorio: docs/design-excellence/landing-craft-codex.md · instalación: node_modules/oh-my-design-cli/docs/design-excellence/landing-craft-codex.md (Si no existe ninguno, usa node -p "require('path').dirname(require.resolve('oh-my-design-cli/package.json'))" para encontrar la raíz del paquete y lee docs/design-excellence/ debajo de ella). Si no se ha leído ninguno de los dos, no se empieza.

Entrada

  1. Texto completo de DESIGN.md (si es Core v2, los anclajes de los §Scope·Foundations·Components·Content·Motion; si es legacy, todas las secciones). Solo se usan los tokens que están aquí — no inventes nada. Lo pendiente en .omd/preferences.md sobrescribe a DESIGN.md.
  2. Brief de al menos una línea: lo que el visitante debe sentir + la acción que debe realizar. Si no hay, se pide con una tanda de preguntas (máximo 5). En modo desatendido (unattended), toma la primera opción de cada pregunta y lo anota como autoSelected en trace.md.
  3. Códex landing-craft-codex.md — lee la tabla de reglas tal cual y, para esta ejecución, elige los IDs de regla que aplicar y anótalos en el storyboard.

Directorio de ejecución (se crea primero)

SLUG=$(printf '%s' "<brand-or-brief>" | tr '[:upper:] ' '[:lower:]-' | tr -cd 'a-z0-9-' | cut -c1-40)
RUN=.omd/runs/landing-$SLUG-$(date +%Y%m%d-%H%M)
mkdir -p "$RUN/assets" && printf '%s\n' "<brief original>"> "$RUN/task.md"

<run> = $RUN anterior. La salida se escribe únicamente dentro de este directorio (convención similar a omd-harness, y se añade una línea a .omd/runs/INDEX.md).

Salida (solo dentro del directorio de ejecución)

<run>/
  concept.md          Salida del director de arte: una frase de concepto, ambiente, uso de paleta, dirección de activos, lista de prohibiciones
  storyboard.md       Tabla de secciones: orden·propósito·altura de viewport·composición (LC-n)·plan de activos (prompts)·dirección de scroll·esqueleto de copy
  assets/             Imágenes generadas (canal omd:media) + SVG inline original
  render.html         Archivo único (0 peticiones externas), responsivo 1440·390, revelados con IntersectionObserver, pinned ≤1, reduced-motion
  system.md           Descripción del sistema de diseño de esta página (incluyendo rutas de citas de tokens)
  loop-trace.json     Defectos por iteración de autoevaluación (render-integrity·landing-integrity·designer-review), autoSelected
  trace.md            Prompts de imagen originales, canal, costo, sha256, reintentos

Procedimiento

1. Concepto (agente omd-art-director)

De los hechos de marca de DESIGN.md (§1 narrativa·§Principles·§Voice) y del brief, extrae una frase de concepto. El concepto no es una lista de adjetivos, sino "lo que la página muestra" (ej.: "Se ve un corte transversal de la tubería por donde fluye el pago"). El director de arte escribe en concept.md el concepto, el ambiente, la dirección de los activos y lo prohibido (antipatrones del códex + "reflejos de diseño generado" tipo Vercel). Antes de construir, coloca en el mismo archivo una tabla de alcance de aplicación: Decisión | Tipo de fundamento (hecho de marca/decisión de proyecto autorizada/observación del códex) | Origen·superficie objetivo | Aplicación aquí/razón de no resolver | Método de verificación. Las observaciones planas de un control público son evidencia de ese control, no fundamento para prohibir todos los objetos 3D e iluminación del landing. No eleves una dirección de escena local a hecho corporativo, ni crees tokens no confirmados. Si el origen y el objetivo son diferentes, déjalo como motivo de revisión. Si hay activos ya incluidos en el prompt de invocación, descríbelos con palabras y pásalos (sujeto·composición·color dominante·ubicación del espacio vacío; el tamaño en píxeles con sips -g pixelWidth -g pixelHeight). El director de arte no abre archivos de imagen con Read — hay casos documentados (dogfooding 2026-09-02) de que la sesión se cuelga tras el tool_result de imágenes grandes.

2. Storyboard

Entre 6 y 8 secciones. Cada sección debe incluir: (a) una frase de propósito, (b) altura de viewport (citando la regla de ritmo de sección del códex), (c) patrón de composición — nombre del patrón de la tabla del códex y LC-n (bleed / inset / stacked / split / pinned-reveal …), (d) plan de activos — tipo (foto/render/ilustración/UI abstracta)·estado/significado del producto que ilumina·proporción·posición·objetivo de ocupación del sujeto en pantalla·prompt de generación original (fija los hex de la paleta de marca en el prompt), (e) dirección de scroll (método de revelado, duración·easing con tokens de Motion de DESIGN.md), (f) esqueleto de copy. Determina un punto de abrumamiento: la sección donde la página alcanza su clímax y la sección de espacio en blanco justo antes.

Presupuesto de densidad (escríbelo con números — solo con descripciones se obtiene una página vacía)

El número y la proporción por sí solos no demuestran una escena significativa. Conserva las cifras siguientes, pero planifica qué estado/significado del producto revela cada activo y el área de ocupación del sujeto real (no del contenedor), y verifícalo en el render. Quedan prohibidos: SVG repetitivos para llenar conteo, recortes/ampliaciones del mismo papel en blanco, imágenes satelitales sin significado.

Límite con omd-restraint (Dial de densidad LC-59). El suelo inferior se aplica en su totalidad cuando el dial ≥ 6 (landing de showcase). Si el dial ≤ 5 (páginas de producto/catálogo/documentación), ganan los límites superiores de omd-restraint (piezas de primera pantalla ≤ 5, tamaño de fuente ≤ 4, CTA ≤ 2 …). En cualquier caso, se mantienen R1 (un foco)·R2 (piezas de primera pantalla)·R10 (un hecho solo una vez).

  • Cantidad total de medios ≥ vh de la página × 1.0. Si la página tiene 12vh, debe haber 12 o más medios. Cuenta imágenes·videos·SVG inline significativos (no cuentes iconos individuales — solo los de ≥24px y que no sean decorativos, sino contenido).
  • Medios en el pliegue (primera pantalla) ≥ 3. En la medición del códex, el pliegue de affinity tiene 8.
  • Si usas scroll horizontal (LC-15), los elementos deben ser ≥ 8. Un scroll horizontal de 3-4 elementos no es una válvula de densidad, es una línea vacía.
  • Activos con movimiento ≥ 1. Si omd:setup ha reservado un canal de video, usa image_to_video para convertir un activo de sección en un bucle de 6 segundos. Con prefers-reduced-motion, sustitúyelo por una imagen fija del mismo fotograma (autoplay·muted·loop·playsinline). Si no hay canal, anótalo en trace.md — no lo omitas en silencio.
  • Objetivo de tinta por sección ≥ 26% (límite inferior de la banda medida del códex 26–54%). Si no se alcanza, ajusta padding·tamaño de sujeto·expresión de estado necesaria.
  • No unifiques el padding vertical con un mismo vh fijo. En la primera salida, todas las secciones tenían 18vh/24vh igual, sin ritmo (mediana = máximo = 378px). Reduce el padding en las secciones de baja densidad y da un margen grande solo antes y después del punto de abrumamiento.

3. Activos

Ejecuta los prompts del storyboard a través del canal detectado por omd:media (sin canal → deja el pack de prompts y la cola manual en assets/QUEUE.md, y coloca placeholders SVG abstractos de la paleta de marca en su lugar — prohibido stock·emojis). Prohibida la generación de fotos de rostros, prohibida la generación de logotipos (marcas de texto). Anota en trace.md el prompt·canal·costo de cada imagen. Las generaciones fallidas se corrigen según la causa; los límites de canal y los placeholders se anotan en trace.md con el número real. Si una sola escena original cumple el propósito, no añadas duplicados; renderiza la versión de revisión con esa composición. El incumplimiento del presupuesto de densidad y el FAIL del checker en bruto se dejan tal cual para su revisión en el límite de aplicación. La generación de la versión de revisión no es finalización, waiver ni PASS. La proporción de la imagen se obtiene de la relación de aspecto real medida del slot donde irá (prohibidos valores por defecto — omd:media §1).

4. Construcción

render.html independiente. Las variables CSS usan los nombres de token de DESIGN.md tal cual (--color-…, --space-…). Restablece los estilos por defecto del agente de usuario (márgenes de figure/blockquote — #78). Las imágenes usan rutas relativas a assets/ o data URI. El movimiento solo con transform·opacity, duración en 3 niveles como máximo, y con @media (prefers-reduced-motion: reduce) se detiene todo. El ancho máximo del texto·la escala tipográfica·la altura de la sección deben estar dentro de los rangos numéricos del códex. El texto sobre fotografías debe llevar una pantalla (scrim) (LC-36 "Lo abrumador debe ser legible"): héroe·etapas fijas (pinned)·secciones de inversión·nav·wordmark· lead·CTA·anillos de foco deben superar WCAG 4.5:1 (normal)·3:1 (texto grande·UI) de contraste con los píxeles del fondo, y el medio es una pantalla alfa de color token (::before) y un halo de anillo de foco — el primer intento sin pantalla obtuvo BLOCK 6 con nav 1.05:1·wordmark 1.07:1. Los tokens de la serie muted no se usan en ningún texto de cuerpo, incluyendo cejas y avisos legales (3.0:1). Los revelados por scroll (opacity:0) deben ser visibles sin <noscript> y con @media (scripting: none) — una página vacía sin JS es un defecto. Los requisitos de contraste·teclado y el objetivo de operabilidad táctil de esta skill no son geometría de marca observada. Si no se cumplen con las combinaciones de tokens existentes, se propone la decisión local necesaria en la tabla de alcance de aplicación y se siguen los límites de autoridad. No se exime de un fallo de accesibilidad por "coherencia de marca".

5. Bucle de autoevaluación (máximo 3 veces — solo después de completar todas las comprobaciones de aplicación)

Si el repositorio tiene test-v2/tools/, usa la ruta de la izquierda; si no (paquete instalado), usa el comando omd entre paréntesis — son la misma herramienta.

① node test-v2/tools/render-integrity.mjs <run>/render.html   (instalado: omd check render <run>/render.html)      # determinista
② node test-v2/tools/landing-integrity.mjs <run>/render.html  (instalado: omd check landing <run>/render.html)     # reglas mecánicas del códex
②′ node test-v2/tools/text-contrast.mjs <run>/render.html     (instalado: omd check contrast <run>/render.html)    # texto sobre foto·gradiente·anillo de foco·no-JS (bloqueos de las dos primeras iteraciones)
③ Capturas de pantalla reales en ruta 1440·390: contrasta los límites de cada sección y los estados hero·peak·acción·resultado con el storyboard
③-b Anota el veredicto en bruto del suelo de densidad LI-24~26 (tinta de pantalla 12%·medios en pliegue 3·medios 1/vh) junto con la revisión del límite de aplicación

④ Spawn del subagente `omd-designer-review` (Agente, entrada: ruta absoluta de `<run>/render.html` + ruta de DESIGN.md del proyecto + límite de 20 llamadas a herramientas·15 min·esqueleto de review.md primero — solo cuenta los BLOCK)

③ no termina solo con la captura. El implementador mira la imagen directamente y verifica que el título·sujeto·control correspondiente·resultado estén dentro del fotograma. No confundas el recorte central de scrollIntoView de una sección grande con el inicio de la sección. Agrupa viewport·posición de scroll·estado·hash de salida, y vuelve a tomar los fotogramas recortados. El recorrido de scroll/cámara también se verifica con entrada real; no se afirma continuidad solo con seek de QA. Deja el método de medición y el valor medido del área del sujeto por activo para contrastarlo con el objetivo de ocupación. Si es una estimación, márcalo como tal.

En las páginas con acciones, ejecuta realmente los elementos aplicables: vacío → error inline de entrada incorrecta → corrección → guardar → recargar, entrada/ejecución/retorno con teclado, objetivos táctiles renderizados ≥44×44 CSS px (objetivo de operabilidad de esta skill, excluyendo enlaces inline del cuerpo), alternativas no-JS·reduced-motion. Los errores se verifican por conexión de campo·focus·aria-invalid; los resultados de guardado se verifican por el contenido correspondiente y su persistencia. Los elementos no aplicables (como páginas sin función de guardado) se anotan con el fundamento de la tarea; no se sustituye la acción con un conmutador de estado de desarrollador.

Solo se corrigen los elementos con FAIL. En loop-trace.json se registran los defectos por herramienta·evidencia de comportamiento·confirmación de fotograma·④BLOCK·elementos no ejecutados. Incluso si solo ①② pasan, no se omiten el contraste·comportamiento·pantalla real·revisión independiente. La verificación está completa solo cuando todas las comprobaciones de aplicación están hechas y no hay FAIL/BLOCK sin resolver. Si el número de defectos no disminuye o el mismo ID de regla falla dos veces consecutivas, se detiene el bucle de corrección y se reporta como omd:issue. Detenerse no es un éxito; se dejan las comprobaciones no ejecutadas. La revisión de conflicto de fuentes y el veredicto del checker en bruto se conservan por separado; no se crean waivers arbitrarios.

6. Demostración

Con omd:showcase <run>/render.html se crea un video de scroll (mp4/gif) (si no existe, test-v2/content-runs/build-scroll-compare.mjs captura fotogramas → ffmpeg). En la parte inferior se debe ver un aviso no oficial. Distingue entre el video de entrada real y un montaje de fotogramas fijos. El resultado de la verificación y la adopción visual por parte del usuario se reportan por separado; no se afirma aprobación estética ni finalización de adopción antes de que el usuario adopte el resultado.

Resumen de aplicación del códex (el texto completo está en el códex; aquí se indica en qué etapa se miran qué reglas)

EtapaReglasValores clave (medidos, 5 sitios)
Concepto·pliegueLC-13, LC-3336Los activos de primera pantalla cubren 89130% del viewport y sangran por ≥2 lados; titular en el tercio superior (17.639.7 %vh); anclaje izquierdo 5.4~14.4 %vw; el clímax temprano, con escala (sección anterior con menor proporción de texto → sección siguiente con la mayor)
RitmoLC-8~12, LC-14Página de 1016 vh (excluyendo pinned fijo); mediana de secciones de cuerpo 1.01.9 vh; etapa pinned exactamente 1 viewport; revelados 0.1~6.8/viewport según dial; prohibido snap vertical
Composición·margenLC-4~74674% de la sección es espacio vacío; el texto ocupa 2.613.6% de la sección; dos carriles (bleed 1440 + lectura 672/1232/1264); un solo gutter (48/88/92/104px) en toda la página
ActivosLC-17~20, §6 tabla2963 imágenes por página·37 por sección; activos bleed 16:9; solo dos disposiciones: bleed o inset (esquinas redondeadas, recorte inferior); stock 0 — productos·trabajos de clientes
TipografíaLC-21~25display:body 3.04.6× (si es serifa, 7×); cuerpo 1417px; escala UI 1.051.20, un solo salto en la parte superior 1.331.75; contraste de peso pequeño (300/300 también); solo display latino −0.02em
Color·inversiónLC-26~28Mantener un solo fondo (252 o 12); inversión solo en una sección (dispositivo de énfasis); tinte alrededor de 240,240,252
MovimientoLC-13, LC-29~32Una duración dominante (100/300/320/400ms, 3370%); 23 niveles, el segundo 1.3~1.6×; solo opacity(+transform), clip-path·filter 0; reduced-motion obligatorio
AutoevaluaciónLI-1~23 · #86landing-integrity.mjs para veredicto mecánico (vh de página·proporción de secciones·cobertura de pliegue·proporción tipográfica·gutter·duración·easing·snap·atributos de video·hosts de stock·cuadrícula uniforme de tarjetas·h1) · text-contrast.mjs para contraste de texto sobre foto·anillo de foco·no-JS

Reglas estrictas

  • Prohibido inventar tokens·hechos de marca que no estén en DESIGN.md. Prohibido inventar reglas de "gusto" que no estén en el códex — las decisiones sin fundamento se marcan como "suposición" en concept.md.
  • Si los valores del códex y los tokens de DESIGN.md entran en conflicto, DESIGN.md prevalece (ej.: códex LC-21 display:body 3.0×↑ vs Toss h1 36/body 14 = 2.57×). Primero verifica si el objetivo de aplicación es el mismo; si no se alcanza el rango, déjalo en la tabla de alcance de aplicación con el fundamento. Esto no es un PASS automático. Cuando un DESIGN.md no tiene tokens de Motion (que son mayoría), se usan los valores del códex LC-29/30 (300/400ms, etc.) marcándolos como "extensión local".
  • Prohibido usar copias·capturas·logotipos originales de sitios reales. Prohibido inventar cifras estadísticas.
  • Solo se crea una página. Las solicitudes de varias páginas se redirigen a omd:autopilot (multipáginas).
  • Esta skill es un generador. El veredicto lo emiten las herramientas y omd-designer-review — no escribas que "está bien" por ti mismo.

Skills relacionados