Communitygithub.com

스크롤 내러티브

웹사이트, 랜딩 페이지, 제품 페이지, 포트폴리오 또는 케이스 스터디가 단순한 블록 나열 대신 스토리를 전달해야 할 때 사용합니다. 스크롤텔링, 스토리텔링 페이지, '내러티브' 또는 '시네마틱' 사이트, 챕터 기반 페이지, 타임라인, 여정, 전후 비교, 또는 지루한 섹션 카탈로그처럼 느껴지는 페이지에 적합합니다.

스크롤 내러티브란 무엇인가요?

이 스킬은 웹사이트를 단순한 정보 블록 나열이 아닌, 사용자가 스크롤을 통해 능동적으로 체험하는 하나의 스토리로 전환합니다. 방문자가 스크롤 휠을 돌리면서 이야기를 직접 걸어가는 듯한 경험을 제공하며, 사실과 데이터는 플롯 속에 자연스럽게 녹아듭니다. 스킬은 스토리텔링에 적합한 브랜드, 중소기업, 여행, 서비스 등의 풀 내러티브(full narrative)부터 SaaS 제품의 '작동 방식'을 보여주는 단일 장면(single story scene)까지 다양한 규모로 적용 가능합니다. 또한 구체적인 비트 시트(beat sheet) 작성법과 타임 축, 경로, 줌, 변환, 카운트다운, 캐릭터 같은 내러티브 장치를 제공하며, 핀 고정(pinned) 장면, 스텝 캡션, 장 레이블 및 진행 게이지 등이 포함된 `storymotion.css`와 `storymotion.js`라는 전용 기술 스택 위에 구축됩니다. 비트 하나당 하나의 아이디어와 시각 자료, 모션만 사용하고, JS가 비활성화된 환경에서도 스토리가 순서대로 읽히도록 보장하며, 모바일에서는 짧은 핀과 큰 타입으로 최적화합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YehorSS/storymotion/tree/main/skills/scroll-narrative

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

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

문서

스크롤 내러티브은(는) 무엇을 하나요?

모든 사이트에 스토리가 필요한 것은 아닙니다. 먼저 결정하세요: 전체 내러티브(브랜드, 중소기업, 여행, 장소, 공예, 가시적 결과가 있는 서비스), 단일 스토리 장면(SaaS, 앱: 보통 "작동 방식"), 또는 없음(쇼핑몰, 문서, 대시보드, 양식: 피드백을 위한 모션만 사용, web-motion만 사용). 부분 적용의 경우 이 스킬을 해당 장면 하나에만 적용하세요.

내러티브 사이트는 방문자가 스크롤 휠로 걸어가는 스토리입니다. 사실은 플롯에 엮여 있지, 기능 블록으로 쌓여 있지 않습니다. 모션(web-motion 스킬 참조)은 그 스토리에서 시간이 흐르는 방식입니다.

1. 코드보다 먼저 스토리를 찾으세요

각각 한 줄로 답하세요:

  • 영웅 — 우리가 따라가는 대상 (방문자, 제품, 장소, 요리, 하루).
  • 욕망 — 그들이 원하는 것 또는 가는 곳.
  • 장애물 — 가로막는 것 (제품이 해결하는 문제).
  • 전환점 — 상황이 바뀌는 순간 (제품, 정상, 첫 입).
  • 후 — 전환점 이후의 세상, 그리고 방문자가 지금 취하는 한 가지 행동.

그런 다음 전체 스크롤을 구조화하는 내러티브 장치 하나를 고르세요:

장치스크롤의 의미좋은 예
시간 축새벽 → 밤, 1920 → 오늘, 1일차 → 30일차레스토랑, 이벤트, 역사, 일상
경로경로나 지도를 따라 이동여행, 물류, 탐험, 부동산
줌도시 → 거리 → 방 → 디테일건축, 제품, 공예
변환날것 → 완성, 전 → 후서비스, 리노베이션, SaaS, 피트니스
카운트다운출시나 최고의 순간을 향해페스티벌, 드롭스, 런칭
캐릭터한 사람의 하루를 따라감앱, B2C 서비스

2. 비트 시트를 작성하세요

빌드하기 전에 beats.md로 저장하세요. 비트당 한 행:

#비트헤드라인 (≤ 8 단어)본문 (≤ 40 단어)녹아든 사실시각 자료모션스크롤 길이

표준 아크 (6–9 비트):

  1. 후크 — 첫 번째 화면. 3초 안에: 이것이 무엇인지, 핵심 숫자, 주요 행동. 다른 내용 없이 "아래로 스크롤하여 발견하세요"는 안 됩니다.
  2. 설정 — 이전 세계; 영웅과 욕망.
  3. 여정 (2–4 비트) — 장치를 통한 진행; 각 비트는 하나의 사실을 플롯 포인트로 전달합니다 ("오전 6시에는 빵이 이미 나와 있습니다 — 140개").
  4. 전환점 — 가장 큰 장면: 보통 스크롤로 문질러지는 핀 고정 스테이지 (200–300 vh).
  5. 증거 — 숫자, 얼굴, 리뷰, 스토리의 결과로 전달됩니다.
  6. 해결 + CTA — 스토리가 도달하는 지점, 그리고 하나의 명확한 행동. 후크의 행동을 반복하세요.

3. 페이싱 규칙

  • 비트당 하나의 아이디어, 하나의 시각 자료, 하나의 모션.
  • 밀도 높음과 듬성함을 번갈아 가세요: 핀 고정 장면 다음에는 차분한 전체 화면 사진이나 한 문장.
  • 페이지당 최대 ~3개의 핀 고정 장면; 각 핀은 스크롤 길이를 정당화해야 합니다.
  • 전체 페이지: 데스크톱에서 6–12 뷰포트 높이. 각 화면에 여전히 새로운 소식이 있는 경우에만 더 길게.
  • 텍스트는 그것이 설명하는 순간과 함께 나타나며, 절대 앞서서 나타나지 않습니다.
  • 방문자는 항상 자신이 어디에 있는지 압니다: 장 레이블 + 진행 게이지.
  • 스크롤 자체가 스토리를 말합니다: 게이지는 내러티브 장치를 은유로 사용하며(시간, km, 척도, 연도, 장 번호) 사이트의 팔레트와 타입을 따릅니다; 장이 표시되고 호버 시 이름이 나타납니다.

4. 콘텐츠와 장인정신

  • 사진은 주인공입니다: 고해상도만, 100% 크롭에서 선명하게; 반응형 srcset.
  • 사람처럼 쓰세요, 평범한 단어로; "해방하다", "격상시키다", "원활한" 같은 말은 사용하지 마세요.
  • 숫자는 통계 그리드가 아닌 플롯 포인트입니다 — 그리드가 클라이맥스가 아니라면.
  • 모든 비트는 모션 감소 및 JS 없음 환경에서도 살아남아야 합니다: 여전히 좋은 긴 페이지로 읽혀야 합니다.
  • 모바일은 축소된 데스크톱이 아닙니다: 더 짧은 핀 (150–200 vh), 쌓인 스테이지, 더 큰 타입.

5. 빌드

  1. storymotion.css + storymotion.js 위에 빌드하세요 (web-motion/assets/에 있음; --p로 핀 고정 장면, 스텝 캡션, 리빌, 카운트업, 장 레이블, 드래그 가능한 스크롤 게이지, 로더, 언어, 모션 감소 지원) 및 web-motion/references/recipes.md의 레시피.
  2. 각 비트를 섹션에 매핑하세요; 핀 고정 비트는 [data-step] 캡션이 있는 .scene > .stage가 됩니다; 사용자 정의 프레임별 로직은 장면의 progress 이벤트를 수신합니다.
  3. web-motion에 따라 모션을 추가하세요; 375px 및 1440px에서 모션 감소 켜짐/꺼짐 상태로 확인하세요.

완료 전 체크리스트:

  • 후크가 3초 테스트를 통과합니다.
  • 각 비트는 정확히 하나의 역할과 하나의 사실을 가집니다.
  • JS가 비활성화된 상태에서도 스토리가 순서대로 읽힙니다.
  • 장 레이블과 게이지가 비트 시트와 일치합니다.
  • 마지막 CTA가 후크의 행동을 반복합니다.

관련 스킬