Communitygithub.com

SingleGrain-Team/video-skills

제품, CLI, 패키지, 플러그인 또는 에이전트 스킬용 20-30초 런치 필름을 만듭니다. 동일한 프롬프트 또는 명령어를 네 가지 시각적으로 다른 표면(넓은 터미널, 긴 채팅 카드, 떠 있는 팔레트, 에디터 셀)에 차례로 입력하고, 실제 출력물을 비트 또는 고정 템포 그리드에 맞춰 빠르게 보여준 후, 큰 필에 명령어를 표시하며 마무리합니다. 렌더링된 1920x1080 MP4와 편집 가능한 HyperFrames 프로젝트로 제공됩니다. 음악은 선택 사항입니다. 트랙이 있으면 감지된 비트에 맞춰 컷이 떨어지고, 없으면 120 BPM 그리드에 맞춰집니다.

video-skills란 무엇인가요?

이 스킬은 동일한 프롬프트 또는 명령어가 다양한 인터페이스에서 동일하게 작동한다는 점을 강조하는 20-30초 길이의 제품 런치 필름을 생성합니다. 사용자는 최대 50자 이내의 명령어와 16-24개의 실제 출력 이미지(스크린샷, 제품 화면 등)를 제공하고, 브랜드 이름, 태그라인, URL 및 선택적으로 로고와 음악 트랙을 추가할 수 있습니다. HyperFrames 프레임워크를 기반으로 하며, 네 가지 시각적으로 구별되는 표면(넓은 터미널, 긴 채팅 카드, 떠 있는 팔레트, 에디터 셀)에 동일한 명령어가 입력되는 과정과, 이후 빠른 속도로 실제 출력물을 보여주는 리일(reel) 섹션, 마지막으로 명령어를 강조하는 클로징 카드로 구성됩니다. 음악이 제공되면 감지된 비트에 맞춰 컷이 동기화되고, 음악이 없으면 120 BPM의 고정 그리드에 맞춰집니다. 최종 출력은 1920x1080 해상도의 MP4 파일이며, 명령어, BPM, 리일 이미지, 브랜드 정보 등을 쉽게 구성할 수 있습니다.

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

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

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

문서

one-prompt-reel

이 필름이 전하는 메시지: "어디에 입력하든 동일하게 작동합니다." 증명은 반복입니다. 하나의 문자열, 서로 다른 네 개의 표면, 그리고 그 결과물의 연속, 마지막으로 다시 한 번 문자열을 보여줍니다.

입력

입력필수참고
prompt예정확한 명령어 또는 문장. 약 50자 이내가 가장 잘 읽힙니다. 네 번 입력되고 마지막에 한 번 더 표시됩니다.
reel 이미지예16-24개의 실제 출력물: 스크린샷, 제품 화면, 이전 렌더링에서 추출한 스틸 이미지. 사용자의 자체 자료만 사용 가능합니다.
브랜드 이름, 태그라인, URL예클로징 카드에 사용됩니다.
로고아니오알파 채널이 있는 정사각형 PNG. 생략하면 텍스트 전용 클로징이 생성됩니다.
음악아니오상업적으로 사용할 수 있는 라이선스가 있는 트랙. 라이선스가 확실하지 않으면 음악 없이 제작합니다.

워크플로우

  1. 스캐폴드. 프로젝트 폴더를 만들고 template/ (index.html 및 assets/gsap.min.js)을 복사한 다음 리일 이미지를 assets/reel/에 넣습니다. 그런 다음: npx --yes hyperframes check
  2. index.html의 <script> 상단에 있는 CONFIG 블록을 채웁니다. 모든 프로젝트별 설정이 여기에 있습니다: prompt, bpm, reel 파일 목록, brand, tagline, url, logo. 아래 규칙에서 강제로 요구하지 않는 한 나머지 구조는 변경하지 마십시오.
  3. 컷 그리드를 선택합니다.
    • 음악 없음: cuts: null을 유지합니다. 컷은 bpm과 reelPattern에서 생성됩니다 (기본값: 1비트 컷 8개, 그 다음 0.5비트 컷 16개, 120 BPM에서 = 4초 + 4초). 표면은 각각 surfaceBeats 비트 동안 지속되므로 전체 필름이 그리드를 유지합니다.
    • 음악 있음: 트랙을 <audio id="music" data-timeline-role="music" src="assets/music.mp3" data-start="0" data-duration="24" data-track-index="5">로 추가하고, npx hyperframes beats를 실행하고, beats/assets/music.mp3.json을 열고, 리일 시작 시간 이후에 해당하는 비트 시간(초)을 CONFIG.cuts에 복사합니다 (마지막 컷의 끝을 표시하는 추가 항목 하나, 즉 클로징이 시작되는 시점). bpm을 트랙의 템포로 설정하여 타이핑 섹션도 일치시킵니다. 비트 간격이 0.2초보다 좁으면 두 번째 비트마다 사용합니다. 마지막 1초 동안 음악을 페이드 아웃합니다 (/hyperframes-audio).
  4. 렌더링 전에 확인합니다. npx --yes hyperframes snapshot --at 1.8,4.3,6.8,9.2,11,15,20,23을 실행하고 PNG를 엽니다. 각 표면의 타이핑 중간, 리일 컷 한 개, 클로징을 확인합니다.
  5. 렌더링합니다. npx --yes hyperframes render --workers 2 -o final.mp4.
  6. MP4에서 4-6프레임을 추출하여 (표면당 하나, 리일 컷 하나, 클로징 하나) 확인합니다. 잘리거나, 읽을 수 없거나, 빈 프레임이 있으면 수정하고 다시 렌더링합니다.

필름 구조 (기본값 24초)

시간비트
0-10 초네 개의 표면, 각 2.5초. 오른쪽에서 슬라이드 인, 약 1.5초 동안 타이핑, ENTER 누름, 왼쪽으로 슬라이드 아웃. 작은 레이블이 표면 이름과 위치(1/4)를 표시합니다.
10-18 초흰색 플래시와 함께 하드 컷. 24개의 전체 화면 출력 이미지, 각각 느린 푸시인 효과. 명령어는 리일 전체 동안 왼쪽 하단의 필(pill) 안에 위치하고, 오른쪽 하단에 카운터가 있습니다.
18-24 초어두운 클로징: 로고, 이름, 태그라인, 명령어가 테두리가 있는 필 안에 한 번 더 입력되고, URL, 한 번의 글로우 펄스.

성공을 위한 규칙

  • 네 개의 표면은 색상뿐만 아니라 실루엣이 달라야 합니다. 넓고 낮음, 높고 좁음, 그라데이션 위에 떠 있음, 측면 트리가 있는 어두운 배경. 두 표면을 구분하기 어렵다면 하나를 다시 디자인하십시오. 순수 HTML과 CSS로만 제작하고, 실제 제품의 크롬, 로고 또는 색상 팔레트를 절대 모방하지 마십시오.
  • 동일한 문자열, 동일한 타이핑 속도. 모든 표면이 동일한 시간 동안 동일한 prompt를 입력합니다. 이 동일성이 핵심입니다.
  • 타이머 대신 타임라인 트윈(tween)을 사용하여 입력합니다. {n} 카운터에 대한 트윈으로, onUpdate가 문자열을 슬라이싱하는 방식은 seek에 안전합니다. setInterval은 그렇지 않습니다.
  • tl.set을 사용하여 하프 비트 루프로 커서를 깜박입니다. CSS 애니메이션이나 repeat: -1을 사용하지 마십시오.
  • 그리드에 맞춰 컷합니다. 모든 표면 경계, 컷 및 클로징 진입은 음악 그리드든 일반 템포든 비트에 맞춰 떨어집니다. 그리드에서 벗어난 편집은 가장 먼저 조잡하게 보입니다.
  • 한 번만 속도를 높입니다. 처음에는 느린 컷, 그 다음에는 절반 길이의 컷. 반복적으로 가속하지 마십시오.
  • 리일 이미지는 증거입니다. 장식이 아닌 실제 출력물입니다. 1920x1080 스틸 이미지를 선호하며, 크기가 다른 경우 object-fit: cover로 조정합니다. 어두운 이미지와 밝은 이미지를 번갈아 배치하여 각 컷이 구분되도록 합니다.
  • 타사 미디어를 사용하지 마십시오. 다른 제품의 로고, UI 스크린샷, 스톡 푸티지 또는 배포할 수 없는 글꼴은 사용할 수 없습니다. 글꼴: 하나의 패밀리를 명시적으로 지정합니다 (고정폭에는 CLI가 자체적으로 해결하는 "JetBrains Mono" 사용). 테스트에서 범용 ui-monospace 스택은 비례적으로 렌더링되었습니다.
  • 캡션을 읽기 쉽게 유지합니다. 대비를 확인하십시오. hyperframes check는 텍스트에 WCAG AA를 적용하므로 크림색 배경에 중간 정도의 어두운 잉크가 필요합니다.
  • 무음은 허용됩니다. 라이선스가 불분명한 음악을 추가하지 마십시오. 비상업적 조건의 AI 생성 트랙은 허용되지 않습니다.
  • 플래시 트윈은 immediateRender: false로 유지하십시오. 그렇지 않으면 레이아웃 감사에서 t=0에 흰색 오버레이가 있는 것으로 간주합니다.

검증

  • npx --yes hyperframes check는 "Check passed"로 끝나야 합니다 (린트, 레이아웃, 대비).
  • 스냅샷 프레임에는 네 개의 표면이 모두 나가기 전에 완전히 입력된 상태, 표면과 겹치는 레이블이 없음, 빈 리일 이미지 또는 절반만 로드된 리일 이미지가 없음이 표시되어야 합니다.
  • ffprobe는 1920x1080, h264, 길이가 20-30초 범위 내에 있음을 보고해야 합니다.

전달

final.mp4를 프로젝트 (index.html, assets/) 옆에 둡니다. 저장소 규칙에 따라 짧은 노트를 요청하는 경우 다음을 나열하십시오: 프롬프트, 템포 또는 비트 소스, 리일 이미지 소스, 음악 라이선스 (또는 "무음"), 렌더링 명령어. Studio (npx hyperframes preview)를 사용하여 타이밍을 다시 조정할 수 있음을 언급하십시오.

네 가지 표면 사양은 references/surfaces.md를, 타이밍 계산은 references/grid.md를 참조하십시오.

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

Build a 15-20 second product launch film that shows the product's real screen on a laptop built from plain CSS (no 3D model, no generation model) in a dark studio, scrolls the page, zooms into the interface for one key action such as typing a search, and resolves to the logo lockup. Use when someone has a full-page screenshot or screen recording of their product, one action worth showing, and a logo, and wants a short silent-friendly launch teaser rendered as a 1920x1080 MP4 with an 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 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.

관련 스킬