Community코딩 & 개발github.com

saranambiar/hyperframes-video-agent-skills

에이전트 주도 비디오 제작을 위한 재사용 가능한 스킬, 스크립트, 프로덕션 워크플로우입니다. HyperFrames, FFmpeg, 자막, 오디오 동기화, 렌더 QA를 포함합니다. 실제 HyperFrames 비디오 작업을 기반으로 한 커뮤니티 프로젝트입니다.

hyperframes-video-agent-skills란 무엇인가요?

이 스킬은 AI 에이전트가 HyperFrames, FFmpeg, 자막, 오디오 동기화, 렌더 품질 보증(QA)을 사용하여 전문적인 비디오를 제작할 수 있도록 지원합니다. 'Product Demo Integration' 문서를 통해 제품 화면 녹화를 편집하는 전체 워크플로우를 제공합니다: 인테이크(녹화 분석, 필수 순간 식별, 자막 동기화 요청 분석), 크롭/줌 결정(UI 보존 우선), 전환(이전 장면에서 부드럽게 전환, 내레이션과 동기화), 렌더 QA(각 크롭 피크 및 제품 상태 확인), 최종 출력 생성(증명 프레임 포함)을 포함합니다. 이 스킬은 Cursor, Claude Code, Codex 등의 개발 환경에서 사용할 수 있으며, HyperFrames의 공식 저장소가 아닌 커뮤니티 프로젝트입니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add saranambiar/hyperframes-video-agent-skills

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

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

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

문서

제품 데모 통합

최종 비디오에 제품 영상이 포함될 때 이 스킬을 사용하세요.

인테이크

편집 전:

  • 녹화 길이, 해상도, 프레임 속도, 오디오를 확인하세요.
  • 녹화에 캔버스, 브라우저 프레임, 커서, 확대/축소, 스크롤, 데드 타임이 포함되어 있는지 확인하세요.
  • 필요한 제품 순간과 해당 타임스탬프를 확인하세요.
  • 제품 상태와 일치해야 하는 내레이션 구절을 확인하세요.
  • 중요한 UI가 잘릴 수 있는 경우 공격적인 크롭 전에 승인을 요청하세요.

크롭 결정

기본적으로 배경 캔버스를 제거하는 것보다 UI를 보존하세요.

크롭은 다음 경우에만 사용하세요:

  • 중요한 UI가 확대/축소 및 스크롤 내내 계속 표시됩니다.
  • 크롭이 제목, 레이블, 커서 컨텍스트 또는 최종 상태를 자르지 않습니다.
  • 증명 프레임이 가장 타이트한 확대에서도 여전히 작동함을 확인합니다.

크롭 없음 또는 가벼운 크롭은 다음 경우에 사용하세요:

  • 녹화가 다른 영역으로 확대/축소됩니다.
  • 제품 순간이 캔버스 주위를 이동합니다.
  • 사용자가 이미 크롭된 출력이 주요 텍스트를 잘랐다고 말합니다.

체크리스트는 references/crop-and-zoom.md를 읽으세요.

제품 영상으로 전환

  • 이전 장면의 마지막 프레임에서 시작하세요.
  • 연속성이 요청된 경우 하드 컷보다는 카메라 스와이프 또는 푸시 동작을 사용하세요.
  • 제품 녹화의 현재 첫 번째 프레임에 도달하세요.
  • 녹화가 데드 타임으로 시작하는 경우, 동기화를 깨뜨리지 않는 경우에만 트리밍하세요.
  • 제품 순간이 내레이션과 일치해야 하는 경우, 이후의 모든 동기화를 변경하지 말고 해당 순간 이전의 세그먼트를 재시간 조정하세요.

전환 종료

  • 시청자가 인식할 수 있도록 마지막 의미 있는 제품 상태를 충분히 유지하세요.
  • 요청된 경우 다음 장면으로 카메라 스와이프를 생성하세요.
  • 화면 녹화 끝에 우발적인 빈 프레임이 없도록 하세요.
  • 전환 경계에서 증명 프레임을 추출하세요.

QA

  • 첫 번째 제품 프레임을 확인하세요.
  • 모든 확대 피크를 확인하세요.
  • 필요한 모든 제품 상태를 확인하세요.
  • 전환 시작/종료를 확인하세요.
  • 자막이 제품 UI를 덮지 않는지 확인하세요.

출력

반환:

  • 사용된 소스 녹화.
  • 크롭/크롭 없음 결정.
  • 트림/재시간 조정 세그먼트.
  • 렌더 경로.
  • 가장 타이트한 크롭 및 주요 제품 순간에 대한 증명 프레임.

제품 순간 맵

편집 전 순간 맵을 생성하세요:

  • 녹화 타임스탬프.
  • 표시되는 내용.
  • 내레이션 구절.
  • 원하는 글로벌 타임스탬프.
  • 커서가 중요한지 여부.
  • 스크롤 위치가 중요한지 여부.
  • 자막이 겹치는지 여부.
  • 크롭이 안전한지 여부.

이 맵을 사용하여 트림 및 재시간 조정을 결정하세요.

크롭 결정 매트릭스

크롭 없음을 선택하세요:

  • 사용자가 캔버스/배경을 수락하는 경우.
  • 확대/축소가 화면 전체를 이동하는 경우.
  • 주요 텍스트가 타이트한 크롭에 의해 잘리는 경우.
  • 제품 상태가 세련미보다 더 중요한 경우.

가벼운 크롭을 선택하세요:

  • 캔버스가 산만하지만 UI가 중앙에 유지되는 경우.
  • 자막에 더 많은 공간이 필요한 경우.
  • 브라우저 크롬 또는 데드 마진을 안전하게 제거할 수 있는 경우.

동적 크롭은 다음 경우에만 선택하세요:

  • 각 크롭 사각형이 매핑된 경우.
  • 움직임이 의도적으로 느껴지는 경우.
  • 모든 주요 제품 상태에 증명 프레임이 있는 경우.

내레이션 동기화

제품 상태를 음성 구절과 동기화:

  • 구절 전에 전환을 시작하여 구절이 시작될 때 제품이 표시되도록 하세요.
  • 이해가 중요한 경우 최종 제품 프레임을 구절 후에 유지하세요.
  • 제품 스크롤을 부자연스럽게 빠르게 하는 대신 순간 전 영상을 느리게 하세요.
  • 제품 상태에 도달하기 위해 내레이션의 중간 단어를 자르지 마세요.

화면 녹화 정리

확인:

  • 커서 가시성.
  • 브라우저 UI.
  • 알림 팝업.
  • 데드 타임.
  • 빈 로딩 화면.
  • 우발적인 데스크톱 가장자리.
  • 스크롤 속도.
  • 확대/축소 초점.

제품 선명도에 해를 끼치지 않는 경우에만 제거하거나 숨기세요.

자막 안전

자막이 고정된 경우:

  • 하단 탐색 모음을 확인하세요.
  • 제품 테이블을 확인하세요.
  • 모달 버튼을 확인하세요.
  • 타임라인 컨트롤을 확인하세요.
  • 필요한 경우 자막 여백을 이동하거나 다른 증명 프레임을 선택하세요.

사용자 승인 지점

다음 전에 승인을 요청하세요:

  • 보이는 캔버스를 크롭하는 경우.
  • 커서를 제거하는 경우.
  • 영상을 극적으로 빠르게 하는 경우.
  • 제품 세부 정보를 흐리게 하거나 마스킹하는 경우.
  • 실제 영상을 재현된 UI로 대체하는 경우.

전달 형식

보고:

  • 사용된 제품 클립.
  • 크롭 전략.
  • 트림 지점.
  • 재시간 조정 비율.
  • 주요 증명 프레임.
  • 의도적으로 불완전하게 남겨진 UI.

관련 스킬