Communitygithub.com

SingleGrain-Team/비디오-스킬

화면 녹화 영상을 큰 프레임 옆에 체크리스트와 함께 배치하여, 각 체크리스트 항목이 녹화 영상의 해당 순간에 정확히 체크되도록 모션 그래픽을 제작합니다. 제품 워크스루, 튜토리얼, 온보딩, 설치 데모 등 단계별 타임스탬프가 있는 화면 녹화 영상을 입력받아 '단계가 완료되는 과정을 시청'하는 영상을 출력합니다.

비디오-스킬란 무엇인가요?

이 스킬은 화면 녹화 영상과 타임스탬프가 포함된 단계 목록을 입력받아, 왼쪽에는 녹화 영상이 재생되고 오른쪽에는 체크리스트가 표시되는 모션 그래픽 영상을 생성합니다. 각 체크리스트 항목은 녹화 영상에서 해당 단계가 발생하는 정확한 순간에 체크 표시가 나타나며, 마지막 항목이 체크된 후에는 모든 항목이 체크된 상태로 잠시 멈춥니다. 주요 입력으로는 녹화 영상 파일, 단계 레이블과 타임스탬프(JSON 형식), 제목, 선택적 색상 팔레트가 있습니다. 출력은 1920x1080 해상도의 H.264 MP4 파일과 편집 가능한 HyperFrames 프로젝트 파일입니다. 이 스킬은 HyperFrames CLI를 기반으로 하며, 제품 데모, 튜토리얼, 온보딩 영상 등 단계별 시각적 안내가 필요한 모든 상황에 적합합니다.

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

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

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

문서

체크리스트-오버레이

왼쪽에 화면 녹화, 오른쪽에 체크리스트. 각 항목은 화면에서 해당 단계가 발생하는 순간에 체크됩니다. 마지막 체크 후 영상은 완전히 체크된 리스트를 표시하며 멈춥니다.

입력

입력설명
녹화 영상하나의 로컬 비디오 파일, 이상적으로는 16:9. 무음도 괜찮습니다.
단계37개 항목: { "label": "...", "at": <녹화 시작 후 초> }. 레이블은 짧은 명령형 문구 (약 24단어)입니다.
제목한 줄. 결과를 말하세요 ("5단계로 에이전트에 스킬 추가하기").
부제목선택적 한 줄.
색상 팔레트선택적 16진수 재정의: bg, surface, panel, ink, muted, accent, border, accentInk. 기본값은 주황색 악센트가 있는 어두운 테마입니다. accent 위에서 읽을 수 있도록 accentInk를 충분히 어둡게 유지하세요.

사용자가 타임스탬프를 제공하지 않은 경우, 녹화 영상을 스크러빙하여(ffmpeg로 1~2초마다 프레임 추출, 시각적 검사) 각 단계가 완료되거나 진행 중인 첫 프레임을 선택하세요. 추측하지 마세요.

워크플로우

  1. 프로젝트 계약을 위해 /hyperframes, /hyperframes-core, /hyperframes-cli를 로드합니다.
  2. spec.json을 작성합니다:
    { "title": "...", "subtitle": "...", "palette": { "accent": "#ff6b2b" },
      "steps": [ { "label": "앱 열기", "at": 1.5 }, { "label": "검색", "at": 7.9 } ] }
    
  3. 프로젝트 디렉토리로 구성을 생성합니다: node <skill>/scripts/create.mjs spec.json <recording.mp4> <project-dir> [--hold 2.2] 이 명령은 녹화 영상을 복사하고, 마지막 프레임을 추출하여(녹화 종료 후 화면 고정), 녹화 영상 크기에 맞춰 index.html을 작성합니다. 총 길이 = 녹화 길이 + 홀드 시간 (기본값 2.2초).
  4. npx --yes hyperframes check가 0개의 오류와 0개의 경고로 통과해야 합니다.
  5. 검증(아래 참조) 후 렌더링: npx --yes hyperframes render --workers 2 --quality delivery --output final.mp4.

타이밍 규칙

  • 체크 표시는 단계 시점에 정확히 나타나며, 절대 먼저 나타나지 않습니다. 채우기 및 체크 그리기는 t = at에서 시작되며, 그리기는 약 0.3초 후에 완료됩니다. at 이전에는 어떤 항목도 체크된 것처럼 보여서는 안 됩니다.
  • 타임스탬프는 녹화 시간 기준이며 녹화는 컴포지션 시간 0에서 시작하므로 at을 그대로 사용합니다. 녹화를 트리밍하는 경우 모든 at을 동일한 양만큼 이동하세요.
  • "다음 단계" 개요는 이전 체크 직후 다음 항목에 나타날 수 있습니다. 개요만 표시되며, 채우기나 체크 표시는 안 됩니다.
  • 각 체크가 식별될 수 있도록 체크 간격을 최소 1.5초 이상 유지하세요. 두 단계가 너무 가까우면 병합하세요.
  • 마지막 체크는 녹화 종료 최소 1.5초 전에 위치하거나, --hold를 늘려 완료된 리스트가 2초 이상 표시되도록 하세요.
  • 카운터 (n / N), 진행률 표시줄 및 프레임 링 펄스는 모두 동일한 at 값을 기준으로 하여 동기화를 유지합니다.

레이아웃 (16:9 녹화)

1920x1080 캔버스, 56px 여백. 제목과 부제목은 상단에; 녹화 프레임은 히어로로 약 1250px 너비(전체 너비의 약 65%); 체크리스트 패널은 오른쪽에 520px 열로, 프레임과 동일한 높이를 가지며 항목은 높이를 균등하게 나눕니다. 이렇게 하면 녹화 내 UI 텍스트를 읽을 수 있습니다. 프레임 너비를 약 1100px 이하로 줄이지 마세요. 더 높은 비율의 녹화의 경우 생성기가 종횡비에 따라 프레임 크기를 조정합니다. 16:9가 아닌 녹화의 경우: 프레임이 여전히 헤더 아래에 맞는지 확인하거나, 먼저 녹화를 크롭하세요.

레이블은 32px에서 두 줄로 줄바꿈됩니다. 약 26자를 초과하지 않도록 유지하세요.

검증

렌더링된 final.mp4에서 수행하세요. 스냅샷만으로는 충분하지 않습니다.

  1. 각 단계에 대해 at 0.08초 전과 0.45초 후의 프레임을 하나씩 추출합니다: ffmpeg -ss <t> -i final.mp4 -frames:v 1 f.png.
  2. 프레임을 확인합니다. 이전: 항목 미체크, 카운터 i-1. 이후: 항목 채워짐 및 체크 표시, 카운터 i, 진행률 표시줄 전진.
  3. 마지막 홀드 구간(종료 약 0.2초 전)에서 프레임 하나를 추출합니다: 모든 항목 체크됨, 카운터 N / N, 막대 가득 참.
  4. 녹화 텍스트가 프레임 내에서 읽을 수 있고 레이블이 잘리지 않는지 확인합니다. 그렇지 않은 경우 spec.json 또는 팔레트를 수정하고 재생성합니다.
  5. ffprobe로 파일을 확인합니다: 1920x1080, h264, 지속 시간 = 녹화 + 홀드.

전달

final.mp4의 경로, 지속 시간 및 사용된 단계 타임스탬프를 보고합니다. 프로젝트 디렉토리(index.html, assets/, spec.json)를 유지하여 다른 레이블이나 팔레트로 영상을 재생성할 수 있도록 합니다. 사용자가 Studio에서 편집하려는 경우 먼저 npx hyperframes preview를 엽니다.

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 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 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.

관련 스킬