Communitygithub.com

Im-Fran/landing-skills

Úsalo al implementar una página de aterrizaje en código, incluyendo estructura HTML, CSS, diseño responsivo, fuentes, imágenes, metaetiquetas, tarjetas sociales, datos estructurados, formularios de captura, accesibilidad o rendimiento de carga, en HTML plano, Astro, Next, Vite con React o Tailwind.

¿Qué es landing-skills?

Este skill está diseñado para construir páginas de aterrizaje estáticas que funcionen completamente sin JavaScript, garantizando que un visitante pueda leer cada sección, navegar desde el encabezado y enviar el formulario. Previene dos errores comunes: el uso incorrecto de `padding` en contenedores que sobrescribe el espaciado vertical de las secciones, y formularios no funcionales (con `action="#"` o `onsubmit="return false"`). El skill lee los archivos `brief.md`, `copy.md`, `direction.md` y `tokens.css` para obtener especificaciones de diseño, copia y tokens visuales. El proceso incluye 11 pasos: detectar el stack (Astro, Next, Vite+React, HTML plano, Tailwind), inventariar contenido, escribir la cabecera con SEO, cargar fuentes autohospedadas, construir el esqueleto con secciones y contenedores bien separados, maquetar cada sección con elementos semánticos, colocar medios reales o placeholder, construir la acción de conversión (enlace externo o formulario con endpoint real), cumplir con accesibilidad, evitar animaciones (dejando placeholders estáticos), y entregar un informe detallado al usuario. Soporta stacks como Astro, Next.js, Vite con React, HTML plano con Tailwind, y otros. Usa referencias técnicas en `references/` para SEO, CSS, formularios, rendimiento y adaptadores específicos de cada stack.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Im-Fran/landing-skills/tree/HEAD/skills/landing-build

Preguntar en tu IA favorita

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

Vista previa

Del README del skill

landing-skills preview

Documentación

Landing build

Convierte la copia aprobada, la dirección visual y los tokens de diseño en una página estática que funcione completamente con JavaScript desactivado. Completamente significa que un visitante puede leer cada sección, llegar a cada sección desde el encabezado y enviar el formulario. Las animaciones y el 3D vienen después, desde landing-skills:landing-motion, y se apoyan sobre una página que ya funciona.

Dos errores aparecieron en más de una compilación de prueba hecha sin este skill, y este skill está diseñado para hacer ambos imposibles:

  1. Una clase de contenedor con un shorthand padding sobrescribió el padding vertical de la sección, por lo que cada sección quedó pegada a la siguiente. La solución es estructural: la sección controla el eje del bloque, el contenedor controla el eje en línea, y ninguno usa el shorthand (paso 5).
  2. Un formulario muerto: action="#", onsubmit="return false", o un script que mostraba "Gracias" y descartaba los datos. La solución: un action real, un method real, una página de éxito respaldada por el servidor, y ningún mensaje de éxito que la página no pueda respaldar (paso 8).

Entradas

Lee estos archivos del proyecto del usuario antes de escribir código.

ArchivoQué tomas de él
landing/brief.mdlos campos que escribe landing-skills:landing-page. Usas: Idioma (para lang); Acción de conversión (ya sea un formulario con sus campos y endpoint o ninguno aún, o una URL externa); Stack (con el nombre indicado, o detectar); Dominio (el dominio de producción, o desconocido); Rutas de contacto (para el pie de página y /form-error/); Activos disponibles
landing/copy.mdun H2 por sección de página en orden de página; el último H2, Placeholders, lista cada espacio vacío
landing/direction.mdtipografías con fuente y licencia, la fila de diseño para cada sección, imágenes con relaciones de aspecto, superficies, y el H2 final Motion and 3D intent
landing/tokens.csslas propiedades personalizadas: --color-*, --font-*, --text-*, --space-*, --radius-*

Cuando falta una entrada:

  • Sin copy.md: no escribas copia de marketing por tu cuenta. Pide al usuario el texto o sugiere landing-skills:landing-copy. Si el usuario te da texto, úsalo tal cual. Nunca inventes pruebas: nada de testimonios, logotipos, conteos o valoraciones. Una pieza faltante se convierte en [PLACEHOLDER: lo que se necesita].
  • Sin direction.md o tokens.css: sugiere primero landing-skills:landing-art-direction. Si el usuario quiere continuar sin ello, escribe landing/tokens.css tú mismo con los cinco prefijos, deriva los valores de las restricciones de marca que el usuario dé, e informa al usuario que estos tokens son provisionales.
  • Sin brief.md: pregunta por el idioma, la acción de conversión (un formulario y dónde debe publicarse, o una URL externa), el dominio de producción y una ruta de contacto.
  • Un campo del brief que dice desconocido o ninguno aún es un vacío, no un error: construye con la regla que este skill da para ello (sin etiquetas URL sin dominio, el placeholder /api/lead sin endpoint, una línea de contacto placeholder sin rutas de contacto) y enuméralo en la entrega. Detecta el stack a partir de los archivos del proyecto (consulta "Detección de stack") en lugar de preguntar cuando puedas.

Proceso

1. Detectar el stack

Usa la tabla en "Detección de stack". Lee la sección correspondiente de references/adapters.md antes de escribir archivos; cubre solo lo que difiere de las recetas simples en las otras referencias.

2. Hacer un inventario

Antes de cualquier marcado, anota:

  • Cada H2 de copy.md y la <section> en que se convierte, con su id.
  • Cada nombre de token en tokens.css. Usarás estos nombres y ninguno otro para color, tipografía, espaciado y radio.
  • Cada imagen que la dirección solicite, su relación de aspecto, y si el archivo existe.
  • La acción de conversión del brief: una URL externa (un enlace, sin formulario), o un formulario con sus campos y endpoint. Con el endpoint ninguno aún, el formulario publica en /api/lead y ese vacío va en la entrega (paso 11).
  • El Dominio (conocido o desconocido) y las Rutas de contacto, que necesitan el encabezado, el pie de página y /form-error/.

3. Escribir el encabezado

Título, descripción, canónico, Open Graph y tarjeta social, conjunto de favicon, theme-color, lang, datos estructurados. Las plantillas y reglas están en references/seo-meta.md. Escribe el título y la descripción desde copy.md; un título por defecto como el inicial del framework es una señal reveladora.

4. Cargar las fuentes

Autoaloja los archivos WOFF2 nombrados en la dirección, declara @font-face con nombres de familia que coincidan exactamente con los stacks de tokens.css, agrega un fallback con métricas coincidentes, y precarga solo los uno o dos archivos usados above the fold. references/performance.md tiene la receta y un script probado que calcula los valores de fallback. Una página que nombra una fuente y nunca la carga, o cae en system-ui, se renderiza de manera diferente en cada máquina.

5. Construir el esqueleto del diseño

Cada banda de la página es un <section class="section"> con un <div class="container"> dentro. Los dos nunca comparten un trabajo:

/* La sección controla el ritmo vertical, el contenedor controla el ancho y los márgenes internos. */
.section { padding-block: var(--space-section-open); }
.container {
  inline-size: min(100% - 2 * var(--space-gutter), var(--space-content-max));
  margin-inline: auto;
}

Los nombres de token anteriores son ejemplos; usa los nombres de tu tokens.css. references/css.md enumera cada rol de token que las recetas asumen y qué hacer cuando tu archivo no tiene token para uno. El contenedor no establece ningún padding, por lo que ningún orden de reglas o especificidad puede borrar el espaciado de la sección. Nunca escribas el shorthand padding o margin en una clase de sección o contenedor: un shorthand establece ambos ejes y reemplaza silenciosamente el que haya establecido la otra clase. Esta es la regla que elimina el error 1. references/css.md muestra la versión rota junto a esta, más los casos de ancho completo y línea fina.

6. Construir las secciones

  • Usa elementos semánticos: header, nav, main, section, footer, ol para pasos, dl o table para especificaciones, figure para medios con pie de foto.
  • Un h1, en el hero. Cada sección abre con un h2 tomado de copy.md. No saltes niveles.
  • Diseña cada sección como indica su fila en direction.md. Cuando la dirección deja la forma abierta, elige de las recetas en references/css.md; el número y la forma de los bloques siguen al contenido, así que tres tarjetas iguales aparecen solo cuando el contenido son tres cosas iguales.
  • Usa los tokens para cada color, fuente, tamaño, espacio y radio. Nunca redeclares un token en el CSS de la página. Si un valor que necesitas no tiene token, compónelo a partir de tokens (calc(), color-mix()) y enuméralo en la entrega para que la dirección pueda agregarlo.
  • Usa tamaños fluidos con clamp(), propiedades lógicas, color oklch() con los fallbacks en references/css.md, y consultas de contenedor para componentes que cambian de forma según su propio ancho.

7. Colocar los medios

Las imágenes reales reciben width y height, texto alt que dice lo que hay en ellas, formatos modernos con un fallback, y fetchpriority="high" solo en la imagen del hero (references/performance.md). Un activo que aún no existe se convierte en un cuadro placeholder visible, etiquetado, con la relación de aspecto final, y texto como [PLACEHOLDER: foto, el banco de trabajo desde arriba, 3:2]. No le des al cuadro role="img": anunciaría una fotografía que no existe. Dale a cada placeholder la relación, ancho y fondo que la dirección da a esa imagen, para que los marcos muestren el diseño planificado en lugar de una fila de cuadros discontinuos idénticos (references/css.md, Placeholders de medios). Nunca dibujes una pantalla de producto falsa y la presentes como el producto.

8. Construir la acción de conversión

La acción de Conversión del brief decide lo que construyes:

  • Una URL externa (página de pago, reserva, tienda de aplicaciones): la acción es un enlace, <a class="button" href="https://..."> con la etiqueta de copy.md. No hay formulario, ni form.js, ni páginas /thanks/ o /form-error/; salta el resto de este paso. Si el brief dice que el clic debe contabilizarse, landing-skills:landing-launch agrega el beacon.
  • Un formulario con un endpoint que el usuario ya tiene: el formulario publica en esa URL y no se usa el placeholder /api/lead. Construye las páginas de resultado solo si ese endpoint redirige a ellas; de lo contrario, indica en la entrega a dónde envía el endpoint al visitante.
  • Un formulario con el endpoint ninguno aún: el formulario publica en el placeholder /api/lead, que landing-skills:landing-launch construye como un Worker.

Para un formulario, lee references/forms-a11y.md. Las partes no negociables:

  • <form action="..." method="post"> con el endpoint del brief, o action="/api/lead" con un comentario HTML al lado que diga que el endpoint aún no existe, enumerado en la entrega.
  • Cada campo tiene un name, un <label> visible, el type y autocomplete correctos, y una pista vinculada con aria-describedby cuando el formato necesita explicación.
  • Sin JavaScript, el navegador envía el formulario y el endpoint responde con una redirección 303 a una de dos páginas estáticas que construyes ahora: /thanks/ y /form-error/. Una vez que landing-skills:landing-launch agregue Turnstile, un visitante sin JavaScript no tiene token y siempre llega a /form-error/, por lo que esa página debe ofrecer otra forma de contactar, tomada de las Rutas de contacto del brief.
  • Siempre incluye form.js de references/forms-a11y.md como mejora progresiva. El formulario funciona sin él; el archivo sigue siendo parte de la compilación, porque landing-skills:landing-motion extiende los estados que establece y landing-skills:landing-launch los verifica. Muestra éxito solo cuando la respuesta es un 2xx y su cuerpo JSON dice ok: true. Un 2xx por sí solo prueba solo que algo respondió: fetch sigue una redirección e informa la página en la que aterriza como 200, y un host estático puede responder a un POST con una página HTML ordinaria. Ambos ocurrieron en las pruebas, y ambos son fallos. En caso de fallo, el script lo dice y conserva lo que el visitante escribió. Nunca reinicies el formulario ni muestres "Gracias" antes de que el servidor haya confirmado.

9. Cumplir con el mínimo de accesibilidad

Enlace de salto, puntos de referencia, un nav cuyos enlaces apunten a ids de sección reales, el logotipo enlazando a /, un estilo de foco visible en cada elemento interactivo, objetivos de al menos 44x44 px, y una verificación de contraste de cada par de texto y fondo que la página realmente renderiza: texto del cuerpo en cada superficie, pies de foto, pistas, texto placeholder, texto sobre el acento. Los detalles y números están en references/forms-a11y.md. Una navegación que oculta sus enlaces en teléfonos sin reemplazo falla este mínimo; deja que los enlaces se envuelvan en su lugar.

10. Dejar fuera las animaciones

Bajo movimiento reducido es el movimiento lo que se reduce, nunca la retroalimentación, así que no escribas ninguna regla global que ponga a cero las transiciones. Construye cada elemento en su estado final y visible. Sin animaciones de entrada, sin opacity: 0 esperando un script, sin librerías de scroll.

Para cada momento nombrado en la Motion and 3D intent de la dirección, deja un sustituto: una imagen póster estática, o un placeholder etiquetado, en el tamaño final y relación de aspecto del momento, para que el diseño no se desplace cuando landing-skills:landing-motion monte lo real. Márcalo con data-moment="<nombre>", usando el nombre corto que la dirección da a ese momento; la animación encuentra su objetivo por ese atributo. El sustituto es completo sin animación: una imagen real con texto alt, o texto placeholder que diga lo que muestra el momento.

<div class="hero__media" data-moment="exploded-view">
  <img src="/img/exploded-poster.jpg" width="1600" height="1000" alt="Las capas del dispositivo separadas: carcasa, placa, batería, lente">
</div>

Cuando la intención es ninguna, no agregues elementos data-moment.

11. Verificar y entregar

Ejecuta "Definición de completado". Luego informa al usuario, en una lista corta:

  • qué se construyó y dónde (archivos, carpeta de salida), y el stack resuelto escrito en el campo Stack del brief si decía detectar,
  • cada [PLACEHOLDER: ...] que aún esté en la página y cada activo a proporcionar,
  • la acción de conversión construida: un enlace a una URL externa, un formulario que publica en el endpoint del usuario, o un formulario que publica en /api/lead, que aún no existe,
  • cada campo que el formulario envía, una línea cada uno: su name, su tipo (email, tel, text, textarea), si es required, y su maxlength del marcado. landing-skills:landing-launch configura la validación, límites de longitud, almacenamiento y límite de tamaño de solicitud de su Worker a partir de esta lista, y rechaza un campo del que no se le haya informado,
  • valores compuestos porque no existía ningún token, y cada token opcional que faltaba en tokens.css con el fallback que las recetas usaron para él,
  • el dominio de producción si el brief dice desconocido, y las etiquetas URL omitidas por ello (canónico, og:url, og:image, mapa del sitio),
  • rutas de contacto que el brief dejó desconocidas, que el pie de página y /form-error/ muestran como placeholders,
  • cada archivo de fuente que no fue subconjunto, con su tamaño en bytes,
  • cada verificación de Definición de completado que no se ejecutó, marcada como "no ejecutada" con la razón,
  • cada momento de Motion and 3D intent: su nombre data-moment y dónde está su sustituto (sección y elemento), o "ninguno" cuando la intención es ninguna,
  • el siguiente skill: landing-skills:landing-motion cuando la Motion and 3D intent de la dirección nombra un momento, luego landing-skills:landing-review, luego landing-skills:landing-launch para hosting y el endpoint del formulario.

Detección de stack

Revisa la raíz del proyecto en este orden y detente en la primera coincidencia. El campo Stack en brief.md decide cuándo la carpeta del proyecto está vacía.

Una vez que el stack está resuelto, escríbelo de nuevo: si el campo Stack del brief dice detectar, reemplaza esa única palabra con el stack resuelto (por ejemplo Astro, o HTML plano y CSS) y no cambies nada más en landing/brief.md. Los skills posteriores leen el campo y no deberían encontrarse con una palabra no resuelta. Un stack que el usuario nombró se mantiene tal como está escrito. Cuando no hay landing/brief.md, no lo crees.

Señal en el proyectoStackSección del adaptador
astro.config.mjs (o .ts, .js), o astro en dependencias de package.jsonAstroAstro
next.config.mjs (o .js, .ts), o next en dependencias de package.jsonNext.jsNext.js
vite.config.mjs (o .js, .ts) con @vitejs/plugin-reactVite + ReactVite + React
tailwind.config.mjs (o .js), o tailwindcss en package.jsonTailwind (con el stack detectado o HTML plano)Tailwind
Cualquier archivo .html, .css, .js en la raízHTML plano y CSSHTML plano
Carpeta vacía o sin archivos de proyectoPregunta o usa el stack del briefN/A

Referencias

Este skill referencia archivos en references/:

  • references/seo-meta.md — plantillas de encabezado, Open Graph, datos estructurados
  • references/css.md — recetas de diseño, placeholders de medios, tokens de CSS y sustitutos, versión rota de sección/contenedor
  • references/performance.md — carga incremental de fuentes, precarga, fetchpriority
  • references/forms-a11y.md — formularios accesibles, form.js, reglas de contraste, navegación
  • references/adapters.md — diferencias específicas de cada stack (Astro, Next.js, Vite+React, Tailwind)

Cuando una referencia se menciona en el proceso, léela antes de escribir cualquier archivo para ese paso.

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

Skills relacionados