Communitygithub.com

lzcjsyr/Book2Video

지정된 길이나 형식의 맞춤 HyperFrames 비디오 구성을 제작하기 위한 폴백 워크플로우입니다. 긴 또는 다중 장면 작품, 브랜드/시즐 릴, 몽타주, 타이틀 카드, 정적 루프 및 자유 형식 구성을 다룹니다. 입력 및 길이에 구애받지 않습니다. 입력이 명확히 특화된 워크플로우(판매 제품, 웹사이트, 주제 설명, GitHub PR, 기존 영상, 짧은 모션 그래픽, Remotion 포트 등)에 적합하다면 해당 워크플로우를 우선 사용하고, 이 워크플로우는 아무것도 적합하지 않을 때만 일반 폴백으로 사용하세요.

Book2Video란 무엇인가요?

이 스킬은 HyperFrames 기반 맞춤 비디오 작성을 위한 일반 목적의 폴백 워크플로우입니다. 제품 런칭, 웹사이트 홍보, 주제 설명 등 특수한 입력에 최적화된 전용 워크플로우가 없을 때 사용됩니다. 이 스킬은 시각적 아이덴티티 구축, 각도 설정, 프롬프트 확장, 고수준 계획 수립, 그리고 레이아웃 우선 접근법을 강조합니다. GSAP 애니메이션을 추가하기 전에 먼저 정적 HTML/CSS로 최종 상태를 구축하여 레이아웃 충돌을 방지합니다. 또한 `hyperframes-creative`의 하우스 스타일 및 비디오 구성 참조를 필수로 읽도록 하여, 단순히 생성된 듯한 결과물이 아닌 정교하게 제작된 느낌을 보장합니다. 오디오는 통합 엔진(`hyperframes-media`)을 통해 자동 처리되며, HeyGen 자격 증명이 있으면 음악/SFX와 TTS를 검색하고, 없으면 ElevenLabs/Kokoro TTS, Lyria/MusicGen BGM 생성 및 번들 SFX 라이브러리로 대체됩니다. 이 스킬은 Claude Code와 같은 AI 에이전트에서 HyperFrames 생태계의 일부로 사용할 수 있습니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/lzcjsyr/Book2Video/tree/HEAD/skills/step4/general-video

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

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

문서

미디어 사용: 오디오/이미지 소싱 전에 /media-use를 호출하여 HeyGen 카탈로그에서 BGM/SFX/이미지를 해결하세요. 기존 에셋을 등록하려면 먼저 --adopt를 실행하세요. /media-use 스킬을 참조하세요.

일반-비디오 — 일반 비디오 워크플로우

빌드하기 전에 경로를 확인하세요. 이는 맞춤 작품 제작을 위한 폴백입니다. 입력이 명확히 특화된 워크플로우에 적합하다면 해당 워크플로우를 우선 사용하세요: 판매 제품 → /product-launch-video; 일반 사이트 → /website-to-video; 주제 설명 → /faceless-explainer; GitHub PR → /pr-to-video; 기존 영상 → /embedded-captions · /talking-head-recut; 짧은 무해설 모션 그래픽 → /motion-graphics; Remotion 포트 → /remotion-to-hyperframes. 범위 외: 실시간/렌더 시 데이터, 완성된 비디오의 NLE 스타일 편집, 또는 HyperFrames가 캡처할 수 없는 영상 제작. 확실하지 않다면? 먼저 /hyperframes를 읽으세요.

요청된 대로만 정확히 빌드하세요. 타이틀 카드는 타이틀 카드일 뿐입니다 — 타이틀 카드 + 세 개의 지원 장면 + 배경 음악 + 자막이 아닙니다. 추가 장면이나 요소가 작품을 실질적으로 향상시킨다면 _제안_하세요; 조용히 추가하지 마세요. 작은 편집(색상 수정, 지속 시간 조정, 요소 하나 추가)의 경우 계획 단계를 건너뛰고 바로 빌드하세요.

접근 방식

발견 — 열린 요청에만 해당

막연하고 탐색적인 요청("브랜드를 위한 무언가", "멋진 인트로")의 경우 — 색상을 고르기 전에 의도를 파악하세요:

  • 대상 — 누가 시청하나요? 개발자 / 경영진 / 일반 소비자?
  • 플랫폼 — 어디에서 재생되나요? 소셜(15초) / 웹사이트 히어로 / 제품 데모 / 내부용?
  • 우선순위 — 무엇이 가장 중요한가요? 모션 품질 / 콘텐츠 정확성 / 브랜드 충실도 / 속도?
  • 변형 — 하나의 최선 버전, 또는 의미 있게 다른 2-3개의 옵션(단순한 색상 변경이 아닌 다른 템포, 에너지, 또는 구조)?

구체적인 요청("타이틀 카드 추가", "장면 3의 타이밍 수정")의 경우 발견 단계를 건너뛰세요.

1단계 — 디자인 시스템 → hyperframes-creative

먼저 시각적 아이덴티티를 확립하세요. 프로젝트에 디자인 스펙이 있으면 읽으세요(우선 순위: frame.md → design.md → DESIGN.md; 정확한 색상, 글꼴, 제약 조건이 있는 브랜드 진리로 취급).

스펙이 없는 경우, 색상이나 글꼴을 선택하기 전에 반드시 hyperframes-creative/references/house-style.md와 hyperframes-creative/references/video-composition.md를 모두 읽어야 합니다. house-style.md는 "프롬프트 해석 / 실제 콘텐츠 생성" 오프너, 레이지-디폴트 목록, 레이어 레시피를 제공합니다; video-composition.md는 비디오-매체 밀도 / 스케일 / 전경 세부 묘사(데이터 막대, 등록 표시, 고정폭 메타데이터, "사용자가 요청하지 않은 두 개를 포함한 8-10개 요소") 규칙을 제공하며, 이는 "생성된" 결과물과 "제작된" 결과물을 구분합니다. 하나만 읽는 것이 가장 흔한 실수입니다 — video-composition.md는 에이전트가 건너뛰는 바로 그 파일이며, 평평하고 중앙 정렬된 웹 페이지 같은 출력을 방지하는 파일입니다. 팔레트를 자체적으로 발명하고 이를 건너뛰지 마세요; hyperframes-creative로 들어가는 것은 선택적 분기가 아니라 필수입니다. 거기에서 필요에 따라 명명된 스타일/무드 → references/visual-styles.md 또는 대화형 선택기 → references/design-picker.md를 가져오세요. 스펙/스타일은 브랜드를 정의하며, 구성 규칙이 아닙니다.

각도 찾기 (모호한 브리프, 스펙 없음): 색상을 고르기 전에 한 문장을 작성하세요 — 이 이름/단어/주제는 무엇을 연상시키며, 어떤 시각적 세계(은유, 설정, 악기, 모티프)가 이를 표현합니까? 예: 사이버보안 도구 → 금고 문 / 경계 스캔 라인 / 자물쇠 텀블러; 명상 앱 → 조수, 호흡, 느린 빛 확산. 주제의 _의미_를 읽고, 문자 그대로가 아닌 구체적인 각도를 고르세요; 이는 단일 장면 작품에서 올바르게 생략되는 프롬프트 확장(2단계)에 대한 저렴한 대체물이며, 디자인된 개념과 그라데이션 위의 일반 로고를 구분하는 요소입니다.

<하드-게이트> 어떤 구성 HTML을 작성하기 전에, 다음 네 가지를 모두 확인했는지 검증하세요:

  1. 시각적 아이덴티티 — 스펙이나 house-style.md에 기반하며, 즉석에서 발명된 것이 아닙니다. (#333, #3b82f6, 또는 Roboto를 사용하고 계신가요? 건너뛴 것입니다.)
  2. 한 문장 개념 각도 ("각도 찾기" 단계) — 사소한 편집 이상의 모든 것에 대해, 프롬프트 단어의 문자 그대로의 재구성이 아닙니다.
  3. 임베드 목록의 글꼴 페어링 (hyperframes-creative/references/typography.md → "임베드된 글꼴") — 의도적으로 선택되었으며, 기본적으로 Inter/Helvetica Neue/system-ui가 아니며, 로컬에서 자동 캡처되길 바라며 임베드되지 않은 디스플레이 글꼴을 사용하지 마십시오(번들되지 않은 이름은 로컬에서 자동 캡처될 경우에만 임베드되며, 클라우드 렌더는 이를 캡처하지 않습니다).
  4. video-composition.md의 전경/밀도 계획 — 가장자리 앵커, 8-10개 요소, 전경 메타데이터, 배경 텍스처 규칙. (평평한 색상 위에 ~6개 미만의 요소와 가장자리 앵커 세부 사항이 없는 중앙 스택? 건너뛴 것입니다 — 그것이 일반적인 신호입니다.) </하드-게이트>

2단계 — 프롬프트 확장 → hyperframes-creative

모든 다중 장면 구성에 대해 실행합니다(단일 장면 작품 및 사소한 편집은 건너뜁니다). 요청을 디자인 스펙 + 하우스 스타일에 맞춰 일관된 중간 표현으로 변환하여 다운스트림 작업이 동일한 방식으로 읽도록 합니다. hyperframes-creative/references/prompt-expansion.md를 참조하세요.

3단계 — 계획

HTML을 작성하기 전에 높은 수준에서 생각하세요:

  1. 무엇 — 시청자 경험: 내러티브 아크, 주요 순간, 감정적 비트.
  2. 구조 — 몇 개의 구성, 하위 구성 대 인라인, 어떤 트랙이 비디오 / 오디오 / 오버레이 / 자막을 전달하는지. 모놀리식 단일 파일 대 모듈식 하위 구성 결정에 대해서는 hyperframes-core/references/composition-patterns.md § 두 가지 아키텍처(경험 법칙: ≥3개의 하드 장면 컷, 또는 재사용되는 장면 → 모듈화; 짧은 단일 장면 작품은 하나의 파일 유지)를 참조하세요.
  3. 리듬 — 구현하기 전에 패턴 이름을 지정하세요 (예: fast-fast-SLOW-SHADER-hold); hyperframes-creative/references/beat-direction.md를 참조하세요.
  4. 타이밍 — 어떤 클립이 지속 시간을 결정하고, 전환이 어디에 위치하며, 페이싱은 어떻게 되는지.
  5. 레이아웃 — 먼저 최종 상태를 구축하세요 (아래 참조).
  6. 애니메이션 — 그런 다음 hyperframes-animation을 통해 모션을 추가하세요.

애니메이션 전 레이아웃

모든 요소가 가장 눈에 띄는 순간에 위치하는 곳에 배치하세요 — 완전히 진입하고, 올바르게 배치되었으며, 아직 나가지 않은 상태. 이를 정적 HTML + CSS로 먼저 작성하세요. 아직 GSAP는 사용하지 마세요.

이유: 요소를 애니메이션 시작 상태(화면 밖, 0으로 축소, 투명도 0)에 배치하고 도착할 위치로 트윈하면 최종 레이아웃을 추측하는 것이며, 겹침은 렌더링될 때까지 보이지 않습니다. 먼저 최종 상태를 구축하면 모션을 추가하기 전에 레이아웃 문제를 보고 수정할 수 있습니다.

  1. 각 장면의 히어로 프레임을 식별하세요 — 가장 많은 요소가 동시에 보이는 순간. 그것이 구축할 레이아웃입니다.
  2. 해당 프레임에 대한 정적 CSS를 작성하세요. 콘텐츠 컨테이너는 절대 오프셋이 아닌 패딩으로 장면을 채워야 합니다:
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px; /* 패딩이 콘텐츠를 배치합니다; 모든 장면 크기를 채웁니다 */
  gap: 24px;
  box-sizing: border-box;
}

콘텐츠 컨테이너에 position: absolute; top: Npx를 절대 사용하지 마세요 — 콘텐츠가 공간보다 높을 때 넘칩니다. 절대 위치 지정은 장식용으로만 예약하세요.

⚠ 위의 width/height: 100%는 모든 상위 요소가 결정된 높이를 가질 때만 해결됩니다. 루트 <div data-composition-id>와 그와 .scene-content 사이의 모든 래퍼는 크기가 지정되어야 합니다(루트에 position: relative; width: 1920px; height: 1080px — hyperframes-core → "루트는 크기가 지정되어야 함" 참조). 이를 건너뛰면 플렉스 컨테이너가 ~0으로 축소되고, 콘텐츠가 왼쪽 상단 모서리에 쌓이며, 첫 번째 글리프가 x=0에서 잘립니다 — 반면 lint/inspect는 여전히 0개의 문제를 보고합니다. 그리고 항상 .scene-content에 padding(≥80px)을 유지하세요: 이것은 타이틀-안전 여백입니다. 절대 이를 단순 gap으로 대체하지 마세요.

  1. 진입 추가 — CSS 위치로 화면 밖/보이지 않는 곳에서 FROM 애니메이션을 gsap.from()으로 추가합니다(하위 구성에서는 gsap.fromTo()를 선호하여 시작 상태를 명시적으로 지정; hyperframes-core/references/sub-compositions.md 참조). CSS 위치가 기본 진실이며; 트윈은 그곳으로의 여정입니다.
  2. 종료는 전환으로 처리 — hyperframes-animation/transitions/의 장면 전환 규칙에 따라, 마지막 장면만 요소를 애니메이션 아웃합니다; 장면 사이에서는 전환 자체가 종료입니다.

시간에 따른 공유 공간: 요소 A가 요소 B가 같은 영역에 진입하기 전에 종료되면, 둘 다 각각의 히어로 프레임에 대해 올바른 CSS 위치가 필요합니다 — 타임라인 순서가 공존을 방지하며, 레이아웃 단계가 의도치 않은 겹침을 잡습니다. 계층화된 글로우/섀도우 및 z-스택 깊이는 의도적인 겹침입니다; 이 단계는 의도하지 않은 충돌(두 개의 헤드라인이 서로 위에 있음, 콘텐츠가 프레임 밖으로 흘러나감)을 잡기 위한 것입니다.

빌드 — 도메인 스킬에 위임

다음은 스킬의 전체 표면(설명 참조)을 참조에 매핑합니다 — 완전하지 않음; 의도가 나열되지 않은 경우 hyperframes-creative(룩/컨셉), hyperframes-animation(모션), hyperframes-core(계약), hyperframes-media(오디오/자막)를 통해 라우팅하세요. 첫 번째 행은 추가적입니다 — 의도 행과 함께 읽고, 둘 중 하나만 읽지 마세요.

구축하는…먼저 읽을 것 (순서대로)
항상 — 모든 중요하지 않은 작품, 아래 의도 행 위에 추가로hyperframes-creative/references/house-style.md + references/video-composition.md (1단계 / 하드-게이트에서도 게이트됨; "제작된, 생성되지 않은" 전경 세부 묘사)
운동 타이포그래피 / 텍스트 중심hyperframes-animation/techniques.md (운동 타입) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md
타이틀 카드 / 하단 1/3 / 오버레이 / PiP / 텍스트-뒤-피사체hyperframes-creative/references/composition-patterns.md + (중앙/크기 조정 프레임의 경우) hyperframes-core → "루트는 크기가 지정되어야 함"
로고 / 브랜드 마크 공개hyperframes-animation/rules/svg-path-draw.md (그리기-온) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md
데이터 / 통계 / 숫자hyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md
제품 / 앱 / UI 데모hyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md
오디오 반응형 / 음악 기반hyperframes-creative/references/audio-reactive.md (사전 밴드 추출; 모션에 매핑)
해설 / 음성 오버 / 음악 / SFX / 자막hyperframes-media → 공유 오디오 엔진 scripts/audio.mjs (한 번 호출 = TTS + BGM + SFX → audio_meta.json); 자막 작성 + 에셋 배치는 hyperframes-core를 통해. 아래 오디오를 참조하세요.
다중 장면 / 전환hyperframes-animation/transitions/overview.md 그런 다음 transitions/catalog.md (개요 이후 끝난 것이 아닙니다 — GSAP 레시피는 카탈로그에 있습니다)
모듈식 / 하위 구성hyperframes-core/references/composition-patterns.md + references/sub-compositions.md

오디오: 하나의 엔진 (TTS · BGM · SFX)

작품이 요구할 때만 ("요청된 대로만 정확히 빌드" — 타이틀 카드에 배경 음악 없음). TTS를 수동으로 만들거나 사본을 공급하지 마세요: 중립적인 audio_request.json을 작성하고 hyperframes-media에서 공유 엔진을 호출하세요. 하나의 스위치에서 자동으로 저하됩니다 — HeyGen 자격 증명 있음 → HeyGen TTS + 음악/SFX 검색; 없음 → ElevenLabs/Kokoro TTS, Lyria/MusicGen BGM 생성 및 번들 SFX 라이브러리. 전체 플래그 목록 + 요청/메타 스키마: hyperframes-media/scripts/audio.mjs의 헤더 주석.

// audio_request.json — 해설 세그먼트당 한 줄; `id`는 사용자 것이며 (audio_meta를 다시 연결)
{
  "lines": [
    { "id": "s1", "text": "당신의 오프닝 라인.", "sfx": ["whoosh"] },
    { "id": "s2", "text": "다음 비트." },
  ],
  "bgm": { "query": "차분한 시네마틱 언더스코어" }, // "mode" 생략 → 자동 (HeyGen이면 검색, 아니면 생성); 비활성화하려면 "none"
}
# <MEDIA_DIR> = 설치된 hyperframes-media 스킬 디렉토리 (이 스킬의 형제)
node <MEDIA_DIR>/scripts/audio.mjs --request ./audio_request.json --hyperframes . --out ./audio_meta.json

그런 다음 audio_meta.json을 읽으세요: 각 voices[].path + (bgm.path, sfx[])를 <audio> 트랙으로 마운트하고 voices[].words를 자막에 사용하세요. 모든 것은 hyperframes-core(오디오 트랙 + 자막 작성)에 따릅니다. BGM이 생성 경로를 취한 경우 (bgm_pending: true), 최종 렌더 전에 hyperframes-media/scripts/wait-bgm.mjs를 실행하세요.

출력 체크리스트 → hyperframes-cli

  • …

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

lzcjsyr/Book2Video

将 PDF、EPUB、DOCX 等书籍或长文档一次性转成约 4 分钟的中文读书带货短视频口播稿,以情绪共鸣、观看留存和购买欲为核心,直接输出 Book2Video 后续流程可读取的 raw JSON。用户提到读书带货、图书推广、卖书口播、商品卡、走心书单视频、情绪型读书文案或要求生成可直接进入视频流水线的带货稿时使用。

lzcjsyr/Book2Video

将长书、长文档转成中文视频号读书解说稿;先抽取文本并建立可恢复覆盖台账,覆盖自检通过后再按入口定义的正文长度生成初稿、多轮修订和最终 raw JSON。

lzcjsyr/Book2Video

将长书、长文档、PDF、EPUB、读书资料、思想经典、社科著作、商业书或研究型长文转成更有传播感的中文视频号/抖音读书口播稿,并输出项目可用的 raw JSON。只要用户提到“读书解说”“拆书稿”“视频号口播”“把这本书做成短视频”“长文档转视频脚本”“生成标题/封面/金句/raw JSON”,都应使用此 skill。

lzcjsyr/Book2Video

Cody的公众号长文写作skill。当用户需要撰写公众号文章、写稿子、续写文章、根据素材产出长文时使用。触发词包括但不限于:写文章、写稿子、帮我写、续写、扩写、公众号文章、长文、出稿、按我的风格写。即使用户只是说"帮我把这个写成文章"或"用我的风格写一下",只要上下文涉及内容创作和公众号输出,都应该触发。也适用于用户丢过来一个PDF、brief、新闻链接、语音转文字或任何素材说"帮我写篇文章"的场景。不要用于短内容(小红书帖子、推特、朋友圈)或纯标题摘要生成。

lzcjsyr/Book2Video

将中短篇专业报告、公司财报、券商研报、招股书、宏观经济分析及含有较多表格和数据的PDF文档,转化为高品质、数据精准的中文视频号/抖音口播解说稿。只要用户提到“研报”、“财报”、“商业分析报告”或需要“解读数据”、“把报告/PDF做成短视频”,务必使用此 Skill。

lzcjsyr/Book2Video

简化版的文稿生成技能。能够直接读取图书/文档,提取核心论点,生成高品质、口语化的视频号/抖音读书解说文稿并输出标准 JSON 格式。

관련 스킬