Communitygithub.com

사이트 프로모 영화

에이전트가 '사이트 프로모 영화'(Site Promo Film)를 기획, 제작, 편집하여 완성된 동영상 결과물을 출력하는 방법을 보여줍니다. 절차는 제품 프로모 영화, 코드로 렌더링됨, 스튜디오: 브리프가 담긴 창, 안내 모드: '?'로 진행됩니다. 새로운 작업에서 이 기술이 필요할 때 사용하세요.

사이트 프로모 영화란 무엇인가요?

이 스킬은 에이전트가 '사이트 프로모 영화'의 전체 워크플로우를 이해하고 실행하도록 안내합니다. 제품 프로모 영화를 코드로 렌더링하는 방식으로, 모든 프레임이 시점 t에서 처음부터 그려집니다. Headless Chrome으로 서브프레임을 캡처하고 ffmpeg로 혼합 및 인코딩하여 최종 동영상을 생성합니다. 이 스킬은 템플릿 파일(promo.html, reel.html, film.js, parts.js, fx.js, type.js 등)과 다양한 스크립트(렌더링, 내레이션, 음성, 믹싱, 연락처, 비트, 클릭 검사, 레이아웃 검사, 전달, 폰트)를 제공하여 전체 제작 과정을 지원합니다. 이 스킬은 Studio(시각적 브리프 생성), 안내 모드(대화형 가이드), 영화 제작의 모든 단계(구상, 스토리보드, 렌더링, 내레이션, 음악, 전달)를 포함하며, Claude Code, Cursor, Codex와 같은 AI 에이전트 플랫폼에서 사용할 수 있습니다.

지원 대상✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/gfazioli/manovella/tree/HEAD/plugins/manovella/skills/site-promo-film

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

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

문서

제품 프로모 영화, 코드로 렌더링됨

한 페이지, 하나의 캔버스, 그리고 seek(t)는 시점 t의 프레임을 처음부터 그립니다. Headless Chrome은 프레임당 N개의 서브프레임을 캡처하고, ffmpeg는 이를 혼합 및 인코딩합니다. 영화는 함수입니다. 비디오는 그 함수의 샘플링입니다. 따라서 모든 프레임을 검토할 수 있고, 모든 변경이 저렴하며, 루프가 정확합니다.

다음 파일은 이 스킬과 함께 제공됩니다. 영화 작업 폴더에 복사하세요. 엔진을 다시 작성하지 마십시오.

파일설명
template/promo.html엔진과 8초 데모: 폐쇄형 스프링, 스프링 합산 트랙, 카메라, 텍스트 도우미(표 형식, 플립), 헤드라인, 실제 커서, 단일 객체 모프 체인, 진정한 3D를 위한 WebGL 컴포지터. 그대로 열고 렌더링됩니다.
template/reel.html타임라인의 긴 영화: 6개의 장면, 6개의 형식(운동 타이포그래피, 브라우저, 랙 포커스가 있는 벤토 그리드, 터미널, 장치의 3D 커버 플로우, 엔드 카드), 5개의 전환, 장면별 외형, 챕터. ~56초, 루프가 아닙니다. §2의 목록이 실행됩니다.
template/film.js페이지가 공유하는 엔진: 스테이지(서브프레임당 서브픽셀 지터링으로 느린 움직임에서 계단 현상이나 떨림 방지), 래스터용 FILM.draw, 스프링 및 카메라, 타임라인(장면, 챕터, 체크포인트 및 24개의 전환: 2D 캔버스에서 16개, 단일 WebGL2 컨텍스트에서 조각 셰이더로 8개) 및 효과(피사계 심도, 녹아웃 타입, 타이핑). 상단에 문서화되어 있습니다.
template/parts.js벡터 파트: macOS 창, 브라우저, 터미널, iPhone, iPad, MacBook, iMac, 키캡, 스위치, 링, 버튼, 포인터. 각각 콘텐츠가 들어갈 rect를 반환합니다.
template/parts.html하나의 16:10 시트에 모든 파트: PAGE=parts.html node render.mjs stills parts 0은 docs/parts.jpg가 변환된 PNG를 만듭니다(sips -s format jpeg -s formatOptions 92).
template/fx.js페이지가 로드하는 외형: 배경(단색, 그라데이션, 필드 또는 사진; 소프트 브랜드 조명; 시차 효과가 있는 점, 격자 또는 선; 원근법의 바닥; 스포트라이트), 마무리(비네팅, 그레인) 및 이에 의존하는 효과(프로스티드 글라스, 클릭 리플, 포커스-풀 헤드라인). 23개의 프리셋과 photo, 모든 필드 재정의 가능, 파일 상단에 문서화됨. release-film과 공유됩니다.
template/type.js헤드라인 및 운동 타이포그래피(§3): TYPE.draw(ctx, t, spec) 13가지 스타일(상승, 포커스, 정착, 트랙, 와이프, 캐스케이드, 웨이트, 스플릿, 플랩, 타입, 스왑, 오도미터, 디코드) — 강조 표시, 속도 및 패밀리 얼굴용 TYPE.load 포함. 나머지와 마찬가지로 t의 순수 함수입니다.
template/fonts/20개의 오픈 라이선스 패밀리(라틴 + 라틴 확장 woff2, 각각 OFL.txt 포함) 및 fonts.json, 해당 얼굴. 영화는 사용하는 것만 src/fonts/에 복사합니다. scripts/fonts.mjs add가 다른 것을 가져옵니다.
scripts/render.mjsstills <dir> t…, sheet <dir> (타임라인의 체크포인트), looks <dir> <t>, loopcheck, video <out> [workers]. 페이지에서 크기, fps, 지속 시간 및 챕터를 읽습니다. 모든 서브프레임을 지터링합니다. 재개 가능한 청크로 렌더링합니다. FROM/TO, PREVIEW=1, RESUME=1, KEEP=1, AUDIO=, SHUTTER=. 확장자가 형식을 선택합니다(.mp4, .mov ProRes, .webm, .gif; HEVC=1; 투명 .mov 또는 .webm용 ALPHA=1). 렌더링 전에 트랙을 확인하고 후에 파일을 확인합니다. WebGL 컨텍스트를 잃은 페이지의 캡처를 실패 처리하고, 실행 중인 컷의 두 번째 렌더링을 실패 처리합니다. 상단에 문서화되어 있습니다.
scripts/narrate.mjs영화의 스토리(story.json: 단계별 한 문장, 튜토리얼 또는 프로모의 말하기)를 음성, 시계 및 자막으로 변환: voice/*.aiff, narration.wav (영화의 AUDIO), narration.js (각 단계의 시간, 페이지용) 및 captions.srt / .vtt. Mac의 say 또는 자신의 녹음 폴더에서 --from. "human": "natural"은 사람처럼 일시 중지를 다양하게 합니다. 모델의 소리([chuckle])는 자막에서 제외됩니다. 상단에 문서화되어 있습니다.
scripts/voice.mjsMac에서 실행되는 음성 모델(story.json의 "mlx": 강의용 Chatterbox, 프로모용 Orpheus, 빠른 초안 또는 이탈리아어 영화용 Kokoro)이 say보다 사람에 가깝게 동일한 스토리를 전달합니다. 각 단계를 말하고(voice-mlx.py, mlx-audio 통해), 속도와 레벨을 조정한 후 narrate.mjs를 호출합니다. 테이크는 시드입니다. "tone"(calm, warm, bright)은 모델이 읽는 자유도, "human"은 각 줄의 속도를 3% 이내로 변화시키고 줄이 소리를 낼 수 있게 합니다([chuckle], [sigh]: 각 모델의 고유 철자 또는 생략). --audition은 테이크를 비교하고, --recordings는 녹음에서 멈추고, --setup은 각 Mac에서 Python을 만들고 모델을 한 번 가져옵니다(voice-constraints.txt가 설치 항목을 고정함) 그리고 해당 Mac이 여기에 기록된 테이크를 반복하는지 알려줍니다. 상단에 문서화되어 있습니다.
scripts/mix.mjs음성과 음악 트랙을 하나의 사운드트랙으로, AUDIO=용: 둘 다 측정됨(EBU R128), 음악은 음성이 말하는 동안 --under LU 아래로, 줄 사이에 --lift dB 위로, 각 줄이 시작되기 전에 낮춤. 결과를 출력하고 측정값을 출력합니다. 상단에 문서화되어 있습니다.
scripts/contact.mjs스틸 또는 룩스 폴더의 캡션이 있는 연락처 시트(캡션은 폴더 내 labels.json에서 가져옴). --size WxH는 정확히 해당 크기로 만듭니다(--font, --gap, --pad; 스틸은 절대 자르지 않음. .jpg는 JPEG로 작성됨). --dark는 어두운 시트용. --compare A=<dir> B=<dir> [C=<dir>] <out.png>: 두세 개의 폴더를 나란히, 각각 레이블이 지정된 열과 공유하는 스틸당 행, 하나의 이미지에 대한 A/B 선택용.
scripts/beats.mjs샘플에서 사운드트랙의 비트: 템포, 유지 여부, 모든 비트, 마디, 섹션, 페이지에 제공할 bpm 및 AUDIO_AT. --out beats.js는 드리프트하는 트랙을 따르는 페이지용(FILM.beats). render.mjs는 이를 가져와 페이지의 비트를 트랙의 비트와 비교합니다. --selftest.
scripts/clickcheck.mjs모든 클릭이 보이는지 확인: 페이지의 각 CLICKS에 대해 클릭된 지점이 화면에서 얼마나 빨리 이동하는지, 커서가 누르기 전과 누르는 동안 얼마나 멀리 이동하는지. 아무도 볼 수 없는 클릭이면 종료 코드 1(release-film §3b), 커서가 없는 페이지면 종료 코드 2.
scripts/layoutcheck.mjs모든 헤드라인이 프레임 내에 있고, 분리되어 있으며 읽기 쉬운지 확인: 각 체크포인트에서 각 TYPE.draw가 그리는 헤드라인이 안전 영역, 다른 헤드라인 및 주변 배경에 대해(한계는 헤더에 있음). 실패한 헤드라인이면 종료 코드 1, TYPE.draw를 통해 헤드라인을 그리지 않는 페이지면 종료 코드 2.
scripts/deliver.mjs마지막 단계(§8): 완성된 비디오와 해당 커버가 작업 폴더를 떠나 자체 폴더로 이동합니다. 영화가 나가면 trash는 소스가 키트에 안전하게 있는지 확인한 후 작업 폴더를 버립니다. --selftest.
scripts/fonts.mjs키트의 폰트: Google Fonts에서 add "<Family>" [axes] (라이선스 포함), check, list.

그 외에도 studio/(아래 스튜디오), guide.md(아래 안내 모드) 및 README.md(그림으로 된 목록과 영화의 모든 순간에 대한 예제 요청)가 있습니다.

설정: 작업 폴더, ~/Downloads/<name>-work/ (~/Downloads는 작업 루트, 아래 설정 파일의 workRoot가 다른 곳을 지정하지 않는 한). 페이지와 이 파일들은 src/에 있으며, 거기에 npm i playwright-core를 실행합니다. 이는 설치된 Chrome을 channel: 'chrome'을 통해 구동하므로 다른 것은 다운로드되지 않습니다. <name>은 <product>-<what>(acme-promo, acme-2.4-whats-new)이며, 배달 폴더와 모든 배달 파일의 이름도 지정합니다(§8).

스튜디오: 브리프가 담긴 창

시각적 진입점. 자체 창의 마법사: 레시피, 형식, 외형, Mac의 사진, 실제 엔진에서 움직이는 모습이 표시되는 타이포그래피 및 모션, 제품의 색상 및 비율, 사운드(음악 라이브러리의 트랙 재생, 음성 모델의 목소리가 선택 전에 한 줄 말하는 소리), 그리고 모든 선택 사항이 하나의 brief.json에 기록됩니다. 아무것도 설치되지 않으며 아무것도 렌더링되지 않습니다. /manovella:studio도 열립니다.

  • 시기: studio로 호출되거나, 대화에서 어떤 영화를 만들지 아무 말도 하지 않은 상태에서 호출됩니다. 원하는 것을 말로 표현한 사용자는 바로 §0으로 갑니다.
  • 실행: 작업 공간에서 node <this skill's dir>/studio/studio.mjs를 백그라운드에서 실행하고(해당 리포지토리의 형제는 제공되는 제품임), 창이 열렸다고 한 줄로 말합니다. 자체적으로 종료되며 한 줄을 출력하고, 종료가 당신을 깨웁니다: BRIEF <path>, 또는 CANCELLED, CLOSED, TIMEOUT(그렇게 말하고 중지). 창은 이 Mac이 빌드한 곳인 Studio 자체 앱(~/Applications/Manovella.app, Dock의 이름, 버전 및 아이콘)이며, 그렇지 않으면 Chrome 앱 창입니다. MANOVELLA_WINDOW=chrome은 Chrome을 유지합니다. 둘 다 없으면 기본 브라우저를 엽니다. --no-open은 URL을 대신 출력하여 화면이 다른 곳에 있는 세션에 사용합니다.
  • 음악 라이브러리는 선택 사항입니다: 사용자 영화의 음악이 있는 폴더로, 사용자가 원하는 곳에 보관됩니다(동기화된 드라이브, 프로젝트 폴더). 한 번 실행 시 MANOVELLA_MUSIC이 가리키는 곳, 또는 ~/Library/Application Support/manovella/settings.json의 musicLibrary (macOS 외의 경우 ~/.config/manovella/settings.json; 선행 ~는 확장됨). 동일 파일의 musicLibraryIgnore는 건너뛸 폴더 이름을 나열하고, deliverToLibrary(true 또는 false, 기본값 false)는 완성된 영화도 라이브러리에 들어갈지 여부를 지정합니다. 자동 감지되지 않습니다. brandLibrary 및 brandLibraryIgnore가 있는 이전 파일은 deliverToLibrary가 켜진 상태에서 musicLibrary 및 musicLibraryIgnore로 읽혀지며, 이전에 했던 대로 Studio 설정에서 첫 번째 변경 시 새 키로 다시 작성됩니다. 동일 파일은 projectFolders(Studio가 제품을 찾는 위치), pictureFolders(배경 사진, 설정되지 않음: ~/Pictures) 및 workRoot(<name>-work 및 영화가 라이브러리로 배달되지 않거나 프로젝트에 지침이 없는 한 <name>/이 이동하는 위치, 설정되지 않음: ~/Downloads)를 사용합니다. Studio의 설정 창(Manovella.app에서 로고 옆의 톱니바퀴 또는 ⌘,)은 모두를 작성하고, deliver.mjs도 workRoot를 읽습니다. 코드의 다른 곳에서는 라이브러리 키를 읽지 않습니다. Studio 없이 만든 영화의 경우 이 단락이 저에 대한 지침입니다.
    • Studio는 라이브러리의 최상위 수준과 각 폴더 내에 있는 모든 오디오 파일(mp3, m4a, aac, wav, aiff, flac, ogg)을 직접 또는 해당 폴더의 audio/ 폴더에서 제공합니다. 점 폴더와 musicLibraryIgnore의 이름은 건너뜁니다. 브랜드별 폴더는 선택 사항이며 해당 트랙을 그룹화합니다. 제품 이름을 딴 폴더가 먼저 나열됩니다("이 제품의"). 트랙 옆에 있는 선택적 메모 파일(…notes.txt 또는 .md: 트랙당 한 단락, 트랙의 파일 이름으로 시작: 설명, 분위기, 적합한 위치)은 각각의 용도를 말하며 Studio가 이를 표시합니다.
    • 완성된 영화: deliverToLibrary가 켜져 있고 라이브러리가 설정된 경우 <library>/<Brand>/video/<name>/ (§8). 그렇지 않으면 프로젝트 자체 지침이 완성된 미디어를 보관하는 위치, 또는 작업 루트의 <name>/(기본적으로 ~/Downloads/<name>/).
    • 새로 만들어진 트랙(아래)은 라이브러리가 존재하는 경우 브랜드별로 폴더를 유지하는 라이브러리의 제품 폴더에 메모 파일의 해당 단락과 함께 저장됩니다. 그렇지 않으면 영화의 src/audio/에만 들어갑니다. 파일 제공자(Google Drive, iCloud Drive, Dropbox)의 폴더는 파일이 열릴 때까지 "데이터 없음" 상태로 보관될 수 있으므로 측정하기 전에 파일을 열거나 복사하십시오. 라이브러리가 보관하는 파일은 복사되며, 라이브러리 밖으로 이동되지 않습니다.
  • brief <path>, 인수 또는 BRIEF 줄에서: 브리프를 읽습니다. §0에 답합니다.
    • formats: []는 제가 선택한 세 가지입니다. 프로모 또는 챕터가 있는 영화의 경우 하나, 둘 또는 세 개의 명명된 형식이 스토리보드의 형식이며, 그 순서대로이고, 나머지는 제가 선택하며 각각 다른 형식입니다. 릴리스 및 튜토리얼의 한 가지 형식은 그들의 것입니다(whatsnew, tutorial), 채워지지 않음. look: null은 외형 시트입니다(§4).

    • frame: 형식에 관계없이 제품이 표시되는 프레임. null은 각 형식의 자체 프레임입니다(워크스루는 브라우저, 명령줄은 터미널, 튜토리얼은 Mac 창), 제 선택.

      • window: macOS 창의 앱(PARTS.window).
      • macbook: 정면에서 본 MacBook, 화면에 앱 창 또는 사이트 브라우저(PARTS.laptop, PARTS.notch가 마지막으로 그려짐).
      • imac: 정면에서 본 iMac, 스탠드 위, 데스크탑에 앱 창 또는 사이트 브라우저(PARTS.desktop: rect는 본체, 547:375, 스탠드는 아래에 그려짐. color는 Apple의 7가지 색상 중 하나이거나 가장 가까운 색상의 브랜드 악센트). 노치 없음: 카메라는 흰색 베젤에 있습니다.
      • iphone, ipad: 장치(PARTS.phone with PARTS.island drawn last; PARTS.tablet, rect로 눕거나 세움, 긴 가장자리에 카메라), 그 위의 제품 자체 레이아웃(§1), 그리고 모든 클릭은 터치: 누르는 소프트 디스크, 외형의 리플, 절대 PARTS.ARROW 아님. 튜토리얼은 탭이라고 말합니다.
      • browser: PARTS.browser의 페이지로서의 제품, 필드에 실제 주소.
      • terminal: PARTS.terminal, FILM.typed로 입력됨.
      • bare (Studio의 Just the UI): 제품 UI 자체, 둥근 모서리와 그림자가 있는 떠 있는 패널, 창 크롬이나 장치 주변 없음. 제품은 여전히 화면에 있습니다. 제품이 없는 영화는 운동 타이포그래피 형식이며, 이는 아닙니다.

      프레임은 각 스토리보드에서 제품을 보여주는 모든 장면에 대해 유지됩니다. iPhone 앱의 튜토리얼은 첫 번째 단계부터 마지막 단계까지 iPhone에서 전달됩니다. 그 자체로 표면인 형식은 이에 따라 변경됩니다. iphone이 있는 브라우저 워크스루는 해당 너비의 전화기 내 사이트입니다. macbook 또는 imac이 있는 터미널은 Mac 데스크탑의 터미널 창입니다. 3D의 장치는 여러 장치를 보여주는 유일한 형식입니다. 선택된 장치가 커버 플로우를 이끕니다(카메라를 향하는 첫 번째 카드, 돌아오는 카드), 그리고 다른 것들은 따라옵니다. 프레임과 형식이 충돌하는 경우...

… (마크다운이 잘렸습니다) 계속합니다...

프레임은 각 스토리보드에서 제품을 보여주는 모든 장면에 대해 유지됩니다. iPhone 앱의 튜토리얼은 첫 번째 단계부터 마지막 단계까지 iPhone에서 전달됩니다. 그 자체로 표면인 형식은 이에 따라 변경됩니다. `iphone`이 있는 브라우저 워크스루는 해당 너비의 전화기 내 사이트입니다. `macbook` 또는 `imac`이 있는 터미널은 Mac 데스크탑의 터미널 창입니다. **3D의 장치**는 여러 장치를 보여주는 유일한 형식입니다. 선택된 장치가 커버 플로우를 이끕니다(카메라를 향하는 첫 번째 카드, 돌아오는 카드), 그리고 다른 것들은 따라옵니다. 프레임과 형식이 충돌하는 경우 형식이 우선합니다(예: 터미널 형식의 `imac`은 터미널 창이 있는 iMac을 표시하고, 운동 타이포그래피 형식의 `bare`는 UI 없는 운동 타이포그래피입니다).
  • scenes: 스토리보드. 각 장면에는 format, frame, look, headlines, clicks, duration, transition 등이 있습니다. 각 장면은 시간 순서대로 나열됩니다. 첫 번째 장면은 항상 도입부입니다.

  • story: 각 장면의 내레이션 스크립트입니다. 각 항목은 장면의 요점을 설명하는 한 문장입니다.

  • music: 사운드트랙. 트랙 이름, 시작 시간, 볼륨.

  • voice: 음성 모델 및 설정.

  • 설정 파일: ~/Library/Application Support/manovella/settings.json (macOS) 또는 ~/.config/manovella/settings.json (기타). 다음을 포함합니다:

    • musicLibrary: 음악 라이브러리 경로.
    • musicLibraryIgnore: 건너뛸 폴더 이름 목록.
    • deliverToLibrary: 완성된 영화를 라이브러리에 복사할지 여부.
    • projectFolders: Studio가 제품을 찾는 폴더 목록.
    • pictureFolders: 배경 사진 폴더 목록.
    • workRoot: 작업 폴더의 루트.
    • brandLibrary (이전): musicLibrary로 읽힘.
    • brandLibraryIgnore (이전): musicLibraryIgnore로 읽힘.

안내 모드: ?

대화형 안내 모드입니다. ?를 입력하면 현재 단계에 대한 도움말이 표시됩니다. 각 단계에는 수행할 작업을 설명하는 짧은 텍스트가 있습니다. guide.md 파일에는 모든 단계에 대한 전체 문서가 포함되어 있습니다.

영화 만들기 (요약)

  1. 구상: 브리프 생성(Studio 사용 또는 설명).
  2. 스토리보드: 각 장면을 설명하는 brief.json.
  3. 렌더링 엔진 설정: src/ 폴더에 템플릿 파일 복사.
  4. 콘텐츠 생성: promo.html 또는 reel.html 수정.
  5. 외형 및 스타일: fx.js 및 type.js 구성.
  6. 내레이션 및 음악: story.json 생성, narrate.mjs 및 mix.mjs 실행.
  7. 렌더링: render.mjs로 스틸 및 비디오 렌더링.
  8. 검토 및 수정: clickcheck.mjs 및 layoutcheck.mjs 실행.
  9. 전달: deliver.mjs로 최종 파일을 전달 폴더로 이동.

예제 요청

  • "acme 앱의 프로모 영화를 만들어 줘. 30초 분량으로, 브라우저 워크스루와 운동 타이포그래피 형식을 사용하고, 밝은 외형으로 해줘."
  • "이 튜토리얼을 영화로 만들어 줘: iPhone 앱의 첫 번째 단계부터 마지막 단계까지 iPhone에서."
  • "릴리스 노트 영화: 새로운 기능을 강조하는 3개의 장면."
  • "Studio를 열어 브리프를 만들어."

참고: 이 파일은 SKILL.md의 일부입니다. 전체 내용은 원본 파일을 참조하십시오.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬