Communitygithub.com

SingleGrain-Team/video-skills

제품 출시용 15~20초 분량의 숏필름을 만듭니다. 다크 스튜디오에서 순수 CSS로 제작된 노트북(3D 모델이나 생성 모델 미사용) 위에 실제 제품 화면을 보여주고, 페이지를 스크롤하며, 검색어 입력 같은 핵심 동작을 위해 인터페이스로 확대/축소하고, 로고 록업으로 마무리합니다. 전체 페이지 스크린샷이나 화면 녹화본, 하나의 주요 동작, 로고가 있고, 1920x1080 MP4로 렌더링된 무음 친화적인 런치 티저를 원할 때 사용하세요.

video-skills란 무엇인가요?

이 스킬은 제품 출시를 위한 15~20초 분량의 숏필름을 생성합니다. 다크 스튜디오 배경에서 순수 CSS로 제작된 노트북(실제 하드웨어 이미지나 3D 모델 없음) 위에 실제 제품 화면을 표시하고, 페이지를 스크롤하며, 한 가지 핵심 동작(예: 검색어 입력)을 위해 카메라가 확대/축소되고, 마지막에 로고와 제품명, 태그라인이 등장합니다. 이 스킬은 전체 페이지 스크린샷이나 화면 녹화본, 하나의 주요 동작, 로고를 입력으로 받아 HyperFrames 프로젝트를 생성하고, `npx hyperframes render` 명령어로 1920x1080 MP4 파일을 렌더링합니다. 사용자는 결과물뿐만 아니라 편집 가능한 프로젝트 폴더도 함께 받을 수 있어 HyperFrames Studio에서 수정이 가능합니다. Gatsby나 React 같은 프레임워크를 사용하지 않는 CLI 기반 도구입니다. 이 스킬의 주요 장점은 실제 제품 화면을 사용하여 정확성을 보장하고, CSS로만 디바이스를 구현하여 라이선스 문제를 피하며, 빠르고 반복적인 렌더링 워크플로우를 제공한다는 점입니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SingleGrain-Team/video-skills/tree/HEAD/skills/device-launch-film

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

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

문서

device-launch-film

원샷 런치 필름: 디바이스가 나타나고, 실제 페이지가 스크롤되며, 카메라가 한 동작으로 확대되었다가, 디바이스가 사라지고 로고 록업이 나타납니다. 약 18초, 내레이션 불필요.

입력

제작 전에 이 항목들을 준비하세요. 빠진 항목이 있으면 요청하세요.

  1. 페이지 캡처: 실제 제품의 전체 페이지 PNG (권장, 너비 1920, 높이 최대 약 6000) 또는 화면 녹화본. 녹화본인 경우 시작 상태의 스틸 이미지를 추출하여 스크롤에 사용하고, 확대/축소 비트에만 실제 클립을 사용하세요.
  2. 하나의 동작: 3초 안에 명확하게 읽히는 단일 상호작용. 검색 필드에 입력하는 것이 가장 쉽고, 버튼 누르기나 토글도 괜찮습니다. 페이지 픽셀 단위로 위치를 기록하세요.
  3. 로고: 투명 PNG 또는 SVG, 제품명, 한 줄 태그라인. 사용자가 소유한 에셋만 사용하세요.
  4. 선택 사항: 브랜드 색상 (강조 색상, 어두운 배경), 종료 라인용 URL.

절대 타사의 UI나 로고를 제품의 것으로 대체하지 마세요.

워크플로우

  1. /hyperframes 및 /hyperframes-core를 로드하고, 해당 구성 계약을 따릅니다.
  2. 프로젝트 디렉토리를 생성합니다. 캡처를 assets/page.png에, 로고를 assets/logo.png에 넣습니다.
  3. 이 스킬의 template/index.html을 index.html로 복사합니다. 이 템플릿은 CFG 블록과 몇 가지 CSS 크기로 구동되는 단일 독립형 구성입니다.
  4. 페이지를 화면에 맞춥니다. 화면은 뚜껑 내부에서 1120x700 (16:10)입니다. 비율 = 1120 / 캡처 너비. CFG.scale과 CFG.maxScroll (= 캡처 높이 x 배율 - 700)을 설정합니다. 캡처가 화면보다 짧으면 스크롤 비트를 생략하고, 매우 길면 스크롤을 3-4초로 유지하고 빠르게 진행합니다.
  5. 캡처(페이지 픽셀)에서 동작 위치를 찾고 필드의 박스와 텍스트 원점을 기록합니다. 템플릿에서 이는 #patch (플레이스홀더 덮음), #ring (포커스 아웃라인), #typed (텍스트 위치 및 글꼴 크기) 규칙과 CFG.focus (카메라가 중심으로 하는 스테이지 포인트: screen left 400 + x * scale, screen top 110 + y * scale, 스크롤은 0으로 다시 설정)를 편집하는 것을 의미합니다.
  6. 결과 상태를 위해, 두 번째 캡처에서 실제 결과를 잘라내거나, 템플릿이 하는 것처럼 동일한 캡처에서 실제 요소를 재사용합니다 (#hit는 필드 아래에 밀려 들어가는 잘린 카드이고, #cover는 나머지를 숨깁니다). 절대 가상 데이터를 그리지 마세요.
  7. #end에서 록업 텍스트와 색상을 교체합니다. 이미 있는 숫자만 사용하여 타임라인을 조정하세요.
  8. npx --yes hyperframes check를 실행하고 사용자가 발생시킨 모든 경고를 수정한 후 (유효성 검사 참조), npx --yes hyperframes snapshot --at 0.8,3.5,6,9,10.5,12,13,16을 실행하고 연속 이미지 시트를 확인합니다.
  9. 렌더링: npx --yes hyperframes render --workers 2 --fps 30 -o final.mp4.

비트 시트 (18초)

시간비트
0-1.6노트북이 어둠 속에서 떠오르고, 화면이 검은색에서 밝아짐
1.7-5.2페이지가 ease-in-out으로 위에서 아래로 스크롤되고, 카메라는 3% 안쪽으로 이동
5.6-7.1스크롤이 상단으로 돌아옴
7.0-8.3카메라가 동작 대상으로 확대 (약 3배); 포커스 링이 나타남
8.7-10.5동작 실행 (초당 약 5자 입력)
10.8-12.4결과가 나타나고 제자리로 올라옴
12.7-13.8카메라가 뒤로 당겨지고, 디바이스가 축소되며 사라짐
13.9-18록업: 마크가 팝인, 이름, 태그라인, URL; 최소 2초 유지

규칙

  • 디바이스는 CSS 전용: 베젤이 있는 뚜껑, 화면, 노치가 있는 베이스, 부드러운 바닥 그림자. 실제 하드웨어 이미지, 3D, 상표권이 있는 디바이스 실루엣(일반적인 노트북 판 외에는)은 사용할 수 없습니다.
  • 두 개의 중첩된 카메라 래퍼: 외부 래퍼는 이동 및 페이드, 내부 래퍼는 확대/축소를 담당합니다. 시간이 겹치는 두 트윈에서 동일한 요소의 동일한 속성을 트윈하지 마세요.
  • 화면의 모든 것은 확대/축소가 선명하고 정렬된 상태를 유지하도록 크기가 조정된 페이지 요소 안에 위치합니다. 오버레이(입력된 텍스트, 링, 패치, 결과)는 페이지 픽셀을 사용합니다.
  • 타이핑은 프록시 숫자와 onUpdate로 구동되며, 시크(seek)에 안전합니다. 타이머나 랜덤은 사용하지 않습니다.
  • 로컬 @font-face 없이 웹 폰트를 사용하지 마세요. 템플릿은 시스템 스택을 사용합니다. 브랜드에 특정 폰트가 필요한 경우 파일을 assets/에 넣고 선언하세요.
  • 실제 사람의 사진을 크게 보여주지 마세요. 캡처에 아바타가 있는 경우, 확대/축소를 아바타에서 멀리 유지하거나 페이지 배경으로 가리세요.
  • 음악은 선택 사항입니다. 라이선스가 상업적 사용을 허용하고 출처를 기록한 경우에만 추가하세요. 무음도 괜찮습니다.
  • 캡처를 위해 로그인, 구매 또는 개인 데이터를 캡처하지 마세요.

유효성 검사

  • check가 0개의 오류를 보고합니다. 스크롤러의 container_overflow 및 확대된 카메라의 escaped_container 레이아웃 참고 사항은 여기서 예상됩니다 (스크롤러는 클립을 넘치도록 의도되었고, 카메라는 의도적으로 확대/축소됩니다). 다른 경고, 특히 overlapping_gsap_tweens는 반드시 수정해야 합니다.
  • 주요 비트의 스냅샷을 찍고 확인합니다: 0.8초와 3.5초에서 디바이스가 중앙에 있고 잘리지 않음, 확대된 필드가 전체 입력 텍스트와 함께 읽을 수 있음, 결과가 필드에서 명확히 떨어져 있음, 록업이 중앙에 있고 화면에 디바이스의 잔재가 없음.
  • 렌더링 후 ffprobe로 파일이 H.264, 1920x1080, 15-20초인지 확인한 다음, 4~6개의 프레임을 추출하여 살펴봅니다. 문제가 있으면 수정하고 다시 렌더링합니다.

전달

final.mp4, 프로젝트 폴더 (편집 가능), 그리고 사용된 캡처 및 로고, 오디오 소스(있는 경우), CLI 버전을 간략히 기록한 노트를 전달합니다. 프로젝트가 HyperFrames Studio에서 편집될 수 있음을 언급합니다.

Individual skills in this repo

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

SingleGrain-Team/video-skills

Make a 30-45 second launch film for a product by staging it inside one persistent, neutral chat window. A user types a request, the assistant answers and calls the product as a connected tool, a progress card runs, a follow-up triggers a second tool action, and the result lands as a count-up headline number before closing on the logo, tagline and call to action. Use when you need a launch, feature or integration announcement video for something that plugs into AI assistants (a skill, MCP server, plugin, connector, CLI). Delivers a rendered 1920x1080 MP4 plus an editable single-file HyperFrames project.

SingleGrain-Team/video-skills

Build a motion graphic where a screen recording plays in a large frame beside a checklist, and each checklist item ticks off at the exact moment that step happens in the recording, ending with every item checked and a short hold. Use when someone has a screen recording (product walkthrough, tutorial, onboarding, install demo) plus a list of steps with timestamps and wants a "watch the steps get done" film. Input is a recording, step labels with timestamps, a title and an optional palette; output is a 1920x1080 H.264 MP4 and the editable HyperFrames project.

SingleGrain-Team/video-skills

Builds a 6-8 second logo sting in which the brand mark rides inside a refracting liquid bead (distorted past legibility), the bead swells, holds still for a beat, then ruptures into droplets and leaves the logo lockup (mark plus wordmark) crisp and upright on screen. Delivered as a 1920x1080 H.264 MP4 plus the editable HyperFrames project, with no 3D model, stock footage or generation model. Use it for brand intros and outros, product-launch openers, channel stings and any "reveal our logo" moment, from an SVG or PNG logo (including raster-only logos), a wordmark string and a palette.

SingleGrain-Team/video-skills

Make a 20-30 second launch film for a product that is not tied to one interface, such as a CLI, package, plugin or agent skill. The identical prompt or command is typed into four visually different surfaces in turn (a wide terminal, a tall chat card, a floating palette, an editor cell), the film then hard-cuts into a fast reel of real outputs on a beat or fixed tempo grid, and it closes on the command in a large pill. Delivered as a rendered 1920x1080 MP4 plus the editable HyperFrames project. Music is optional - with a track the cuts land on detected beats, without one they land on a 120 bpm grid.

SingleGrain-Team/video-skills

Make a roughly 30-second film that explains a code change (a pull request, release or uncommitted diff) to people who will never read the diff. It opens by showing the real diff scrolling past too fast to follow, cuts to a plain-language summary, fires four capability beats each pinned to a real code snippet, and closes on how to get it (install command and URL). Delivered as a 1920x1080 H.264 MP4 plus the editable HyperFrames project. Use when asked to turn a PR, changelog or release into a launch or explainer video.

SingleGrain-Team/video-skills

Render a 5-6 second motion graphic in which an oversized condensed headline (2-4 words) punches in behind a presenter, using a background-removed cutout of the presenter layered on top of the lettering. A hard cut then removes the presenter while the same headline holds the exact same size and position, and a short supporting line appears for a reading hold. Use it for talking-head intros, chapter openers, launch announcements and social hooks when you have one presenter clip, a headline, a supporting line and a palette. Built on HyperFrames; delivers a 1920x1080 H.264 MP4 plus the editable project.

SingleGrain-Team/video-skills

Builds a 10-14 second product sting out of a short run of UI moments (an entry screen, a single counting metric, a navigation list, one click that opens a menu, then an endcard) cut together so every cut carries the previous motion forward and the piece reads as one continuous camera move. Delivered as a 1920x1080 H.264 MP4 plus an editable single-file HyperFrames project. Use it for app launches, feature teasers, social bumpers and site intros when you have a product's logo, a couple of screenshots, one headline number and its real nav labels, and want polished UI motion without narration.

관련 스킬