Communitygithub.com

스크롤 비디오 웹사이트

네이티브 스크롤이 승인된 비디오를 탐색하고 객체 전환을 페이지 콘텐츠로 조정하는 웹사이트를 구축하거나 개선합니다. 일반적인 자동 재생 비디오 삽입 대신 스크롤 기반 시네마틱 진입 및 사진적 객체 움직임에 사용됩니다.

스크롤 비디오 웹사이트란 무엇인가요?

이 스킬은 웹사이트에서 네이티브 스크롤을 사용하여 비디오 클립을 제어하고 객체 전환을 조정하는 반응형, 양방향 상호작용을 구축하는 방법을 정의합니다. 특정 애니메이션 라이브러리에 의존하지 않으며, 제품 회전, 인테리어 공개, 아트워크 등 다양한 시각적 스토리에 적용 가능합니다. 주요 기능으로는 스크롤을 타임라인에 매핑하여 비디오 탐색(scrubbing), 객체의 연속적인 움직임 유지, 하이브리드 진입(시간 제어 + 스크롤 제어) 지원, 축소된 동작(reduced motion) 경로 제공 등이 있습니다. Cursor, Claude Code, Codex와 같은 AI 에이전트 플랫폼에서 사용할 수 있으며, 기존 사이트의 스택과 승인된 자산을 재사용하는 것을 권장합니다. 또한 웹 접근성을 유지하고, 네비게이션, 건너뛰기, 다시보기 기능을 보장하며, 미디어 로딩 실패 시에도 정적 콘텐츠로 대체할 수 있는 안정적인 경로를 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/itsmanuelarx/creative-web-animation-skills/tree/HEAD/skills/scroll-video-website

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

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

문서

스크롤 비디오 웹사이트은(는) 무엇을 하나요?

승인된 시각적 시퀀스를 반응형, 양방향 웹사이트 상호작용으로 변환합니다. 기존 사이트의 스택과 승인된 자산을 재사용하며, 특정 애니메이션 라이브러리가 필요하지 않습니다. 주제, 경로 및 목적지는 프로젝트 입력값입니다. 제품 회전, 인테리어 공개, 아트워크 또는 기타 시각적 스토리에 이 워크플로우를 적용하세요. 떨어지는 레코드와 턴테이블은 예시일 뿐, 필수 장면이 아닙니다.

상호작용 설정

편집 전에 현재 구현, 승인된 버전 및 최신 사용자 피드백을 검사하세요. 해당 컨텍스트에서 다음을 확인하세요.

  • 비디오에서 어떤 움직임이 있으며, 어떤 객체가 코드에서 별도로 애니메이션 처리되나요?
  • 스크롤이 전체 클립을 제어하나요, 아니면 의도적인 시간 제어 세그먼트가 스크롤보다 먼저 실행되나요? 선택된 동작을 따르세요. 처음부터 스크롤 요청은 클릭 게이트 없이 첫 번째 휠 또는 터치 스크롤에서 작동해야 합니다.
  • 최종 장면이 일반 페이지 콘텐츠가 되는 지점은 어디인가요? 방문자가 메인 콘텐츠에 직접 도달할 수 있는 방법은 무엇인가요?
  • 어떤 크기와 플랫폼이 중요하며, 어떤 미리보기를 사용할 수 있어야 하나요?

타이밍이나 제어 변경만 요청된 경우 미디어를 다시 생성하지 마세요. 현재 작업 버전을 저장하고, 비교가 요청될 때 격리된 대안을 만드세요.

미디어 준비

정확한 비디오와 해당 디코딩된 시작/종료 스틸 이미지를 사용하세요. 색상 해석, 종횡비 및 소스 파일을 보존하세요. 이음매 자체가 잘못된 경우 상호작용 효과로 숨기기 전에 미디어 핸드오버를 수정하세요.

지속 시간, 프레임 속도, 해상도 및 탐색 동작을 검사하세요. 키프레임 간격이 짧을수록 스크러빙에 도움이 될 수 있습니다. 모든 키프레임 복사본은 로컬 프로토타입에 유용할 수 있지만 배포에는 너무 커질 수 있습니다. 실제 브라우저에서 파생물을 벤치마킹하고 전달을 별도로 최적화하세요. 모든 클립에 대해 하나의 인코딩 설정을 규정하지 마세요.

메타데이터와 프레임이 로딩되는 동안 포스터를 유지하세요. 최신 요청 시간을 저장하고 비디오가 준비될 때 적용하세요. 비디오가 누락되거나 거부된 경우 콘텐츠로 가는 사용 가능한 정적 경로를 남겨두세요.

스크롤을 타임라인에 매핑

  1. 기존 레이아웃에 맞는 경우 네이티브 스크롤 트랙과 스티키 비주얼 스테이지를 사용하세요. 스크롤이 진입 제어인 경우 문서를 즉시 스크롤 가능하게 유지하세요. 스크롤바를 시뮬레이션하기 위한 휠 가로채기 및 터치 캡처를 피하세요.
  2. 선택한 스토리를 의도적인 범위(예: 객체 움직임, 카메라 공개, 정착된 장면, 객체 전환 및 콘텐츠)로 나누세요. 프로젝트에 도움이 되는 단계만 사용하세요. 제품 회전에 추락이나 방 공개가 포함될 필요는 없습니다. 간단하지만 중요한 이벤트에 충분한 거리를 할당하세요. 각 범위를 미디어 또는 변환 진행 상황에 매핑하세요. 클립의 초가 스크롤 픽셀에 균일하게 매핑될 필요는 없습니다.
  3. 스크롤 이벤트에 의해 예약된 단일 requestAnimationFrame에서 업데이트하세요. 측정 시 레이아웃을 읽고, 모든 애니메이션 업데이트 내에서 반복적으로 읽지 마세요.
  4. 스크러빙을 위해 비디오를 일시 정지 상태로 유지하세요. 탐색을 통합하세요: 최신 대상을 저장하고, 보류 중인 탐색이 있는 동안 경쟁 탐색을 시작하지 말고, seeked 후에 최신 대상을 적용하세요. 오래된 프레임의 백로그를 구축하지 마세요.
  5. 끝점을 고정하고, 분수 뷰포트 계산을 위한 작은 픽셀 허용 오차를 추가하세요. 실제 브라우저 스크롤 위치를 사용하여 첫 번째 및 마지막 프레임을 테스트하세요.
  6. 중지된 스크롤이 현재 상태를 유지하도록 하세요. 선택된 상호작용에 따라 각 단계를 역방향으로 진행하세요. 전체 클립이 스크롤 제어되는 경우 시작 동작도 포함합니다.
  7. 방문자가 휠, 터치 또는 탐색 키 입력을 제공할 때 프로그래밍 방식의 이동을 취소하세요. 창 크기 조정 및 복원된 스크롤 위치가 시작 상태를 예기치 않게 건너뛰지 않도록 방지하세요.

하이브리드 진입의 경우, 어떤 세그먼트가 시간 제어되고 역방향 스크롤이 어디에서 멈추는지 명시적으로 정의하세요. 완전히 스크롤 제어되는 경험에 시간 제어 세그먼트를 조용히 도입하지 마세요.

사진적 객체 연속성 유지

가능한 경우 선택된 움직임과 핸드오버를 통해 하나의 가시적인 객체를 사용하세요(예: 제품이 상세 보기로 이동하거나 아트워크가 갤러리로 전환되는 경우). 목적지에 다시 연결하는 경우, 변경 전후의 위치와 투영을 일치시키세요.

완전한 뒤집기(end-over-end flip)에는 가장자리를 드러내는 3D 회전이 필요합니다. 평면 내 회전은 다른 움직임입니다. 질감 있는 평면은 인쇄물이나 레코드와 같은 평평한 객체에 적합합니다. 완전히 모델링된 3D 장면으로 설명하지 마세요. 회전 중에 실루엣이 변경되는 단단한 제품은 적합한 촬영/생성된 뷰 또는 3D 에셋이 필요합니다.

소스 및 목적지 측정값을 일관된 좌표계로 유지하세요. 스테이지가 스티키인 경우 뷰포트 좌표와 문서 좌표를 혼합하지 마세요. 크기 조정 시 다시 측정하고 의미 있는 진행 상황을 보존하세요. 종속적인 작업을 물리적 원인에 따라 순서화하세요. 예를 들어 목적지가 턴테이블인 경우 레코드가 착지할 때까지 바늘을 올린 상태로 유지하고, 그런 다음 재생 상태가 시작되기 전에 내리세요.

일치하는 조명과 장면 기하학을 사용하여 장면 경계를 블렌드하세요. 헤딩과 콘텐츠 링크를 시각적으로 혼잡한 이미지 위에 배치하는 대신 읽을 수 있게 유지하세요. 좁은 뷰포트에서는 객체 옆에 충분한 공간이 없을 때 콘텐츠가 객체 아래에 위치하도록 하세요.

웹사이트 접근성 유지

긴 영화가 끝난 후에만이 아니라 스토리의 선택된 지점에서 네비게이션을 표시하세요. 직접 카테고리 접근, 건너뛰기, 다시보기 및 장면으로 돌아가는 경로를 유지하세요. 카테고리 변경이 객체를 교체하기 위한 것이라면, 선택된 콘텐츠 및 종속적인 움직임과 조정하세요. 빠른 선택은 최신 요청에 안착해야 합니다.

대상이나 그 조상이 비활성 상태인 동안 대상에 포커스를 설정하지 마세요. 먼저 상호작용 가능하게 만든 다음 추가 스크롤 점프 없이 포커스를 설정하세요. 프로젝트 대화상자가 닫힌 후 포커스를 복원하세요.

축소된 동작 경로는 스크러빙이나 뒤집기 없이 사용 가능한 정적 장면을 표시해야 합니다(뒤로 스크롤할 때도 포함). 실패한 미디어 상태를 지속적으로 유지하여 역방향 스크롤이 깨진 오버레이를 복원할 수 없도록 하세요.

검증 및 인계

지원되는 브라우저 도구를 사용하여 실제 입력을 테스트하세요. 내부 애니메이션 함수 호출만 테스트하지 마세요.

  • 새로운 로드에서 클릭 없이 스크롤하세요. 중간에 멈추고 계속한 다음 시작 부분으로 역방향 스크롤하세요.
  • 비디오/스틸 핸드오버 및 객체-목적지 결합을 시각적으로 검사하세요.
  • 객체 전환이 디자인의 일부인 경우 애니메이션된 객체가 올바른 위치에 있는 메인 콘텐츠에 도달하세요. 카테고리 변경, 건너뛰기, 다시보기 및 키보드 포커스를 테스트하세요.
  • 데스크탑 및 모바일 레이아웃, 중간 경로에서의 크기 조정, 축소된 동작 및 의도적으로 비디오를 사용할 수 없는 경우를 확인하세요.
  • 가로 오버플로, 미디어 로딩 및 콘솔 오류를 확인하세요. 브라우저 에뮬레이션과 실제 전화 테스트를 구분하세요.

리뷰 URL, 유용한 스크린샷, 보존된 기준선 및 중요한 성능 또는 장치 테스트 제한 사항을 전달하세요. 소스 미디어 및 타이밍을 식별하는 간결한 매니페스트를 유지하세요. 로컬 리뷰를 구현하는 것만으로 게시가 승인되지는 않습니다.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬