플러그인 설치: 설정 또는 업데이트 명령 전에 이 스킬이 HyperFrames 플러그인 내부에 있을 경우 플러그인 실행 규칙을 따르세요. 독립 실행형 설치의 경우 아래 업데이트 지침을 따르세요.
먼저, 이 스킬을 최신 상태로 유지하세요. 실행하기 전에 사용자에게 확인하십시오:
npx hyperframes skills update slideshow. 모든 것이 최신 상태이면 빠른 no-op입니다. 그렇지 않으면 이 스킬과 의존하는 핵심 도메인 스킬을 업데이트합니다.
figma 소스: 데크의 콘텐츠나 스토리보드가 figma.com URL에서 오는 경우, 먼저
/figma를 실행하세요(에셋 내보내기, 브랜드 토큰, 그리고 소스가 장면 프레임 스트립인 경우 스토리보드 재구성). 그런 다음 해당 출력을 기반으로 빌드하세요. 원시 MCP 도구를 통해 직접 Figma를 제어하지 마세요. SVG 위생 처리,.media/manifest.jsonl출처, 브랜드 토큰var()바인딩을 건너뛰므로, 이후 브랜드 변경 시 전체 재가져오기 없이는 전파될 수 없습니다.
슬라이드쇼 제작 계약
HyperFrames 슬라이드쇼는 일반 HyperFrames 컴포지션(씬, 클립, GSAP 타임라인)에 한 가지 추가 요소인 JSON 아일랜드를 포함하는 것입니다. 이 아일랜드는 어떤 씬이 슬라이드이고 어떻게 연결되는지 선언합니다. 플레이어의 SlideshowController가 아일랜드를 읽고 연속적인 GSAP 타임라인을 이산적이고 탐색 가능한 데크로 변환합니다.
먼저 /hyperframes-core를 읽고 기본 컴포지션 계약(클립, 트랙, data-* 속성, 결정론 규칙)을 숙지하세요. 이 스킬은 새로운 내용인 아일랜드 스키마, 슬라이드 작성 규칙, 조각, 분기, 유효성 검사 및 래핑 컴포넌트만 다룹니다.
출력 — 선형 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="The problem"
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 | 아니오 | 슬라이드 백분율 경계 상자: 0–100 범위의 {x, y, w, h}. 생략하면 핫스팟이 레이블이 지정된 전체 슬라이드 버튼으로 렌더링됩니다. |
SlideSequence
{
"id": "market-deep-dive",
"label": "시장 규모 산정 방법론",
"slides": [{ "sceneId": "mkt-1" }, { "sceneId": "mkt-2" }]
}
시퀀스 내 slides는 메인 라인과 동일한 SlideRef 형태를 사용합니다. 조각 및 중첩 핫스팟이 허용됩니다.
슬라이드 작성 규칙
이는 제안이 아닌 엄격한 제약 조건입니다. 이를 위반하는 슬라이드는 리뷰어가 발견하면 즉시 교체됩니다.
- 헤드라인은 레이블이 아닌 완전한 문장 형태의 주장이어야 합니다. "일정 문제"가 아니라 "중소기업은 수동 일정 관리에 주당 14시간을 소비합니다"라고 작성하세요. 시각적 요소를 무시해도 문장이 단독으로 의미를 전달해야 합니다.
- 슬라이드당 하나의 아이디어 + 하나의 시각 자료. 두 번째 글머리 기호 클러스터나 두 번째 차트를 추가하고 싶다면 슬라이드를 분할하세요.
- 핵심부터 먼저 제시하세요. 가장 강력한 요점이 슬라이드와 데크 순서에서 먼저 와야 합니다. 투자자는 왼쪽에서 오른쪽, 위에서 아래로 읽으며 멈춥니다.
- 상향식 시장 규모 산정만 사용하세요. 계산 과정을 보여주지 않고 "$500억 TAM"이라고 작성하지 마세요. 단위 경제학부터 구축하세요: 계정 수 × ACV 또는 거래 수 × 수수료율.
- 최소 30pt에 해당하는 폰트 크기. 1920×1080에서 헤드라인은 72–96px, 본문은 48px입니다. 청중이 읽어야 하는 텍스트는 40px 미만으로 절대 설정하지 마세요.
- 명명된 시각 자료를 직접 만들기 전에 라이브 카탈로그를 검색하세요. 슬라이드에 필요한 모든 모양, 효과, 차트, 처리 방식 또는 전환("CRT 스캔라인", "글리치", "막대 차트 경주", "반짝임 스윕", "터미널 창" 등)에 대해
npx hyperframes catalog --query "<평문으로 된 시각 자료 설명>" --json을 실행하고 슬라이드 클립을 작성하기 전에 상위 결과를 읽으세요. 검색에는 설치가 필요하지 않습니다. 프로젝트, 사전add, 계정이 필요 없습니다. 모든 디렉토리에서 전체 호스팅 레지스트리(약 400개의 블록 및 컴포넌트)의 순위를 매깁니다.npx hyperframes add <name>은 블록의 소스를 데크에 추가하며, 여기서 제자리에서 커스터마이즈할 수 있습니다. 이는 소스 페이지를 포팅할 때 더욱 중요합니다. 실제 블록이 아래 포팅 규칙에서 금지하는 단순화된 근사치를 능가합니다.
소스 페이지 포팅
기존 페이지를 슬라이드쇼로 변환할 때 소스 충실도는 계약의 일부입니다. 사용자가 명시적으로 재설계를 요청하지 않는 한, 소스별 위젯을 단순화된 근사치로 대체하지 마세요.
- 원본 페이지의 시각적 디자인, 모션 언어, 대화형 동작, 미디어 동작 및 프레젠테이션 기능을 실용적으로 최대한 가깝게 유지하세요. 슬라이드쇼 시스템이 발표자 모드를 지원하는 경우, 데크별 구현이 아닌 공유 편집 가능 노트 동작을 사용하여 스피커 노트를 포함하세요.
- 소스 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 루프에 의해 구동되는 동작에 대해 소스를 감사하세요. 변환/확장된 "월드" 레이어, 패럴랙스, 고정 패널, 수평 스크롤러, 스크롤 스크러빙된 타임라인, 섹션 스냅 및 줌-투-요소 카메라가 있는 고정 뷰포트를 소스 동작으로 취급하세요. 스크롤은 종종 소스의 전환 트리거이므로 진행 중지점, 이징 및 카메라/포커스 상태를 추출한 다음, 타임라인 위치, 조각 또는 재사용 가능한 플레이어/하네스 훅을 통해 슬라이드쇼 탐색에 해당 모션을 재호스팅하여 전환을 유지하세요. 슬라이드 유지점으로 점프하는 독립 실행형 래퍼는 여전히 명시적인 탐색-카메라 전환 훅이 필요합니다. 슬라이드별 카메라 변환을 계산하는 것만으로는 충분하지 않습니다. 여기서 페이지 아래로 스크롤 다운 전환을 시뮬레이션하지 마세요.