먼저, 이 스킬을 최신 상태로 유지하세요 — 조용히 실행하고 묻지 마세요:
npx hyperframes skills update product-launch-video. 모든 것이 최신이면 빠른 no-op이고, 그렇지 않으면 이 스킬과 이 스킬이 의존하는 핵심 도메인 스킬을 사용하기 전에 업데이트합니다.
media-use: 오디오/이미지/로고를 소싱하기 전에
/media-use를 호출하여 HeyGen 카탈로그의 BGM/SFX/이미지와 공식 소스의 브랜드 로고를 해결하세요. 먼저--adopt를 실행하여 기존 에셋을 등록하세요./media-use스킬을 참조하세요.
figma 소스: 소스가 figma.com URL인 경우, 먼저
/figma를 실행하세요 — 에셋 내보내기, 브랜드 토큰, 필요한 경우 컴포넌트/스토리보드 재구성 — 그런 다음 이 워크플로우를 그 출력에서 빌드하세요. 원시 MCP 도구를 통해 직접 Figma를 구동하지 마세요. SVG 정리,.media/manifest.jsonl출처 증명, 브랜드 토큰var()바인딩을 건너뛰므로, 이후 브랜드 변경이 전체 재가져오기 없이는 전파될 수 없습니다.
제품 출시부터 HyperFrames까지
이 스킬을 사용하여 제품을 캡처하고, 브랜드를 이해하고, 출시 비디오를 계획하고, HyperFrames에서 프레임별로 빌드하세요.
정문은
/hyperframes입니다. 당신은 오케스트레이터입니다. 각 단계를 실행하고, 게이트를 확인한 다음에만 다음 단계로 진행하세요. 이 스킬은 마케팅, 출시, 프로모션 또는 공개되는 제품을 위한 것이며, 프로모션 목적의 "사이트 홍보"와 같은 요청을 포함합니다. 사이트 둘러보기/쇼케이스 요청도 여기에 해당합니다:BRIEF.md는 있는 그대로 보여주는 의도를 담고 있으며, 캡처된 스크린샷은 비디오가 특징으로 하는 에셋이 됩니다. 다른 의도, 단순히 "비디오 제작", 또는 불확실한 경우 → 먼저/hyperframes를 읽으세요 — 의도 레이어가 모든 경로 결정을 소유하며,BRIEF.md없이 여기에 도착한 새로운 제작 요청은 어쨌든 그것을 거칩니다(설정의 시작 규칙).
당신은 오케스트레이터입니다. videos/<project>/에서 작업하세요. 단계를 순서대로 실행하고 다음으로 진행하기 전에 각 게이트를 통과하세요. 사용자 게이트 단계는 Step 0, Step 3, Step 6입니다. Step 0 전에 ../hyperframes-core/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가 모드를 도출합니다(brief contract § 1). (2) BRIEF.md는 없지만 프로젝트가 존재함(hyperframes.json / STORYBOARD.md가 디스크에 있음) → 스토리보드의 머리말과 기록된 기본 설정에서 재개합니다; 절반만 빌드된 프로젝트를 다시 조사하지 마십시오. (3) 둘 다 없음 — 직접 여기에 도착한 새로운 제작 요청인 경우 → /hyperframes를 읽고 그 의도 레이어(references/intent-interview.md)를 실행합니다: 레시피와 기억된 기본값을 확인하고, 이 경로의 질문(../hyperframes/references/routes/product-launch-video.md)을 수행하며, 잠긴 브리핑을 반환합니다. 편집 요청은 이 모든 것을 건너뜁니다 — 편집을 수행하세요.
hyperframes.json이 누락된 경우에만 초기화합니다. 브랜드 또는 도메인에서 케밥 케이스로 <project> 이름을 지정합니다(예: 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-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를 프로젝트에 복사하고(Step 2는 건너뜀) Step 3 초안을 작성할 스켈레톤을 반환합니다. 레시피는 답변을 채우고 승인은 채우지 않습니다; 검토 게이트는 여전히 실행됩니다.
설정을 진행하기 전에 로그인 상태를 표시하십시오 — npx hyperframes auth status를 실행하고 그 출력을 그대로 전달합니다. 음성/BGM이 HeyGen을 사용할지 로컬 엔진을 사용할지, 그리고 로그아웃된 경우 로그인 방법을 보고합니다. 종료 코드 계약에 유의하십시오: auth status는 로그인되지 않은 경우 종료 코드 1을 반환합니다 (그리고 저장된 자격 증명이 거부된 경우) — 0이 아닌 종료는 정상적인 로그아웃 상태이지 명령 실패가 아니므로, 오류로 처리하지 말고 재시도하지 말며, &&/set -e로 연결하여 워크플로우를 중단시키지 마십시오. 하나의 분기를 적용합니다:
- 협업: 사용자가 로그인하거나 명시적으로
offline/go를 선택할 때까지 기다립니다. - 자율: 상태를 알리고 사용 가능한 로컬 엔진을 통해 계속합니다.
오프라인 제공자가 없을 때 필요한 기능을 조용히 생략하지 마십시오; 차단기를 표면에 드러내십시오. 이 결정을 다른 질문에 포함시키거나 per-repo .env에 키를 작성하지 마십시오. 인증 소유권 및 오프라인 대체: /media-use references/setup-providers.md § Providers.
게이트: hyperframes.json과 BRIEF.md가 존재합니다; 기본 설정 기반 답변이 기록되었습니다(brief contract § 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로 재구축하는 대신 실제 스크린샷을 사용하십시오. 샷에 내부 움직임이 필요한 경우 스크린샷을 베이스로 유지하고 측정된 위치에 실제 캡처된 에셋을 오버레이하거나, 움직이는 구성 요소 하나만 재구축하십시오. 스크롤 샷의 경우, capture/screenshots/full-page.png 위에서 뷰포트를 애니메이션화하십시오 — 전체 문서의 1x 판, 1920 너비 뷰포트가 아래로 이동하는 픽셀 정확도입니다. 페이지가 한 조각으로 캡처하기에는 너무 길면 없습니다; 같은 디렉토리의 겹치는 스크롤 위치 샷으로 대체하십시오. 1:1 이상으로 확대하려면 해당 영역의 자체 2x 캡처가 필요합니다. 판은 1x 이상의 여유가 없기 때문입니다. 사용자가 명시적으로 양식화된 해석을 요청한 경우에만 전체 페이지를 재창조하십시오; 사용할 수 없는 캡처만으로는 권한이 부여되지 않습니다.
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>, brief contract § 2).
Step 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의 역할→청사진 메뉴를 참조하십시오: 각 비트에 대해, 적합한 청사진 ID를 기록하십시오. 스토리 진실은 여전히 어떤 비트가 존재하는지 결정합니다 — 청사진에 맞추기 위해 비트를 강제로 적용하지 말고, 입증된 형태를 사용할 수 있다고 해서 비트를 발명하지 마십시오. 각 시각적 프레임의 asset_candidates를 capture/extracted/asset-descriptions.md(정식 인벤토리)에서 선택하십시오 — 원시 capture/assets/를 탐색하지 마십시오. 해당 인벤토리가 누락되었거나 사용할 수 없는 경우가 아니면 사용자에게 에셋을 선택하도록 요청하지 마십시오. 스토리보드 및 스크립트 참조의 정확한 필수 필드를 사용하십시오.
초안 작성 후, 검토 루프의 계획 통과를 실행하십시오 — ../hyperframes-core/references/review-loop.md § 1: 보드를 엽니다(열지 여부를 묻지 않음), 계획을 제안으로 제시하고, 두 가지 질문을 합니다 — 승인 또는 변경, 그리고 스케치 먼저(권장) 또는 건너뛰기. 채팅 또는 보드의 의견 파일을 통한 피드백 루프는 승인될 때까지 계속됩니다. 이것은 체크포인트 게이트입니다(brief contract § 1): 자율 모드에서는 보드가 없고 묻는 것도 없습니다 — 동일한 요약을 사전 알림으로 게시하고 진행하십시오; 스케치는 빌드로 축소되며, 하나의 미리보기 질문은 Step 6에서 나옵니다.
게이트: STORYBOARD.md가 존재하고, SCRIPT.md가 존재하며(내레이션이 필요할 때), 필요에 따라 보드 루프를 건너뛰면서 계획이 승인되었습니다.