Communitygithub.com

hero-section

Diseña y construye el hero (primera pantalla) de un sitio web, incluyendo el diseño del titular, tratamiento de medios, CTA, insignia de prueba, marquesina y animación de entrada. Úsalo siempre que alguien solicite una sección hero, un encabezado de página de aterrizaje, 'la parte superior de mi página de inicio', una intro cinematográfica o animada, un fondo de video, una marquesina de texto, o diga que su primera pantalla se ve simple o genérica.

¿Qué es hero-section?

Este skill está diseñado para construir la sección hero de un sitio web, la primera pantalla que decide si un visitante se queda o se va. Proporciona reglas claras para elegir el patrón adecuado entre cinco opciones (dirigido por tipo, dividido, medios a sangre, apilado con tarjeta de medios, muro de portafolio) según el tipo de proyecto. Incluye pautas estrictas de contenido: titular de 6 a 12 palabras, línea de apoyo máxima de 20 palabras, CTA con verbo y resultado, y un elemento de prueba pequeño con números reales. También cubre especificaciones de diseño como tamaños de titular con clamp(), alturas de hero, radios de esquina, y gradientes para texto sobre medios. El skill soporta animaciones avanzadas: revelación línea por línea del titular con GSAP, crecimiento de medios al hacer scroll, marquesinas infinitas con CSS, y fondos de video con buenas prácticas de rendimiento (poster, muted, playsinline, tamaño bajo 3 MB). Incluye verificaciones finales para asegurar que el titular sea claro, la primera pantalla funcione en 390px de ancho, el LCP esté bajo 2.5s, y la sección sea accesible con animaciones desactivadas. Es ideal para agentes de IA como Claude Code, Cursor o Codex al generar landing pages, páginas de inicio o sitios de portafolio.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/imperfec-t/webcraft/tree/main/skills/hero-section

Preguntar en tu IA favorita

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

Documentación

Sección Hero

El hero decide si un visitante hace scroll. Debe comunicar qué es esto, verse intencionado y cargar rápido. La mayoría de los héroes débiles fallan en el primer o tercer punto, no en el segundo.

Decide primero el patrón

Elige uno. Mezclarlos es cómo los héroes se vuelven recargados.

PatrónCuándo usarloEstructura principal
Dirigido por tipoPosicionamiento fuerte, sin imágenes atractivasTitular grande en múltiples líneas, línea de apoyo pequeña, CTA
DivididoUn producto, persona o captura de pantalla que mostrarTexto a la izquierda, medios a la derecha, 55/45
Medios a sangreMarca cinematográfica, video o foto impactanteLos medios llenan la pantalla, texto superpuesto con un degradado
Apilado con tarjeta de mediosSensación de agencia o estudioTitular arriba, bloque de medios redondeado debajo que crece al hacer scroll
Muro de portafolioDiseñadores, fotógrafosLínea introductoria pequeña sobre una cuadrícula o carrusel de trabajos

Reglas de contenido

  • Titular: qué haces y para quién, en 6 a 12 palabras. Para héroes dirigidos por tipo, divídelo en 2 o 3 líneas cortas de longitud similar para que el bloque se lea como una forma.
  • Línea de apoyo: una oración, máximo 20 palabras. Añade el detalle que el titular omitió.
  • CTA: un verbo más resultado ('Planifica tu proyecto'), un botón primario. Un enlace de texto secundario está bien.
  • Elemento de prueba: una insignia pequeña cerca del CTA o superpuesta a los medios: una calificación, un conteo o logotipos de clientes. Usa solo números reales.
  • No pongas un párrafo, un formulario con más de dos campos ni un control deslizante en el hero.

Detalles de diseño

  • Tamaño del titular: clamp(2.5rem, 7vw, 6.5rem), altura de línea 0.95 a 1.05, interletraje -0.02em a -0.04em para tipografía grande de pantalla.
  • Altura del hero: min-height: 100svh solo para medios a sangre; de lo contrario, deja que el contenido defina la altura para que la siguiente sección se asome.
  • Esquinas de los medios: radio de 16 a 32px para el patrón apilado. Mantén un solo radio en todo el sitio.
  • El texto sobre medios necesita un degradado: un gradiente de negro al 60% a transparente, o la relación de contraste 4.5:1 fallará.

Movimiento que ayuda

Orden de entrada: líneas del titular, luego línea de apoyo y CTA, luego medios, luego decoraciones. Total menos de 1.6 segundos, porque el visitante está esperando.

// Revelación línea por línea del titular. Envuelve cada línea: <span class="line"><span>Texto</span></span>
// .line { display:block; overflow:hidden }  .line > span { display:block }
gsap.from(".hero .line > span", {
  yPercent: 110, duration: 0.9, ease: "power3.out", stagger: 0.08
});
gsap.from(".hero [data-fade]", {
  y: 24, opacity: 0, duration: 0.7, ease: "power2.out", stagger: 0.08, delay: 0.35
});

Medios que crecen al hacer scroll:

gsap.fromTo(".hero-media", { scale: 0.86, borderRadius: 32 }, {
  scale: 1, borderRadius: 0, ease: "none",
  scrollTrigger: { trigger: ".hero-media", start: "top 85%", end: "top 15%", scrub: true }
});

Marquesina infinita (duplica el contenido del track una vez para que el bucle sea sin costuras):

.marquee { overflow: hidden; }
.marquee__track { display: flex; gap: 3rem; width: max-content; animation: marquee 28s linear infinite; }
@keyframes marquee { to { transform: translateX(-50%); } }
@media (prefers-reduced-motion: reduce) { .marquee__track { animation: none; } }

Fondos de video

  • autoplay muted loop playsinline más una imagen poster; sin muted y playsinline los navegadores móviles no reproducirán automáticamente.
  • Mantenlo bajo 3 MB: 8 a 12 segundos, 1280px de ancho, sin pista de audio, H.264 MP4 con una alternativa WebM.
  • Nunca conviertas el video en el bloqueador de LCP: el poster debe ser una imagen precargada.
  • En pantallas pequeñas o prefers-reduced-motion, muestra solo el poster.

Verificaciones

  • Cubre el titular: ¿un extraño aún puede saber qué hace el negocio a partir del resto? Si es así, el titular es demasiado vago.
  • Primera pantalla a 390px de ancho muestra el titular, CTA y parte de los medios sin hacer scroll.
  • Largest Contentful Paint menor a 2.5s en una conexión limitada.
  • Con animaciones desactivadas, nada es invisible o está mal colocado.

Individual skills in this repo

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

homepage-blueprint

Plan the section structure and content slots of a homepage for an agency, freelancer, studio or service business before any design or code. Use this whenever someone asks "what sections should my homepage have", "plan my website", "structure a landing page for my business", wants a wireframe or sitemap for a service site, or starts building a homepage without a clear outline.

responsive-layout

Build page layouts that work from phones to wide desktops using CSS grid, flexbox, container queries and fluid sizing, including card grids, bento grids, split sections, sticky sidebars and navigation that collapses. Use this whenever someone says their site "breaks on mobile", asks for a responsive grid, a bento layout, a mobile menu, fixing horizontal scroll or overflow, or is laying out any multi-column section.

scroll-motion

Add scroll-driven and entrance animation to a website with GSAP, ScrollTrigger and Lenis, including reveals, parallax, pinned sections, horizontal scroll, line drawing, counters and preloaders. Use this whenever someone wants a site to "feel premium", asks for smooth scrolling, scroll animations, parallax, text reveals, a pinned or sticky scroll section, an animated preloader, or names GSAP, ScrollTrigger, Lenis, Locomotive or AOS.

website-workflow

Plan and sequence a whole website build, from structure through design, code, WordPress and launch, by routing each stage to the right webcraft skill. Use this when someone asks to "build me a website", "design my site from scratch", "redo our homepage", wants an end-to-end plan for a marketing, agency, studio or service site, or the request spans more than one of structure, look, layout, motion, CMS and QA.

Skills relacionados