Communitygithub.com

히어로 섹션

웹사이트의 히어로(첫 화면)를 디자인하고 구축합니다. 헤드라인 레이아웃, 미디어 처리, CTA, 신뢰 표시, 마키, 진입 애니메이션을 포함합니다. 누군가 히어로 섹션, 랜딩 페이지 헤더, '내 홈페이지 상단', 시네마틱 또는 애니메이션 인트로, 비디오 배경, 텍스트 마키를 요청하거나 첫 화면이 평범하거나 진부하다고 말할 때 사용하세요.

히어로 섹션란 무엇인가요?

이 스킬은 방문자의 이탈을 결정짓는 웹사이트 첫 화면(히어로 섹션)을 체계적으로 설계하고 구현하는 방법을 제공합니다. 목적과 콘텐츠에 따라 타입 중심, 분할, 풀 블리드 미디어, 스택형 미디어 카드, 포트폴리오 월 등 5가지 패턴 중 하나를 먼저 선택하도록 안내하며, 각 패턴에 적합한 구조를 제시합니다. 헤드라인은 6~12단어로 강력한 포지셔닝을 전달하고, CTA는 동사+결과 형태로 최소화하며, 신뢰 표시 요소를 함께 배치합니다. 클램프 함수를 사용한 반응형 타이포그래피, 애니메이션(줄 단위 헤드라인 리빌, 스크롤 연동 미디어 확대, 무한 마키), 동영상 배경 최적화(3MB 이하, 포스터 필수, 모바일 대응) 등 구체적인 기술 지침을 포함합니다. 또한 LCP 2.5초 이내, 390px 화면에서 콘텐츠 가시성, 접근성 고려 등 성능 및 품질 체크리스트를 제공하여 약한 히어로의 흔한 실패 원인(메시지 부재, 느린 로딩)을 방지합니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

히어로 섹션은(는) 무엇을 하나요?

히어로는 방문자가 스크롤을 할지 말지를 결정합니다. 이 섹션은 무엇을 제공하는지 명확히 전달하고, 의도적으로 보여야 하며, 빠르게 로드되어야 합니다. 대부분의 약한 히어로는 두 번째나 세 번째 요소가 아니라 첫 번째나 세 번째 요소에서 실패합니다.

먼저 패턴을 결정하세요

하나를 선택하세요. 여러 패턴을 섞으면 히어로가 복잡해집니다.

패턴사용 시기핵심 구조
타입 중심강력한 포지셔닝, 훌륭한 이미지 없음크고 여러 줄 헤드라인, 작은 보조 문장, CTA
분할제품, 사람 또는 스크린샷을 보여줄 때텍스트 왼쪽, 미디어 오른쪽, 55/45 비율
풀 블리드 미디어시네마틱 브랜드, 강력한 비디오 또는 사진미디어가 화면을 채우고, 텍스트는 스크림과 함께 오버레이
미디어 카드 스택에이전시 또는 스튜디오 느낌상단 헤드라인, 아래 둥근 미디어 블록이 스크롤에 따라 커짐
포트폴리오 월디자이너, 사진작가작은 소개 줄 위에 작업물 그리드 또는 캐러셀

콘텐츠 규칙

  • 헤드라인: 당신이 누구를 위해 무엇을 하는지, 612단어로. 타입 중심 히어로의 경우 비슷한 길이의 23줄로 나누어 블록이 하나의 형태로 읽히도록 하세요.
  • 보조 문장: 한 문장, 최대 20단어. 헤드라인이 생략한 세부 정보를 추가합니다.
  • CTA: 동사 + 결과("프로젝트 계획하기"), 기본 버튼 하나. 보조 텍스트 링크는 괜찮습니다.
  • 신뢰 표시 요소: CTA 근처나 미디어에 겹친 하나의 작은 배지: 평점, 개수 또는 고객 로고. 실제 숫자만 사용하세요.
  • 히어로에 문단, 두 개 이상의 필드가 있는 양식 또는 슬라이더를 넣지 마세요.

레이아웃 세부 사항

  • 헤드라인 크기: clamp(2.5rem, 7vw, 6.5rem), 줄 높이 0.951.05, 자간 -0.02em-0.04em(큰 디스플레이 타입).
  • 히어로 높이: 풀 블리드 미디어의 경우에만 min-height: 100svh, 그렇지 않으면 콘텐츠가 높이를 정의하여 다음 섹션이 살짝 보이도록 합니다.
  • 미디어 모서리: 스택 패턴의 경우 16~32px 반경. 사이트 전체에서 하나의 반경을 유지하세요.
  • 미디어 위 텍스트에는 스크림이 필요합니다: 60% 검정에서 투명으로 그라데이션, 그렇지 않으면 4.5:1 대비를 실패합니다.

도움이 되는 모션

진입 순서: 헤드라인 줄, 그다음 보조 문장과 CTA, 그다음 미디어, 그다음 장식. 방문자가 기다리고 있으므로 총 1.6초 미만.

// 줄 단위 헤드라인 리빌. 각 줄을 감싸기: <span class="line"><span>텍스트</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
});

스크롤에 따라 커지는 미디어:

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

동영상 배경

  • autoplay muted loop playsinline 및 poster 이미지 포함; muted와 playsinline이 없으면 모바일 브라우저에서 자동 재생되지 않습니다.
  • 3MB 미만 유지: 8~12초, 1280px 너비, 오디오 트랙 없음, WebM 대안과 함께 H.264 MP4.
  • 동영상을 LCP 차단 요소로 만들지 마세요: 포스터는 사전 로드된 이미지여야 합니다.
  • 작은 화면 또는 prefers-reduced-motion에서는 포스터만 표시하세요.

체크리스트

  • 헤드라인 확인: 낯선 사람이 나머지 콘텐츠만 보고도 비즈니스가 무엇을 하는지 알 수 있습니까? 그렇다면 헤드라인이 너무 모호합니다.
  • 390px 너비의 첫 화면에서 스크롤 없이 헤드라인, CTA 및 미디어 일부가 표시됩니다.
  • 제한된 연결에서 LCP 2.5초 미만.
  • 애니메이션이 비활성화된 상태에서 아무것도 보이지 않거나 잘못 배치되지 않습니다.

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.

관련 스킬