Communitygithub.com

인터랙티브 스토리보드

완성된 스토리보드를 **인터랙티브 비주얼 스토리**로 변환합니다. 클릭, 길게 누르기, 드래그 등 그림 위에서 동작하며 사운드, 자막, 대화 및 영화의 리듬을 따르는 전환 효과를 갖춘 웹 페이지를 만듭니다.

인터랙티브 스토리보드란 무엇인가요?

이 스킬은 PDF나 이미지로 된 완성된 스토리보드를 하나의 HTML 페이지에서 동작하는 인터랙티브 비주얼 스토리로 변환하는 방법을 안내합니다. 뷰어는 그림 자체를 클릭하거나, 길게 누르거나, 드래그하여 이야기를 진행시키며, 합성 또는 녹음된 사운드, 자막/대화, 영화의 리듬을 존중하는 전환 효과를 경험할 수 있습니다. 이 스킬은 이미 스토리보드(보드, 샷, 슬러그, 노트)에 익숙한 사람을 대상으로 하며, 애니매틱 생성기가 아닙니다. 저자 Ding Yilin의 예시 사례인 *The Joy of the White Room*과 *Fahrenheit 451* (장면 1, 8, 9)이 [`examples/`](../examples/)에 포함되어 있으며, 라이브 데모는 [The Joy of the White Room](https://dingyilin.netlify.app/story/camera-bianca/) 및 [Fahrenheit 451, scenes 1 → 8 → 9](https://dingyilin.netlify.app/story/fahrenheit-451/)에서 확인할 수 있습니다. 주요 기능으로는 스토리보드 읽기, 룩 프리셋(필름/리소, 아메리칸 코믹, 픽셀), 장면 상태 머신, 제스처 기반 상호작용, 사운드 브리지, 다국어 지원, 성능 최적화 및 철저한 테스트 절차가 포함됩니다. 빌드 전에 변경할 사항만 물어보고 나머지는 합리적인 기본값을 사용하며, 그 기본값이 무엇인지 명시해야 합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/beiabei10/interactive-storyboard/tree/HEAD/interactive-storyboard

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

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

문서

인터랙티브 스토리보드은(는) 무엇을 하나요?

완성된 스토리보드를 인터랙티브 비주얼 스토리로 변환하세요: 하나의 HTML 페이지에서 뷰어가 그림 자체를 클릭, 길게 누르기, 드래그하여 이야기를 진행시키며, 사운드, 자막/대화, 영화의 리듬을 존중하는 전환 효과를 갖춘 웹 페이지를 만듭니다. 이미 스토리보드(보드, 샷, 슬러그, 노트)에 익숙한 사람을 대상으로 하며, 애니매틱 생성기가 아닙니다.

저자 Ding Yilin의 예시 사례: The Joy of the White Room 및 Fahrenheit 451 (장면 1, 8, 9) — examples/ 참조; 라이브 데모: The Joy of the White Room, Fahrenheit 451, scenes 1 → 8 → 9.

0. 빌드 전 질문 (한 라운드, 이후 진행)

빌드를 변경하는 것에 대해서만 물어보고, 나머지는 합리적인 기본값을 사용하며 그 기본값이 무엇인지 명시하세요.

  1. 어떤 장면 / 보드 (긴 스토리보드: 먼저 한 장면을 시범으로 만든 후, 나머지는 동일한 방식으로 진행).
  2. 룩: 아래 프리셋 중 하나, 또는 "내 그림을 그대로 유지".
  3. 텍스트: 대화만 / 나레이션만 / 둘 다 / 없음. 스토리보드 자체 대사를 사용하고, 절대 대화나 나레이션을 새로 만들지 마십시오.
  4. 사운드: 사용자의 녹음 (파일과 각 파일이 어떤 보드에 속하는지 물어보세요) 또는 합성 사운드.
  5. 언어: 항상 작품에 필요한 언어를 물어보세요. 기본 설정은 없습니다. 해당 언어만 빌드하세요. 화면에 표시되는 모든 문자열(제목, 슬러그, 힌트, 말풍선, 크레딧)은 언어별 테이블에 저장되며 실시간 전환이 가능합니다. 둘 이상의 언어가 있는 경우 시작 언어는 호스트 페이지(?lang=, postMessage, 또는 <html lang>)를 따를 수 있습니다. 사용자가 만든 번역은 초안이므로 사용자가 확인해야 합니다.
  6. 배포 위치: 공유 가능한 페이지 전용인지, 아니면 사용자 자신의 웹사이트에 임베드될 것인지 (사이트 패키지를 물어보고 해당 사본을 수정하세요).
  7. 크레딧 라인: 사용자가 제공한 정확한 문구를 사용하세요 (예: "Made by …"); 사용자가 나열하지 않은 역할을 추가하지 마십시오.

1. 스토리보드 읽기

  • Storyboarder / PDF 내보내기: pdfimages -png는 NOTE 영역을 포함한 전체 크기의 각 보드를 제공합니다. 한 번 그리기 프레임을 찾아(프레임 라인을 위해 행/열 스캔) 모든 보드를 동일하게 그리기 영역으로 크롭하세요(무대가 16:9이면 16:9 윈도우 유지). pdftoppm -r 150으로 페이지를 렌더링하고 노트, 슬러그(EXT./INT. … – DAY/NIGHT), 지속 시간 및 대화를 읽고; pdftotext -layout으로 슬러그를 추출하세요.
  • 각 보드의 접촉 시트와 격자 뷰(너비/높이의 0.1마다 선)를 만드세요: 이후 모든 좌표(인물이 서는 위치, 탭할 위치, 화면 위치)는 이미지 분수로 측정되며 절대 추측하지 마십시오.
  • 비트 목록을 작성하세요: 보드 → 일어나는 일 → 뷰어가 그 동작을 수행하게 할 하나의 제스처 → 사운드 → 텍스트.

2. 효과보다 샷 먼저

  • 롱테이크를 찾으세요. 동일한 설정과 움직이는 주제(걷는 사람들의 A→B→C)가 있는 연속된 보드는 하나의 연속 샷입니다: 하나의 깨끗한 배경을 만들고(다른 보드를 사용하여 주제를 패치 아웃), 주제를 잘라내어 움직이며, 카메라는 함께 드리프트합니다. 거기서 전체 보드를 크로스 디졸브하지 마세요.
  • 동일한 주제의 클로즈 샷 → 와이드 샷(또는 그 반대)은 하나의 움직임입니다: 와이드 보드의 주제가 클로즈 보드와 동일한 크기와 위치를 가지도록 프레임을 맞추고(측정된 머리/발 위치에서 줌과 중심 계산), 그 일치된 프레이밍에서 크로스페이드를 완료한 다음 뒤로 물러나세요. 스크린샷으로 일치된 프레임을 확인하세요: 고스트가 보이면 숫자가 잘못된 것입니다.
  • 하나의 움직임으로 읽혀야 하는 보드는 하나의 팔레트를 공유합니다(동일한 프리셋 컬러로 처리).
  • 사용자가 보드가 TV의 뒷면, 뒤에서 본 문 등을 보여준다고 말하면, 보드가 보여주지 않는 것은 아무것도 그리지 마세요: 빛과 소리가 오프스크린을 암시할 수 있습니다.

3. 룩 프리셋

모든 프리셋은 사용자의 선화를 유지하며 절대 다시 그리지 않습니다.

  • 필름 / 리소 (White Room 룩): 장면별 그레이딩 (어둠 속에서 밝고 채도 높은 색상), 부드러운 종이 질감, 은은한 그레인; 가끔 — 지속적이지 않게 — 게이트 위브, 플리커 및 희미한 스크래치; 등록 그림자. 효과는 드물고 조용합니다: 지속적인 플리커나 떨림은 피로합니다.
  • 아메리칸 코믹: 양방향 스무딩; 어두운 임계값에서 잉크 레이어 더하기 블랙햇으로 가는 펜선이 잉크 처리됨; 그려진 영역 내 플랫 스팟 컬러, 중간톤에 45° Ben-Day 도트, 전체 패널에 밀도가 가장자리에서 더 높은 라이트 스크린; 컬러 플레이트가 잉크 플레이트에서 1–2px 오프셋; 출력 ~1.5×. 위치/시간당 하나의 스팟 컬러 (따뜻한 낮, 푸른 밤, 초록 CCTV, 빨간 알람…). 레터링: 슬러그용 노란 캡션 박스, 그림 내 코믹 SFX 단어, 대화용 말풍선.
  • 픽셀: 제한된 팔레트와 순서 있는 디더링으로 작은 그리드에 다운스케일, 최근접 이웃 업스케일; 픽셀 폰트의 텍스트.

페이지 크롬은 프리셋을 따릅니다 (상영관, 신문지 페이지, 게임 화면). 웹 폰트는 2–3초 폴백 레이스로 로드되어 스토리가 폰트를 기다리지 않도록 합니다.

4. 빌드: 하나의 HTML 페이지, 하나의 캔버스

  • 16:9 무대, 캔버스, 그 아래 자막/힌트 영역, 언어 스위치(둘 이상의 언어인 경우), 사운드 토글.
  • 장면 상태 머신: 각 장면은 enter / render(t) / tap / drag / down / up / hover / key를 가진 객체입니다. go(scene)으로 전환하고 st()는 장면 내 시간입니다. 카메라 헬퍼(setCam(img, zoom, cx, cy), toScreen, toImg)로 모든 히트 영역과 효과가 이미지 분수로 배치되고 카메라를 따르도록 합니다.
  • 모든 장면에는 나가는 방법이 있습니다: 키보드 키와 느린 자동 폴백(10–20초)으로 누구도 갇히지 않도록 하고, 긴 장면에는 "건너뛰기" 링크가 있습니다.
  • 모든 사운드 호출을 래핑하여 오디오 컨텍스트 누락이나 디코드 실패가 스토리를 망가뜨리지 않도록 하세요.
  • <img>로 이미지 로드(file://에서도 작동); fetch + decodeAudioData로 오디오 로드, fetch가 차단되면 <audio> 요소로 폴백.

5. 인터랙션 디자인

  • 제스처가 스토리 액션입니다. 달리기 = 빠른 클릭; 숨 참기 = 터치하지 않음; 밖을 보려고 기울이기 = 길게 누르기; 오르기 = 반복된 드래그 업; 건네주기 = 들고 가기; 페이지 넘기기 = 책 위를 드래그; 끄기 = 버튼 위의 손을 길게 누르기. 일반적인 "클릭하여 계속"보다 이것들을 선호하세요; 대화와 순수한 리듬의 비트에는 일반 탭을 유지하세요.
  • 사용자 자신의 그림을 가져오고, 절대 발명된 소품을 사용하지 마세요. 그림/객체를 윤곽선을 따라 잘라내고(격자 확대에 다각형 추적, 부드러운 가장자리), 종이 컷아웃처럼 얇은 흰색 테두리를 추가하고, 드래그하는 동안 작은 그림자와 기울기를 주어 들어 올리고, 원래 있던 곳에 맨 종이를 남기고, 잘못 놓으면 스냅백합니다. 보드에 대해 컷을 확인하세요: 계단, 가구 또는 다른 캐릭터의 손이 실수로 포함되지 않도록 하세요.
  • 보드 위에 추가된 효과(화면 켜짐, 전파, 뷰파인더)는 그림의 기하학을 따라야 합니다 — 화면 글로우를 사각형이 아닌 화면의 원근 사변형으로 클리핑 — 하고 추가 사항으로 사용자에게 알려야 합니다.
  • 힌트는 위치와 방법을 알려줍니다: "물고기를 길게 누르고 앞뒤로 휘갈기세요" ("상호작용"이 아님). 본문 텍스트보다 크게, 그림 아래에.
  • 그림 위의 가이드, 기본적으로 조용함 (What Remains of Edith Finch 생각): 터치 포인트에 이미 액션을 말해주는 작은 표시 — 탭용 펄스, 길게 누르기용 채워지는 링, 드래그 방향으로 흐르는 쉐브론, 원형 동작용 회전 호(코믹 스타일: 잉크로 "여기 봐" 표시). 단계가 시작될 때 손이 제스처를 두 번 시연한 후 물러나고, 약 3초의 망설임 후에만 다시 나타납니다. 손가락이 내려가 있는 동안 모든 것을 숨깁니다. 긴 점선 경로로 그림을 덮지 마십시오.

6. 전환

  • 톤에 맞추세요: 기본적으로 부드럽게(디졸브, 새 패널이 약간 더 큰 상태에서 안착, 잉크 인/아웃, TV 켜짐이나 불붙음에 대한 가벼운 글로우). 장면의 단일 충격을 위해 하드 컷 하나(네거티브 프레임, 속도선, 떨림)를 유지하세요. 모든 하드 컷은 뻣뻣합니다.
  • 다음 공간으로의 연속적인 푸시는 하나의 긴 움직임입니다: 그 사이에 있는 모든 것(벽)은 대상 패널의 색상과 질감을 취해 그 안으로 녹아듭니다. 움직임 중간에 거터가 없습니다.
  • 회전하거나 확대된 이미지의 검은 가장자리를 절대 표시하지 마세요: 카메라를 클램프하세요.

7. 사운드

  • 녹음된 사운드: 액션에 맞춰 트림(문 열림을 그려진 손잡이와 동기화), 모든 것을 레벨링, 페이드로 앰비언스 루프.
  • 합성 사운드 (WebAudio, 파일 없음): 발소리, 종이, 문, 기계적 사냥개, 알람, 심장 박동, TV 웅성거림… 각 히트를 무작위화(타이밍, 피치, 엔벨로프)하고 엔벨로프를 고르지 않게 형성하여 기계처럼 반복되는 소리가 없도록 하고, 조용한 장면에서 클릭과 건조한 삐 소리를 피하세요.
  • 의미를 위해 사운드 브리지를 사용하세요(세탁기가 점차 꿈의 바다가 됨, 제목 위로 이어지는 사운드). 스토리보드가 암시하지 않는 사운드를 추가하기 전에 물어보세요.

8. 텍스트

  • 대화: 말풍선(코믹) 또는 자막(필름), 꼬리가 말하는 사람의 머리를 가리키고, 패널 안에 유지되며, 측정하여 줄바꿈하고, 닫는 문장 부호로 줄을 시작하지 않음. 각 말풍선의 몸체와 꼬리를 별도로 채워 획이 텍스트를 가로지르지 않도록 하세요.
  • 슬러그는 모서리의 캡션 박스로; 중요한 그림 위에 두지 마세요(주제를 가릴 보드에서는 캡션 생략).
  • 추가하는 인용문(예: 캐릭터가 낭송하는 것)은 퍼블릭 도메인이어야 하며 사용자에게 플래그를 지정해야 합니다.

9. 성능

  • 캔버스를 약 1600px 너비로 제한하세요 (DPR = max(1, min(devicePixelRatio, 2, 1600 / cssWidth))).
  • 정적 오버레이(종이 질감, 비네트)를 크기별로 한 번 사전 렌더링하고 각 프레임에 레이어링하세요. 프레임당 그라디언트나 패턴을 다시 빌드하지 마세요.
  • 디졸브의 경우 이전 프레임을 절반 크기로 유지하고, 매 프레임마다 전체 복사본을 만들지 마세요.
  • 호스트 페이지에서 스토리를 지연 로드하세요(포스터 + "스토리 입장" 버튼); 각 장면 페이지는 자신의 이미지만 로드합니다.

10. 뷰어처럼 테스트하기

  • 실제 마우스 제스처(클릭, 길게 누르기, toScreen에서 측정된 드래그)로 전체 스토리를 모든 언어로 진행하는 헤드리스 브라우저 실행(예: Playwright), 페이지 오류 시 실패. 테스트 전용 __go(scene, state)를 노출하여 비트로 점프.
  • 모든 키 프레임 그리고 각 전환/일치의 중간의 스크린샷을 찍고 살펴보세요.
  • 편집 후 스크립트의 구문을 확인하세요 (node --check). 한 줄 문장 중간에 // 주석을 넣지 마세요(나머지 줄을 조용히 주석 처리하여 페이지가 빈 상태로 남습니다).
  • 큰 변경 전후에 프레임 속도를 측정하세요. 사운드와 느낌이 재생이 아닌 측정과 스크린샷으로 확인되었다고 명확히 말하세요.

11. 전달

  • 검토용 공유 가능한 호스팅 페이지; 사용자 웹사이트의 경우, 자체 폴더(예: story/<project>/)에 스토리가 포함된 해당 사이트 패키지의 zip, 지연 로딩 임베드 블록, 그 외 변경 사항 없음. 사용자가 자신의 사이트 내에서 스토리를 수정한 경우, 항상 해당 복사본을 편집하고(변경 사항을 3방향 병합), 원본으로 덮어쓰지 마세요.
  • 여러 장면: 하나의 자산 폴더를 공유하는 장면당 하나의 페이지, 체인으로 연결(장면 끝 → 다음 장면, 언어 유지; 마지막은 첫 번째로 돌아감). 각 장면의 커버는 탐색 후 오디오를 잠금 해제하기 위해 한 번 클릭이 필요합니다.
  • 사용자를 대신하여 어디에도 배포하지 마세요. zip을 전달하세요.
  • 단일 파일을 자체적으로 열면 검은 화면이 표시됩니다: 페이지 옆에 a/ 자산 폴더가 필요합니다. 파일을 전달할 때 이를 알리세요.

관련 스킬