먼저, 이 스킬을 최신 상태로 유지하세요 — 자동으로 실행되며 묻지 않습니다:
npx hyperframes skills update faceless-explainer. 모든 것이 최신 상태일 때는 빠르게 완료되고 아무 변화가 없습니다. 그렇지 않으면 이 스킬과 이에 의존하는 핵심 도메인 스킬들을 새로 고칩니다.
미디어 사용: 오디오/이미지/로고를 소싱하기 전에
/media-use를 호출하여 HeyGen 카탈로그의 BGM/SFX/이미지와 공식 소스의 브랜드 로고를 확인합니다. 기존 자산을 등록하려면 먼저--adopt를 실행하세요./media-use스킬을 참조하세요.
페이스리스 설명 영상 제작 (HyperFrames)
이 스킬을 사용하여 텍스트 본문을 설명 영상으로 만듭니다: 디자인 시스템을 선택하고, 교훈적인 스토리를 기획한 후, HyperFrames에서 프레임별로 제작합니다. 페이스리스란 모든 시각적 요소가 다운스트림에서 창작된다는 뜻입니다 — 캡처 단계나 실제 자산 인벤토리가 없습니다.
진입점은
/hyperframes입니다. 당신은 오케스트레이터입니다. 각 단계를 실행하고, 각 게이트를 확인한 후에만 계속 진행하십시오. 이 스킬은 제품이나 캡처할 웹사이트 없이 텍스트로 주제를 설명하는 용도입니다. 다른 의도, 단순히 "영상 만들어줘" 같은 요청, 또는 불확실한 경우 → 먼저/hyperframes를 읽으십시오 — 의도 레이어가 모든 경로 결정을 담당하며, 여기에BRIEF.md없이 새로 생성된 요청은 어차피 그 레이어를 거치게 됩니다(설정의 첫 번째 규칙).
당신은 오케스트레이터입니다. videos/<project>/ 디렉토리에서 작업합니다. 단계를 순서대로 실행하고 각 게이트를 통과한 후에만 계속 진행하십시오. 사용자 게이트 단계는 0단계, 3단계, 6단계입니다. 0단계 전에 ../hyperframes-core/references/brief-contract.md 를 읽으십시오 — 게이트 유형과 BRIEF.md 의 flow/storyboard 가 3/4/6단계 게이트를 제어하는 모드를 어떻게 도출하는지 정의합니다. 5단계를 제외한 모든 단계를 직접 수행하십시오(5단계에서는 프레임당 하나의 하위 에이전트를 파견합니다). 디자인 또는 모션 규칙을 여기에 두지 마십시오. 이는 프레임 워커 하위 에이전트, 이 스킬의 로컬 ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/, 그리고 hyperframes-creative 에 있습니다.
워크플로우: 0단계 설정 → hyperframes.json; 1단계 개요 → capture/extracted/; 2단계 디자인 시스템 → frame.md; 3단계 스토리보드/스크립트 → STORYBOARD.md 및 SCRIPT.md; 3.1단계 오디오 → audio_meta.json; 4단계 시각 디자인 → 보강된 STORYBOARD.md; 5단계 프레임 → compositions/frames/NN-*.html 및 index.html; 6단계 최종 렌더링 → renders/video.mp4.
0단계: 설정
목표: 확정된 개요와 함께 진입하고, HyperFrames 프로젝트를 생성하며, 개요를 영구적으로 만듭니다.
개요는 여기서 질문하는 것이 아니라 의도 레이어에 의해 확정됩니다. 순서대로 적용되는 첫 번째 규칙: (1) BRIEF.md 가 존재함 → 읽고 아무것도 묻지 마십시오 — 개요는 확정되었으며, 그 flow/storyboard 가 모드를 도출합니다(개요 계약서 § 1). (2) BRIEF.md 는 없지만 프로젝트가 존재함(hyperframes.json / STORYBOARD.md 가 디스크에 있음) → 스토리보드의 머리말과 기록된 기본 설정에서 재개하십시오; 절반쯤 완성된 프로젝트를 다시 조사하지 마십시오. (3) 둘 다 없음 — 직접 여기에 도착한 새로운 생성 요청 → /hyperframes 를 읽고 그 의도 레이어(references/intent-interview.md)를 실행하십시오: 레시피와 기억된 기본값을 확인하고, 이 경로의 질문(../hyperframes/references/routes/faceless-explainer.md)을 수행한 후, 잠긴 개요를 반환합니다. 수정 요청은 이 모든 것을 건너뛰십시오 — 수정을 수행하십시오.
hyperframes.json 이 없을 때만 초기화하십시오. <project> 이름은 주제를 케밥-케이스로 지정하십시오(예: compound-interest-explained); 워크스페이스 이름이나 타임스탬프를 사용하지 마십시오.
npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=faceless-explainer — init 은 설치된 스킬을 GitHub의 최신 버전과 비교하여 업데이트가 필요한 경우 전역 세트를 업데이트합니다.
초기화 후, <PROJECT_ROOT> 를 videos/<project> 로 설정하고 모든 후속 상대 경로 명령을 해당 디렉토리를 작업 디렉토리로 하여 실행하십시오. 아래 명령에서 . 은 <PROJECT_ROOT> 를 의미합니다; 호출자 디렉토리에 .media, capture, 또는 출력 파일을 절대 쓰지 마십시오.
초기화 직후 BRIEF.md 를 작성하십시오(절대 그 전에 작성하지 마십시오 — init 은 비어 있지 않은 디렉토리를 거부합니다): 의도 레이어의 잠긴 개요, 형태는 ../hyperframes-core/references/brief-format.md 를 따릅니다. <MEDIA_DIR> 을 설치된 /media-use 스킬 디렉토리로 확인하십시오. 그런 다음 각 환경 설정 기반 답변을 node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes . 로 기록하십시오(brief-format.md 가 하위 집합을 명명합니다). 의도 레이어가 레시피를 채택한 경우, node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes . --name <name> 을 실행하십시오; 이것은 frame.md 를 프로젝트에 복사하고(2단계는 건너뜁니다) 3단계 초안을 작성할 기본 뼈대를 반환합니다. 레시피는 답변을 채울 뿐, 승인을 채우지 않습니다; 검토 게이트는 여전히 실행됩니다.
설정을 진행하기 전에 로그인 상태를 표시하십시오 — npx hyperframes auth status 를 실행하고 그 출력을 그대로 전달하십시오. 음성/BGM이 HeyGen을 사용할지 로컬 엔진을 사용할지, 그리고 로그아웃 상태일 때 로그인 방법을 보고합니다. 분기 중 하나를 적용하십시오:
- 협업: 사용자가 로그인하거나 명시적으로
offline/go를 선택할 때까지 기다리십시오. - 자율: 상태를 알리고 사용 가능한 로컬 엔진을 통해 계속 진행하십시오.
오프라인 공급자가 없을 때 요구되는 기능을 조용히 생략하지 마십시오; 차단 요소를 표면화하십시오. 이 결정을 다른 질문에 포함시키거나 키를 저장소별 .env 에 쓰지 마십시오. 인증 소유권 및 오프라인 대체 기능: /media-use references/setup-providers.md § 공급자.
게이트: hyperframes.json 과 BRIEF.md 가 존재함; 환경 설정 기반 답변이 기록됨(개요 계약서 § 2); 로그인 상태가 표시됨(로그인 상태이거나 오프라인으로 계속 진행 중).
1단계: 개요 (캡처 없음)
목표: 사용자의 텍스트를 정보의 원천으로 프로젝트에 접습니다. 웹사이트 캡처나 실제 자산이 없습니다 — 이것은 페이스리스 설명 영상입니다.
사용자의 전체 입력을 그대로 저장한 다음, 합성 캡처 패키지를 수동으로 생성하십시오:
capture/extracted/visible-text.txt— 전체 기사 / 노트 / 주제 / 개요, 그대로. 이것은 정보의 원천이며, 스토리 템플릿이 아닙니다(3단계에서 재구성합니다).capture/extracted/tokens.json—{ "title": "", "description": "", "colors": [], "fonts": [] }.title/description은 개요에서 채웁니다.colors/fonts는 사용자가 명시적으로 브랜드 색상이나 글꼴을 제공하지 않는 한 비워 둡니다 — 제공한 경우 추가하십시오(디자인 사전 설정은 어차피 완전한 팔레트를 제공합니다).
사용자가 스크립트를 붙여넣거나 자신의 표현을 유지하기를 원하는 경우, 그대로 user_script.txt 로 저장하십시오; VO_MODE(그대로 또는 재구성)는 BRIEF.md 에서 옵니다 — 의도 레이어는 스크립트가 도착할 때 이를 질문합니다. 개요에 그것이 부족한 경우에만 여기서 한 번 질문하고, 3단계를 위해 답변을 저장하십시오.
npx hyperframes capture 를 실행하지 마십시오(URL이 없습니다). asset-descriptions.md 를 생성하거나 capture/assets/ 를 채우지 마십시오 — 페이스리스 시각적 요소는 4-5단계에서 창작되며 캡처되지 않습니다. 유일한 예외는 사용자가 실제 이미지를 제공한 경우, 그것을 public/<basename> 아래에 배치하고 3단계를 위해 기록해 두십시오.
게이트: capture/extracted/visible-text.txt 와 capture/extracted/tokens.json 이 존재함; 설명 영상의 주제와 대상 청중을 명확한 한 문장으로 말할 수 있어야 함.
2단계: 디자인 시스템
목표: 제공된 프레임 사전 설정 중 하나를 선택합니다; 스크립트가 이를 이 영상의 frame.md + 캡션 스킨으로 변환합니다.
BRIEF.md 가 style_preset 을 명명할 때 — 사용자가 의도 레이어에서 쇼케이스를 보고 선택한 것임 — 이를 사용하십시오; 판단 호출은 개요가 침묵할 때만 여러분의 몫입니다. 그런 다음 한 가지 결정을 내리십시오 — 어떤 사전 설정: ../hyperframes-creative/references/design-spec.md 를 읽고 ../hyperframes-creative/frame-presets/ 를 탐색하십시오; 주제, 어조, 대상 청중에 가장 잘 맞는 외관의 사전 설정을 선택하십시오. 그런 다음 실행하십시오:
node <SKILL_DIR>/scripts/build-frame.mjs --preset <name> --hyperframes .
스크립트는 나머지 작업을 결정론적으로 수행합니다: 사전 설정의 FRAME.md 를 frame.md 로 복사하고, capture/extracted/tokens.json 의 모든 브랜드 토큰에 리믹스합니다(브랜드 색상이 역할별로 사전 설정의 색상 키에 매핑되고, 사전 설정의 디스플레이 + 본문 글꼴이 브랜드의 것으로 교체됨), 사전 설정의 캡션 스킨을 .hyperframes/caption-skin.html 로 복사하고, 자체 검증합니다(매핑이 깨지면 종료 코드 1). 종료 코드 0이 나오는 즉시 진행하십시오 — 사양을 수동 편집하지 마십시오.
페이스리스 설명 영상은 일반적으로 브랜드 색상/글꼴이 없습니다(tokens.json 의 colors/fonts가 비어 있음) → 스크립트는 사전 설정의 자체 팔레트, 즉 완전한 출시 가능한 디자인을 유지합니다. 사용자가 브랜드 색상/글꼴을 명명한 경우에만 실행 전에 tokens.json 에 추가하고, 매핑이 실제로 필요한 경우에만 이후에 frame.md 를 수동으로 조정하십시오.
게이트: build-frame.mjs 가 종료 코드 0으로 종료됨 — frame.md 가 명명된 사전 설정에서 존재함, 그리고 (사전 설정이 제공하는 경우) .hyperframes/caption-skin.html 이 캡션 스킨 소스로 존재함; 선택된 사전 설정이 환경 설정으로 기록됨(--key style_preset --workflow <this workflow>, 개요 계약서 § 2).
3단계: 스토리보드 및 스크립트
목표: 텍스트를 승인된 프레임별 교습 계획으로 전환합니다.
../hyperframes-creative/references/story-spine.md(훅 언어, 증거 전 가치, 제안으로서의 스토리보드), references/story-design.md, ../hyperframes-animation/blueprints-index.md, ../hyperframes-core/references/storyboard-format.md, ../hyperframes-core/references/script-format.md 를 읽으십시오. 이들을 사용하여 STORYBOARD.md 와, 내레이션이 필요할 때 SCRIPT.md 를 작성하십시오. 머리말의 duration: 을 개요의 length 에서 설정하십시오 — 대략적인 기대치이며, 어셈블리에서 최종 결과물이 이와 어떻게 맞는지 보고합니다.
설명 영상 구조(개념 / 사용 방법 / 리스트 / 스토리), 훅 전략, 명확성 기법, 감정적 비트, 유형-열거 매핑, 그리고 VO_MODE 에 대해 story-design.md 를 사용하십시오. 영상의 순서는 내러티브 디자인에서 오며, 입력 텍스트의 단락 순서가 아닙니다 — 재정렬, 병합, 생략, 압축하십시오. 소프트 가이드로, ../hyperframes-animation/blueprints-index.md 의 역할→청사진 메뉴를 참조하십시오: 각 비트에 대해, 후보 청사진이 암시하는 형태로 내레이션을 작성하고, 적합한 청사진이 있을 때 그 후보 blueprint: ID를 태그하십시오. 교습의 진실이 여전히 어떤 비트가 존재할지를 결정합니다 — 절대 청사진에 맞추기 위해 비트를 강제하지 말고, 입증된 형태가 사용 가능하다고 해서 비트를 발명하지 마십시오. 페이스리스 시각적 요소는 다운스트림에서 창작되므로, 프레임은 자산 인벤토리를 전달하지 않습니다: 사용자가 실제 public/<basename> 이미지를 제공하지 않는 한 asset_candidates 를 비워 두십시오. 스토리보드 및 스크립트 참조의 정확한 필수 필드를 사용하십시오.
초안 작성 후, 검토 루프의 계획 패스를 실행하십시오 — ../hyperframes-core/references/review-loop.md § 1: 보드를 열고(할지 묻지 마십시오), 계획을 제안으로 제시하고, 두 가지 질문을 하십시오 — 승인 또는 변경, 그리고 스케치 우선(권장) 또는 건너뛰기. 피드백은 승인될 때까지 채팅 또는 보드의 댓글 파일을 통해 반복됩니다. 이것은 체크포인트 게이트입니다(개요 계약서 § 1): 자율 모드에서는 보드가 없고 물어볼 것도 없습니다 — 동일한 요약을 사전 알림으로 게시하고 진행하십시오; 스케치는 빌드에 통합되며, 유일한 미리보기 질문은 6단계에서 옵니다.
게이트: STORYBOARD.md 가 존재함, 모든 프레임이 필수 내러티브 필드를 가짐, 내레이션이 필요할 때 SCRIPT.md 가 존재함, 사용자가 프레임별 계획을 승인함(자율: 요약이 사전 알림으로 게시됨).
3.1단계: 오디오
목표: 승인된 스크립트에서 내레이션, 단어 타이밍, 음악 및 오디오 메타데이터를 생성합니다.
3단계 승인 후 오디오를 시작하십시오. 백그라운드에서 실행한 다음, 4단계로 계속 진행하십시오. (로그인 상태는 0단계에서 이미 표시되었습니다; 엔진은 자동으로 대체됩니다.)
호출하기 전에 사용자의 요청에서 내레이션 음성을 선택하십시오. 요청이 음성, 성별, 또는 어조를 명명한 경우, 일치하는 음성 ID를 선택하고 --voice <id> 와 함께 전달하십시오. 파이프라인 기본값은 그 외의 경우 HeyGen의 경우 Marcia (여성) / Kokoro의 경우 am_michael 입니다 — 따라서 "남성 음성"과 같은 요청은 플래그를 전달하지 않으면 자동으로 무시됩니다. 음성 ID는 공급자별로 다릅니다; 0단계의 로그인 상태가 선택한 공급자에 따라 확인하십시오: HeyGen (로그인됨)의 경우 node <MEDIA_DIR>/audio/scripts/heygen-tts.mjs --list (또는 GET /v3/voices?engine=starfish); Kokoro (오프라인)의 경우 <MEDIA_DIR>/audio/references/tts.md 의 음성 테이블(접두사 am_/bm_ 남성, af_/bf_ 여성)을 사용하십시오. 사용자가 선호도를 표현하지 않은 경우, 파이프라인 기본값보다 먼저 기억된 음성(개요 계약서 § 2)으로 대체하고 사용한 음성을 말하십시오; 둘 다 이름을 지정하지 않은 경우에만 --voice 를 생략하십시오. 사용자가 이 실행에서 명시적으로 음성을 선택한 경우, 기록하십시오(prefs.mjs record --key voice).
node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json --voice <voice-id> &
오디오 스크립트는 내레이션, 단어 타이밍, HeyGen의 음악 라이브러리에서 BGM 조회, 및 타이밍 메타데이터를 처리합니다. BGM 분위기는 스토리보드의 music: 필드에서 옵니다. 이것은 생성을 위한 것이 아니라 검색을 위해 HeyGen 오디오 API를 사용하며, TTS와 동일한 ~/.heygen 자격 증명을 사용합니다. 공급자 세부 정보는 ../media-use/audio/references/tts.md 를 읽으십시오.
내레이션이 없고 SCRIPT.md 도 없으면 음성 생성을 건너뛰십시오. 스토리보드에 음악 분위기가 있으면 BGM이 여전히 실행될 수 있습니다.
정식 완전 무음 마커(이 오디오 모델을 재사용하는 워크플로우 간에 공유됨): STORYBOARD.md 최상위 YAML 블록에 music: none 그리고 SCRIPT.md 가 없음. 이 조합은 프로젝트를 무음으로 표시합니다 — 내레이션 없음, BGM 없음, SFX 없음. audio.mjs 는 이를 인식하고 아무것도 생성하지 않습니다(오래된 audio_meta.json 을 제거합니다; audio_meta.json 이 없으면 어셈블리에서 무음으로 처리합니다). 따라서 이 단계는 완전히 건너뛰게 됩니다. music: none 과 내레이션이 함께 있으면 TTS는 유지하고 BGM만 끕니다. 이 철자를 정확히 사용하십시오 — 다른 마커를 임의로 만들지 마십시오.
게이트: 오디오 작업이 시작되었거나, 프로젝트가 무음으로 표시됨(music: none + SCRIPT.md 없음).
4단계: 프레임 시각 디자인
목표: 각 스토리보드 프레임에 시각적 방향, 레이아웃 의도 및 모션 선택을 추가합니다.
먼저 보드를 스케치하십시오(협업 전용). 계획이 승인되는 즉시 스케치 패스를 실행하십시오 — ../hyperframes-core/references/review-loop.md § 2 (3.1단계를 기다리지 마십시오; 스케치는 타이밍을 사용하지 않습니다): 모든 프레임을 와이어프레임으로 그리십시오.