플러그인 설치: 설정 또는 신선도 유지 명령 전, 이 스킬이 HyperFrames 플러그인 내부에 있을 때는 플러그인 실행 규칙을 따르세요. 독립 설치 시에는 아래 업데이트 지침을 유지합니다.
먼저, 이 스킬을 최신 상태로 유지하세요 — 실행 전에 사용자 확인:
npx hyperframes skills update product-launch-video. 모든 것이 최신 상태이면 빠르게 아무 작업도 하지 않습니다. 그렇지 않으면 이 스킬과 이 스킬이 의존하는 핵심 도메인 스킬을 새로 고칩니다.
media-use: 오디오/이미지/로고를 가져오기 전에
/media-use를 호출하여 HeyGen 카탈로그의 BGM/SFX/이미지와 공식 소스의 브랜드 로고를 확인하세요. 기존 자산을 등록하려면 먼저--adopt를 실행하세요./media-use스킬을 참조하세요.
figma 소스: 소스가 figma.com URL인 경우 먼저
/figma를 실행하세요 — 자산 내보내기, 브랜드 토큰, 필요한 경우 컴포넌트/스토리보드 재구성 — 그런 다음 이 워크플로우를 그 출력에서 빌드하세요. 원시 MCP 도구를 통해 직접 Figma를 제어하지 마세요. SVG 정리,.media/manifest.jsonl출처 추적, 브랜드 토큰var()바인딩을 건너뛰므로, 이후 브랜드 변경 시 전체 재가져오기 없이 전파할 수 없습니다.
제품 출시 to HyperFrames
이 스킬을 사용하여 제품을 캡처하고, 브랜드를 이해하며, 출시 비디오를 계획하고, HyperFrames에서 프레임별로 비디오를 제작하세요.
진입점은
/hyperframes입니다. 당신은 오케스트레이터입니다. 각 단계를 실행하고, 게이트를 확인한 후에만 다음 단계로 진행하세요. 이 스킬은 마케팅, 출시, 홍보 또는 공개되는 제품을 위한 것입니다. 목적이 판촉인 경우 "저희 사이트 홍보"와 같은 요청도 포함됩니다. 사이트 투어/쇼케이스 요청도 여기에 머뭅니다:BRIEF.md는 '그대로 보여주기' 의도를 담고 있으며, 캡처된 스크린샷은 비디오가 보여주는 자산이 됩니다. 다른 모든 의도, 맨 "비디오 만들어줘", 또는 불확실한 경우 → 먼저/hyperframes를 읽으세요 — 의도 레이어가 모든 경로 결정을 소유하며,BRIEF.md없이 여기에 도착한 새로운 생성 요청은 어차피 그것을 거칩니다(설정의 시작 규칙).
당신은 오케스트레이터입니다. videos/<project>/ 디렉토리에서 작업하세요. 단계를 순서대로 실행하고 각 게이트를 통과한 후에 계속 진행하세요. 사용자 게이트 단계는 Step 0, Step 3, Step 6입니다. Step 0 전에 ../hyperframes/references/brief-contract.md를 읽으세요 — 게이트 유형과 BRIEF.md의 flow/storyboard가 Step 3/4/6 게이트를 관장하는 모드를 어떻게 파생하는지 정의합니다. Step 5를 제외한 모든 단계를 직접 수행하세요. Step 5에서는 프레임당 하나의 하위 에이전트를 파견합니다. 디자인 또는 모션 규칙을 여기에 넣지 마세요. 그것들은 프레임 워커 하위 에이전트, 이 스킬의 로컬 ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/, 그리고 hyperframes-creative에 있습니다.
워크플로우: Step 0 설정 -> hyperframes.json; Step 1 캡처 -> capture/; Step 2 디자인 시스템 -> frame.md; Step 3 스토리보드/스크립트 -> STORYBOARD.md 및 SCRIPT.md; Step 3.1 오디오 -> audio_meta.json; Step 4 비주얼 디자인 -> 강화된 STORYBOARD.md; Step 5 프레임 -> compositions/frames/NN-*.html 및 index.html; Step 6 최종 렌더링 -> renders/video.mp4.
Step 0: 설정
목표: 확인된 브리프로 시작하고, HyperFrames 프로젝트를 생성하며, 브리프를 지속 가능하게 만듭니다.
브리프는 여기서 질문하는 것이 아니라 의도 레이어에 의해 확정됩니다. 시작 규칙, 순서대로: (1) BRIEF.md가 존재함 → 읽고 아무것도 묻지 않음 — 브리프가 확정되었으며, 그 flow/storyboard가 모드를 파생합니다(브리프 계약 § 1). (2) BRIEF.md는 없지만 프로젝트가 존재함(hyperframes.json / STORYBOARD.md가 디스크에 있음) → 스토리보드의 프론트매터와 기록된 선호도에서 재개합니다. 절반쯤 만든 프로젝트를 다시 질문하지 마십시오. (3) 둘 다 아님 — 직접 여기에 도착한 새로운 생성 요청 → /hyperframes를 읽고 의도 레이어(references/intent-interview.md)를 실행합니다. 레시피와 기억된 기본값을 확인하고, 이 경로의 질문(../hyperframes/references/routes/product-launch-video.md)을 수행하며, 잠긴 브리프를 반환합니다. 편집 요청은 이 모든 것을 건너뜁니다 — 편집을 진행하세요.
hyperframes.json이 없는 경우에만 초기화하세요. <project>는 브랜드 또는 도메인에서 케밥 케이스(kebab-case)로 지정하세요(예: acme-promo). 워크스페이스 이름이나 타임스탬프를 사용하지 마세요.
npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=product-launch-video — init은 설치된 스킬을 GitHub의 최신 버전과 비교하고, 오래된 경우 전역 세트를 업데이트합니다.
초기화 후, <PROJECT_ROOT>를 videos/<project>로 설정하고 이후 모든 상대 경로 명령을 해당 디렉토리를 작업 디렉토리로 사용하여 실행하세요. 아래 명령에서 .는 <PROJECT_ROOT>를 의미합니다. .media, capture 또는 출력 파일을 호출자 디렉토리에 절대 쓰지 마십시오.
초기화 직후 BRIEF.md를 작성하세요(절대 그 이전에 — init은 비어 있지 않은 디렉토리를 거부합니다): 의도 레이어의 잠긴 브리프, 형태는 ../hyperframes/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를 프로젝트에 복사하고(Step 2는 건너뜀) Step 3 초안이 작성할 뼈대를 반환합니다. 레시피는 답변을 채우지만 승인은 채우지 않습니다. 검토 게이트는 여전히 실행됩니다.
설정을 지나기 전에 로그인 상태를 표시하세요 — npx hyperframes auth status를 실행하고 출력을 그대로 전달합니다. HeyGen을 사용할지 로컬 엔진을 사용할지 음성/BGM을 보고하며, 로그아웃된 경우 로그인 방법을 알려줍니다. 종료 코드 계약에 유의하세요: auth status는 로그인되지 않은 경우 종료 코드 1로 종료합니다(저장된 자격 증명이 거부된 경우도 포함) — 0이 아닌 종료는 정상적인 로그아웃 상태이며 명령 실패가 아니므로 오류로 처리하지 말고, 재시도하지 말며, 워크플로우를 중단시킬 수 있는 &&/set -e로 연결하지 마십시오. 다음 분기를 적용하세요:
- 협업: 사용자가 로그인하거나 명시적으로
offline/go를 선택할 때까지 기다립니다. - 자율: 상태를 알리고 사용 가능한 로컬 엔진으로 계속 진행합니다.
오프라인 공급자가 없을 때 필요한 기능을 조용히 생략하지 마십시오. 장애물을 표면화하십시오. 이 결정을 다른 질문에 포함시키거나 키를 저장소별 .env에 쓰지 마십시오. 인증 소유권 및 오프라인 대체: /media-use references/setup-providers.md § Providers.
게이트: hyperframes.json 및 BRIEF.md가 존재합니다. 선호도 기반 답변이 기록되었습니다(브리프 계약 § 2). 로그인 상태가 표시되었습니다(로그인됨 또는 오프라인 계속).
Step 1: 자산 캡처
목표: 비디오를 위한 소스 자료, 브랜드 신호, 사용 가능한 자산을 수집합니다.
입력을 분류하고 경로를 선택하세요. 명시적 URL -> 캡처하고 사이트를 내레이션 및 자산에 사용합니다. 붙여넣은 스크립트/브리프 -> user_script.txt로 그대로 저장합니다. VO_MODE(그대로 또는 재구성)는 BRIEF.md에서 가져옵니다 — 의도 레이어가 스크립트가 도착할 때 묻습니다(브리프에 없는 경우에만 여기서 한 번 묻습니다). 그런 다음 캡처 대상을 확인합니다. 텍스트의 URL -> 사용합니다. 브랜드 이름만 -> WebSearch, 한 줄로 URL을 확인한 다음 크롤링합니다. URL/사이트가 없거나(또는 브리프가 스크래핑을 금지하는 경우) 캡처하지 않는 경로입니다.
캡처 실행: npx hyperframes capture "<URL>" -o ./capture --json. 호출자가 더 작은 마감일을 소유하지 않는 한 기본 탐색 후 예산을 유지하십시오. 그렇지 않으면 다운스트림 작업을 위한 시간을 남기는 양수 --capture-budget <milliseconds>를 전달하십시오. --timeout은 페이지 탐색만 제어합니다. 선택적 이미지 캡셔닝을 의도적으로 비활성화하는 경우에만 --skip-vision을 사용하십시오.
명령 결과와 출력 디렉토리를 즉시 검사하십시오. 0이 아닌 종료, JSON ok: false 또는 capture/BLOCKED.md는 캡처 경로에 대한 하드 중지입니다. 기록된 이유를 보고하고 부분 스크린샷, DOM, 토큰 또는 자산을 소비하지 마십시오. 실패한 URL 캡처 후 합성된 캡처 없는 대체를 만들어 내지 마십시오. 원래 브리프가 소스 자료를 제공했거나 사용자가 실패 후 제공된 스크린샷 또는 브리프로 명시적으로 전환한 경우에만 캡처하지 않는 경로를 계속 진행하십시오.
매우 적은 텍스트 콘텐츠와 같은 경고와 빈 자산 카탈로그는 사용 가능한 페이지의 증거가 아닙니다. 사이트 투어 또는 '그대로 보여주기' 브리프의 경우 신뢰할 수 있는 캡처된 구조 또는 제공된 스크린샷이 필요합니다. 둘 다 없으면 중지하십시오. 캡처를 사용할 수 없다는 이유만으로 페이지를 발명하거나 재구축하지 마십시오.
사이트 투어 또는 '그대로 보여주기' 브리프의 경우 캡처된 페이지가 시각적 진실의 원천입니다. 전체 웹사이트를 HTML로 재구축하는 대신 실제 스크린샷을 사용하십시오. 샷에 내부 움직임이 필요한 경우 스크린샷을 베이스로 유지하고 측정된 위치에 실제 캡처된 자산을 오버레이하거나 움직이는 하나의 구성 요소만 재구축하십시오. 스크롤 샷의 경우 전체 문서의 1x 플레이트인 capture/screenshots/full-page.png 위로 뷰포트를 애니메이션화하십시오. 페이지가 한 조각으로 캡처하기에는 너무 긴 경우 누락됩니다. 동일한 디렉토리에 있는 겹치는 스크롤 위치 샷으로 대체하십시오. 1:1 이상으로 확대하려면 해당 영역의 자체 2x 캡처가 필요합니다. 사용자가 명시적으로 양식화된 해석을 요청한 경우에만 전체 페이지를 다시 만드십시오. 사용할 수 없는 캡처만으로는 권한이 아닙니다.
GEMINI_API_KEY, GOOGLE_API_KEY 또는 OpenRouter 키가 있는 경우 캡처는 자산을 capture/extracted/asset-descriptions.md에 자동 캡션합니다. 이것은 검토 게이트가 아닙니다. 비전 키 없이 DOM 컨텍스트를 사용하고 계속 진행하십시오.
캡처하지 않는 경로: capture/extracted/tokens.json, capture/extracted/visible-text.txt, capture/extracted/asset-descriptions.md 및 capture/assets/를 수동으로 만드십시오. tokens.json은 { "title": "", "description": "", "colors": [], "fonts": [] }여야 합니다. 가능하면 브리프에서 제목/설명을 채우십시오. visible-text.txt에는 전체 브리프 또는 스크립트가 포함됩니다. asset-descriptions.md에는 사용자가 자산 노트를 제공하지 않는 한 캡처된 자산이 없다고 명시해야 합니다.
게이트: 캡처 JSON이 ok: true를 보고했습니다. capture/BLOCKED.md가 존재하지 않습니다. capture/extracted/tokens.json, capture/extracted/visible-text.txt, capture/extracted/asset-descriptions.md 및 capture/assets/가 존재합니다. 한 문장으로 브랜드를 명확히 말할 수 있습니다. asset-descriptions.md를 주요 자산 인벤토리로 취급하십시오. 실제 캡처 후에 누락된 경우 중지하고 캡처가 불완전하다고 보고하십시오. 선택적 단계의 성능 저하에 대한 경고는 이 구조적 게이트가 여전히 통과하는 경우에만 허용됩니다.
Step 2: 디자인 시스템
목표: 하나의 제공된 프레임 프리셋을 선택합니다. 스크립트가 이 비디오의 frame.md + 캡션 스킨으로 변환합니다.
BRIEF.md가 style_preset을 지정하는 경우 — 사용자가 의도 레이어의 쇼케이스에서 눈으로 선택한 것 — 그것을 사용하십시오. 브리프가 없는 경우에만 판단 호출이 귀하에게 있습니다. 그런 다음 한 가지 호출을 내립니다 — 어떤 프리셋을 사용할지: ../hyperframes-creative/references/design-spec.md를 읽고 브랜드와 브리프에 가장 잘 맞는 프리셋을 선택하십시오. 그런 다음 실행하십시오:
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(예: 캡처 없음) -> 스크립트는 프리셋 자체 팔레트, 완전한 출시 가능한 디자인을 유지합니다. 브리프가 캡처에서 누락된 브랜드 색상/글꼴을 지정하는 경우 실행하기 전에 capture/extracted/tokens.json에 추가하거나(또는 사용자의 design.md를 사용하여 채움) 매핑이 실제로 필요한 경우에만 사후에 frame.md를 수동으로 조정하십시오.
게이트: build-frame.mjs가 종료 코드 0으로 종료되었습니다. frame.md가 명명된 프리셋에서 존재합니다. (프리셋이 제공하는 경우) .hyperframes/caption-skin.html이 캡션 스킨 소스로 존재합니다. 선택한 프리셋이 선호도로 기록되었습니다(--key style_preset --workflow <this workflow>, 브리프 계약 § 2).
Step 3: 스토리보드 및 스크립트
목표: 브리프와 캡처된 자료를 승인된 프레임별 스토리 계획으로 전환합니다.
../hyperframes-creative/references/story-spine.md(후크 언어, 증거 이전 가치, 제안으로서의 스토리보드, 출처 추적 가능한 비주얼), references/story-design.md, ../hyperframes-animation/blueprints-index.md, ../hyperframes/references/storyboard-format.md 및 ../hyperframes/references/script-format.md를 읽으십시오. 이를 사용하여 STORYBOARD.md와 내레이션이 필요할 때 SCRIPT.md를 작성하십시오. BRIEF.md의 length에서 프론트매터 duration:을 설정하십시오. 편집이 그에 대해 어디에 도달하는지 어셈블리가 보고하는 대략적인 예상입니다.
스토리 청사진, 후크, 설득 논리, 비트(beats), VO_MODE 및 자산 선택을 위해 story-design.md를 사용하십시오. 소프트 가이드로서 ../hyperframes-animation/blueprints-index.md에서 역할→청사진 메뉴를 참조하십시오. 각 비트에 대해 적합한 청사진 ID를 하나 기록하십시오. 스토리 진실이 어떤 비트가 존재하는지 결정합니다. 청사진에 맞추기 위해 비트를 강제하지 말고, 입증된 형태를 사용할 수 있다고 해서 비트를 발명하지 마십시오. 각 시각적 프레임의 asset_candidates를 capture/extracted/asset-descriptions.md(정식 인벤토리)에서 선택하십시오. 원시 capture/assets/를 검색하지 마십시오. 해당 인벤토리가 없거나 사용할 수 없는 경우가 아니면 사용자에게 자산을 선택하도록 요청하지 마십시오. 스토리보드 및 스크립트 참조의 정확한 필수 필드를 사용하십시오.
초안 작성 후, 검토 루프의 계획 패스를 실행하십시오 — ../hyperframes/references/review-loop.md § 1: 계획을 제안서로 제시하고 두 가지 질문을 하십시오 — 승인 또는 변경, 그리고 스케치 먼저(권장) 또는 건너뛰기. 피드백은 채팅 답변으로 도착합니다. 승인될 때까지 반복하십시오. 이것은 체크포인트 게이트입니다(브리프 계약 § 1): 자율 모드에서는...