Communitygithub.com

Seção Hero

Projete e construa a seção hero (primeira tela) de um site, incluindo layout do título, tratamento de mídia, CTA, selo de prova, marquee e animação de entrada. Use sempre que alguém pedir uma seção hero, um cabeçalho de landing page, 'o topo da minha homepage', uma introdução cinematográfica ou animada, um fundo de vídeo, um marquee de texto, ou disser que a primeira tela parece simples ou genérica.

O que é Seção Hero?

Esta skill define um conjunto de padrões e regras para projetar e implementar seções hero de sites — a primeira tela que determina se um visitante vai rolar ou sair. Ela oferece cinco padrões de layout (tipo-led, dividido, mídia em tela cheia, empilhado com card de mídia e mural de portfólio), cada um com uma estrutura central específica e indicações de uso. Além disso, inclui diretrizes de conteúdo (título, linha de apoio, CTA e elemento de prova), especificações de layout (tamanhos de fonte, alturas, cantos arredondados e scrims), animações de entrada (revelação linha por linha com GSAP, mídia que cresce ao rolar e marquee infinito) e boas práticas para fundos de vídeo (autoplay, poster, compressão). A skill é agnóstica de plataforma — pode ser usada com Claude Code, Cursor, Codex ou qualquer agente de desenvolvimento — e seu arquivo SKILL.md fornece o conhecimento necessário para que o agente produza hero sections otimizadas para conversão e performance.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Seção Hero faz?

A hero decide se um visitante vai rolar. Ela precisa dizer o que é isto, parecer intencional e carregar rápido. A maioria das heroes fracas falha no primeiro ou no terceiro ponto, não no segundo.

Decida o padrão primeiro

Escolha um. Misturá-los é como as heroes ficam poluídas.

PadrãoUse quandoEstrutura principal
Tipo-ledPosicionamento forte, sem ótimas imagensTítulo grande de várias linhas, linha de apoio pequena, CTA
DivididoUm produto, pessoa ou captura de tela para mostrarTexto à esquerda, mídia à direita, 55/45
Mídia em tela cheiaMarca cinematográfica, vídeo ou foto forteMídia preenche a tela, texto sobreposto com um scrim
Empilhado com card de mídiaEstilo agência ou estúdioTítulo no topo, bloco de mídia arredondado abaixo que cresce ao rolar
Mural de portfólioDesigners, fotógrafosPequena linha de introdução sobre uma grade ou carrossel de trabalhos

Regras de conteúdo

  • Título: o que você faz e para quem, em 6 a 12 palavras. Para heroes tipo-led, divida em 2 ou 3 linhas curtas de comprimento semelhante para que o bloco seja lido como uma forma.
  • Linha de apoio: uma frase, no máximo 20 palavras. Ela adiciona o detalhe que o título deixou de fora.
  • CTA: um verbo mais resultado ("Planeje seu projeto"), um botão primário. Um link de texto secundário é aceitável.
  • Elemento de prova: um pequeno selo próximo ao CTA ou sobrepondo a mídia: uma avaliação, uma contagem ou logotipos de clientes. Use apenas números reais.
  • Não coloque um parágrafo, um formulário com mais de dois campos ou um slider na hero.

Especificações de layout

  • Tamanho do título: clamp(2.5rem, 7vw, 6.5rem), line-height 0.95 a 1.05, letter-spacing -0.02em a -0.04em para tipos grandes de exibição.
  • Altura da hero: min-height: 100svh apenas para mídia em tela cheia; caso contrário, deixe o conteúdo definir a altura para que a próxima seção apareça.
  • Cantos da mídia: raio de 16 a 32px para o padrão empilhado. Mantenha um raio em todo o site.
  • Texto sobre mídia precisa de um scrim: um gradiente de 60% preto para transparente, ou a relação de contraste 4.5:1 falhará.

Movimento que ajuda

Ordem de entrada: linhas do título, depois linha de apoio e CTA, depois mídia, depois decorações. Total abaixo de 1,6 segundos, porque o visitante está esperando.

// Revelação do título linha por linha. Envolva cada linha: <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
});

Mídia que cresce ao rolar:

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 }
});

Marquee infinito (duplique o conteúdo da faixa uma vez para que o loop seja contínuo):

.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; } }

Fundos de vídeo

  • autoplay muted loop playsinline mais uma imagem de poster; sem muted e playsinline, navegadores móveis não reproduzirão automaticamente.
  • Mantenha abaixo de 3 MB: 8 a 12 segundos, 1280px de largura, sem faixa de áudio, H.264 MP4 com uma alternativa WebM.
  • Nunca faça do vídeo o bloqueador de LCP: o poster deve ser uma imagem pré-carregada.
  • Em telas pequenas ou prefers-reduced-motion, mostre apenas o poster.

Verificações

  • Cubra o título: um estranho ainda consegue dizer o que o negócio faz pelo resto? Se sim, o título é muito vago.
  • Primeira tela com 390px de largura mostra título, CTA e parte da mídia sem rolagem.
  • Maior Pintura de Conteúdo (LCP) abaixo de 2,5s em uma conexão limitada.
  • Com animações desabilitadas, nada fica invisível ou deslocado.

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.

Habilidades Relacionadas