먼저, 이 스킬을 최신 상태로 유지하세요 — 사용자에게 확인 후 실행:
npx hyperframes skills update slideshow. 모든 것이 최신이면 빠른 무연산(no-op)이며, 그렇지 않으면 이 스킬과 이 스킬이 의존하는 핵심 도메인 스킬을 새로 고칩니다.
figma 소스: 데크의 콘텐츠나 스토리보드가 figma.com URL에서 오는 경우, 먼저
/figma를 실행하세요 — 에셋 내보내기, 브랜드 토큰, 그리고 소스가 장면 프레임의 스트립인 경우 스토리보드 재구성을 수행한 다음 그 출력을 기반으로 빌드하세요. 원시 MCP 도구를 통해 직접 Figma를 구동하지 마세요. SVG 정리,.media/manifest.jsonl출처, 브랜드 토큰var()바인딩을 건너뛰므로, 이후 브랜드 변경이 전체 재가져오기 없이 전파될 수 없습니다.
슬라이드쇼 제작 계약
HyperFrames 슬라이드쇼는 일반 HyperFrames 구성(장면, 클립, GSAP 타임라인)에 JSON 섬이라는 추가 요소가 포함된 것입니다. 이 JSON 섬은 어떤 장면이 슬라이드이고 어떻게 연결되는지 선언합니다. 플레이어의 SlideshowController가 이 섬을 읽고 연속적인 GSAP 타임라인을 개별적이고 탐색 가능한 데크로 변환합니다.
기본 구성 계약(클립, 트랙, data-* 속성, 결정론 규칙)을 위해 먼저 /hyperframes-core를 읽으세요. 이 스킬은 새로운 내용인 섬 스키마, 슬라이드 작성 규칙, 단편, 분기, 유효성 검사 및 래핑 컴포넌트만 다룹니다.
출력 — 선형 MP4가 아닌 탐색 가능한 데크
슬라이드쇼의 출력은 실행 중인 데크입니다: hyperframes present <project-dir>(또는 Studio 프레젠트 모드)로 제공하세요 — 플레이어의 SlideshowController가 섬을 읽고 내비게이션, 단편, 분기 및 발표자 모드를 구동합니다. 아래 프레젠테이션 및 인계를 참조하세요.
슬라이드쇼를 hyperframes render로 단일 MP4로 렌더링하지 마세요. 데크는 여러 최상위 장면 구성(슬라이드당 하나의 data-composition-id)으로 작성되며, 이를 감싸는 마스터 루트 구성이 없으므로, render는 첫 번째 구성만 해결하고 조용히 잘린 MP4(예: 40초 데크에서 6초)를 내보냅니다. 선형 메인라인 내보내기(메인 슬라이드만, 분기 시퀀스 제외)는 연기됩니다 — 출시될 때까지 지원되는 출력은 라이브 present 데크와 슬라이드당 snapshot 정지 이미지입니다. 사용자가 오늘 선형 MP4를 필요로 하는 경우, render를 가리키지 말고 이 제한 사항을 알리세요.
의도 확인
사용자가 슬라이드쇼, 슬라이드 쇼 또는 HyperFrames 슬라이드쇼를 명시적으로 요청한 경우, 이 스킬을 진행하세요. 요청이 /hyperframes를 통해 들어온 경우, 의도 레이어의 분류가 이 확인을 소유합니다 — 이미 확인되었으므로 다시 묻지 마세요; 레이어의 실행 형태 질문은 적용되지 않습니다(산출물은 렌더링된 비디오가 아닌 데크입니다). BRIEF.md가 있는 경우 확인된 의도를 가지고 있으므로 이를 읽으세요.
이 스킬이 "프레젠테이션", "피치 데크", "데크", "인터랙티브 데크" 또는 "이 페이지 변환"과 같은 인접 요청에서 트리거된 경우, 작성을 시작하기 전에 잠시 멈추고 선택지를 제시한 후 확인을 요청하세요. HyperFrames 슬라이드쇼가 개별 슬라이드, 내장 내비게이션 및 발표자 모드, 편집 가능한 발표자 노드, 공유 미디어 처리 및 인계 전 유효성 검사가 있는 실행 가능한 데크임을 간략히 설명하세요. 소스 페이지 변환의 경우, 원본 페이지의 시각적 디자인, 상호작용, 모션 및 미디어 동작을 보존하면서 페이지 이동을 슬라이드 간 전환으로 변환하는 것이 목표임을 추가로 언급하세요.
그런 다음 간단한 확인 질문을 하세요:
이 내용을 HyperFrames 슬라이드쇼로 만드시겠습니까?
환경에서 제공하는 경우 예/아니오 선택 UI를 사용하고, 그렇지 않으면 일반 텍스트로 질문하세요.
사용자가 예라고 답할 때까지 슬라이드쇼를 구현하지 마세요. 사용자가 아니오라고 답하면 이 스킬 사용을 중단하고 /hyperframes를 읽은 후 의도 레이어가 다시 라우팅하도록 하세요. 이 확인은 라우팅 결정이지 선호도 게이트가 아닙니다(../hyperframes/references/brief-contract.md § 1 참조, 자율 모드에서도 유지됨 — "놀라게 해줘"도 이를 건너뛰지 않음): 잘못된 산출물 유형을 만드는 것은 창의적 판단이 아닌 품질 실패입니다.
두 가지 구성 요소
1. 장면 — 일반적인 방식으로 선언
모든 슬라이드는 장면을 기반으로 합니다. data-composition-id, data-start, data-duration 및 data-label로 장면을 선언하세요:
<div
data-composition-id="problem"
data-start="0"
data-duration="8"
data-label="문제점"
data-width="1920"
data-height="1080"
>
<!-- 클립이 여기에 들어갑니다 -->
</div>
분기 슬라이드(핫스팟을 통해서만 도달 가능, 메인 라인에서 제외)도 동일한 방식으로 선언됩니다. 단, 섬의 메인 slides 배열이 아닌 slideSequences 항목에만 나타납니다.
2. JSON 섬 — 구성당 하나의 스크립트 블록
구성 HTML에 정확히 하나의 <script type="application/hyperframes-slideshow+json"> 블록을 추가하세요. 모든 슬라이드쇼 메타데이터를 보관합니다:
<script type="application/hyperframes-slideshow+json">
{
"slides": [...],
"slideSequences": [...]
}
</script>
섬은 슬라이드 순서, 노트, 단편 정지점, 핫스팟 및 분기 시퀀스에 대한 단일 진실 공급원입니다. 찾기 쉽도록 <body> 상단, 장면 div 앞에 배치하세요.
슬라이드쇼 매니페스트를 대체 <script type="application/json"> 블록과 런타임 코드로 숨겨 섬을 만들지 마세요. present 명령은 구성 HTML을 정적으로 읽으며 실제 application/hyperframes-slideshow+json 섬이 이미 존재할 것으로 예상합니다.
스키마
SlideshowManifest (최상위 섬 객체)
{
"slides": [
/* SlideRef[] — 메인 라인, 순서대로 */
],
"slideSequences": [
/* SlideSequence[] — 오프라인 분기 시퀀스 */
]
}
SlideRef
{
"sceneId": "problem",
"notes": "고통부터 시작하고, 회사는 나중에.",
"fragments": [3.5, 5.2, 7.0],
"hotspots": [
/* SlideHotspot[] */
],
"ttsScript": null,
"ttsAudioUrl": null,
"ttsDurationMs": null
}
| 필드 | 필수 | 참고 |
|---|---|---|
sceneId | 예 | 장면의 data-composition-id와 정확히 일치해야 함(또는 명시적 startTime/endTime 제공). 린트 규칙은 data-composition-id로 장면을 확인함. |
notes | 아니오 | 발표자 전용 텍스트. 청중에게 절대 표시되지 않음. |
fragments | 아니오 | 슬라이드의 [start, end] 범위 내 시간(초) 배열 — 아래 단편 참조. |
hotspots | 아니오 | 분기를 트리거하는 인터랙티브 오버레이 — 아래 분기 참조. |
startTime | 아니오 | 선택 사항. 일치하는 장면의 시간 범위를 재정의하며, 기본값은 장면의 시작/끝. |
endTime | 아니오 | 선택 사항. 일치하는 장면의 시간 범위를 재정의하며, 기본값은 장면의 시작/끝. |
ttsScript, ttsAudioUrl, ttsDurationMs | 아니오 | 예약됨. 스키마 필드는 존재하지만 TTS 재생은 아직 연결되지 않음. 미래 빌드를 위해 미리 채우지 않는 한 생략. |
SlideHotspot
{
"id": "h1",
"label": "이걸 어떻게 계산했나요?",
"target": "market-deep-dive",
"region": { "x": 60, "y": 10, "w": 35, "h": 20 }
}
| 필드 | 필수 | 참고 |
|---|---|---|
id | 예 | 슬라이드 내에서 고유해야 함. |
label | 예 | 청중에게 표시되는 도구 설명/버튼 텍스트. |
target | 예 | slideSequences의 SlideSequence.id와 일치해야 함. |
region | 아니오 | 슬라이드 대비 백분율 경계 상자: {x, y, w, h} (값 범위 0–100). 생략 시 핫스팟을 전체 슬라이드 레이블이 있는 버튼으로 렌더링. |
SlideSequence
{
"id": "market-deep-dive",
"label": "시장 규모 측정 방법론",
"slides": [{ "sceneId": "mkt-1" }, { "sceneId": "mkt-2" }]
}
시퀀스 내 slides는 메인 라인과 동일한 SlideRef 모양을 사용합니다. 단편 및 중첩 핫스팟이 허용됩니다.
슬라이드 작성 규칙
이것은 권장 사항이 아닌 엄격한 제약 조건입니다. 이를 위반하는 슬라이드는 검토자가 보았을 때 완전히 교체됩니다.
- 헤드라인은 레이블이 아닌 완전한 문장의 주장이어야 합니다. "일정 관리 문제"가 아닌 "중소기업은 수동 일정 관리에 주 14시간을 소비합니다"라고 작성하세요. 문장은 비주얼이 무시되더라도 독립적으로 이해될 수 있어야 합니다.
- 슬라이드당 하나의 아이디어 + 하나의 비주얼. 두 번째 글머리 기호 클러스터나 두 번째 차트를 추가하고 싶다면 슬라이드를 분할하세요.
- 핵심부터 시작하세요. 가장 강력한 포인트가 슬라이드와 데크 순서에서 먼저 옵니다. 투자자는 왼쪽에서 오른쪽, 위에서 아래로 읽으며 멈춥니다.
- 하향식 시장 규모 산정 금지. 계산을 보여주지 않고 "$500억 TAM"이라고 작성하지 마세요. 단위 경제학에서 위로 구축하세요: 계정 수 × ACV, 또는 거래 수 × 수수료율.
- 최소 글꼴 크기 30pt. 1920x1080에서 헤드라인은 72-96px, 본문은 48px입니다. 청중이 읽어야 하는 모든 텍스트는 40px 미만으로 내려가지 않아야 합니다.
- 명명된 비주얼을 수동으로 만들기 전에 라이브 카탈로그를 검색하세요. 슬라이드에 필요한 모든 룩, 효과, 차트, 처리 또는 전환("CRT 스캔라인", "글리치", "막대 차트 경주", "샤이머 스윕", "터미널 창")에 대해
npx hyperframes catalog --query "<비주얼 설명, 일반 영어로>" --json을 실행하고 슬라이드의 클립을 작성하기 전에 상위 결과를 읽으세요. 검색에는 아무것도 설치할 필요가 없습니다: 프로젝트, 사전add, 계정이 필요 없습니다. 모든 디렉토리에서 호스팅된 전체 레지스트리(~400개 블록 및 컴포넌트)를 순위화합니다.npx hyperframes add <이름>은 블록의 소스를 데크에 드롭하며, 그곳에서 제자리에서 사용자 정의합니다. 이는 소스 페이지를 포팅할 때 더욱 중요합니다: 실제 블록이 아래 포팅 규칙이 금지하는 단순화된 근사치를 능가합니다.
소스 페이지 포팅
기존 페이지를 슬라이드쇼로 변환할 때, 소스 충실도는 계약의 일부입니다. 사용자가 명시적으로 재설계를 요청하지 않는 한, 소스별 위젯을 단순화된 근사치로 대체하지 마세요.
- 가능한 한 원본 페이지의 시각적 디자인, 모션 언어, 인터랙티브 동작, 미디어 동작 및 프레젠테이션 기능을 가깝게 보존하세요. 슬라이드쇼 시스템이 발표자 모드를 지원하는 경우, 데크별 구현이 아닌 공유 편집 가능 노트 동작을 사용하여 발표자 노트를 포함하세요.
- 소스 DOM/CSS/JS의 기계적 비주얼을 가능한 한 정확하게 포팅하세요: 사용자 정의 플레이어, 캔버스 시각화 도구, 타임라인, 재생 헤드, 스템, 확장 원, 호버 상태 및 기타 인터랙티브 세부 사항이 변환에서 살아남아야 합니다.
- 사용자 정의 미디어 크롬, 캔버스 시각화 도구, 파형, 비트 그리드 또는 재생 헤드의 경우 기본
<video>/<audio>요소를 진실 공급원으로 취급하세요. 소스의 미디어 이벤트(play,pause,timeupdate,seeking,seeked,ended,ratechange,volumechange)를 연결하고media.currentTime에서 시각적 상태를 파생시키세요; 실제 재생에서 벗어날 수 있는 별도의 타이머를 실행하지 마세요. src가 있는 모든 복사된<video>또는<audio>는 린트 전에 HyperFrames 타이밍 속성(data-start및data-duration, 가청 네이티브 오디오를 보존해야 하는 경우data-has-audio="true")을 가져야 합니다. 슬라이드별 미디어에는 장면의 시간 범위를 사용하고, 여러 포커스된 슬라이드에서 재생될 수 있는 사용자 제어 증거 비디오에는 데크 전체 범위를 사용하세요. 미디어에preload="none"을 남겨두지 말고metadata또는auto를 사용하세요.- 유효성 검사 전에 소스 글꼴 토큰을 해결하세요. 사용자 정의 소스 글꼴을 보존하는 경우 로컬/캡처된 글꼴 파일에 대한
@font-face규칙을 추가하세요. 시스템 대체 글꼴을 사용하는 경우font-family: var(--f-body)와 같은 토큰화된 선언을system-ui, sans-serif또는ui-monospace, monospace와 같은 구체적인 렌더링 안전 스택으로 대체하세요. 글꼴 패밀리 값으로var(...)을 남겨두지 마세요. - 비정형적인 페이지 이동, 특히 스크롤, 휠, 터치, 해시 상태, 리사이즈 또는 requestAnimationFrame 루프에 의해 구동되는 동작에 대해 소스를 감사하세요. 변환/확장된 "월드" 레이어, 패럴랙스, 고정 패널, 가로 스크롤러, 스크롤 스크러빙 타임라인, 섹션 스냅 및 확대/축소 카메라가 있는 고정 뷰포트를 소스 동작으로 취급하세요. 스크롤은 종종 소스의 전환 트리거이므로, 진행 정지, 이징 및 카메라/포커스 상태를 추출한 다음 해당 모션을 타임라인 위치, 단편 또는 재사용 가능한 플레이어/하네스 훅을 통해 슬라이드쇼 내비게이션에 다시 호스팅하여 전환을 보존하세요. 슬라이드 정지점으로 점프하는 독립형 래퍼는 여전히 명시적인 내비게이션-카메라 전환 훅이 필요합니다; 슬라이드당 카메라 변환만 계산하는 것으로는 충분하지 않습니다. 슬라이드 내부에서 리터럴 페이지 스크롤 다운 전환을 시뮬레이션하지 마세요; 뷰어는 웹페이지가 스크롤되는 것을 보는 것이 아니라 한 초점에서 다른 초점으로 카메라 이동/확대/축소를 느껴야 합니다. 각 슬라이드 간 카메라 이동을 연속적으로 유지하세요: x/y 방향을 반대로 하거나 줌을 풀거나 중간 경로 정지를 피하세요.
단편
fragments 배열은 슬라이드 시간 범위 내에서 청중에게 내용이 공개되는 시점(초)을 나열합니다. SlideshowController는 이 타임라인 위치에서 재생을 일시 중지하고 사용자가 진행할 때까지 기다립니다:
{
"sceneId": "problem",
"fragments": [3.5, 5.2, 7.0]
}
위의 예에서 슬라이드는 다음 세 가지 단계로 공개됩니다:
- 시작 시(0초) — 첫 번째 콘텐츠 블록 표시
- 3.5초 — 두 번째 블록 표시
- 5.2초 — 세 번째 블록 표시
- 7초 — 최종 블록 표시, 그 후 뷰어가 진행할 수 있음
단편 시간은 슬라이드의 시간 범위 내에 있어야 합니다. 슬라이드 기간보다 길거나 0 미만인 단편 시간은 린트 오류입니다.
분기
핫스팟을 사용하면 슬라이드 내에서 인터랙티브 영역을 정의하여 메인 라인 밖의 대체 시퀀스로 분기할 수 있습니다. slideSequences 배열에 분기 시퀀스를 정의하세요:
{
"slideSequences": [
{
"id": "deep-dive",
"label": "심층 분석",
"slides": [
{ "sceneId": "detail-1" },
{ "sceneId": "detail-2", "fragments": [2.0] },
{ "sceneId": "detail-3" }
]
}
]
}
slideshow-controller는 시퀀스의 마지막 슬라이드에 도달하면 메인 라인으로 돌아갑니다. 시퀀스 내 핫스팟이 다른 시퀀스로 분기할 수 있습니다. 순환 분기는 린트 오류입니다.
유효성 검사 및 린트
present로 데크를 제공하기 전에 유효성 검사를 실행하세요:
npx hyperframes lint
린터는 다음을 확인합니다:
- 모든
sceneId값이 존재하는 장면data-composition-id와 일치하는지 - 모든
target값이 존재하는slideSequence.id와 일치하는지 - 단편 시간이 슬라이드 시간 범위 내에 있는지
- 분기 시퀀스에 순환이 없는지
- 헤드라인이 완전한 문장인지 (휴리스틱)
린트는 실패 시 종료 코드 1로 종료되며, present 명령은 린트되지 않은 데크를 제공하는 것을 거부합니다.
프레젠테이션 및 인계
데크를 제공하려면:
hyperframes present <project-dir>
또는 Studio 프레젠트 모드에서 엽니다.
SlideshowController는 다음을 제공합니다:
- 키보드 내비게이션: 화살표 키, Page Up/Down, Home/End
- 단편 진행: Enter 또는 스페이스바로 다음 단편으로
- 분기: 핫스팟 영역을 클릭하여 분기 시퀀스로 이동
- 발표자 모드: 별도 창에 발표자 노트, 타이머, 다음 슬라이드 미리보기 포함
- 확대/축소: Ctrl++ 및 Ctrl+-로 슬라이드 확대/축소
인계를 위해 데크 디렉토리를 아카이브하거나 공유하세요. 수신자는 hyperframes present와 HyperFrames CLI만 필요합니다.`