Communitygithub.com

grid-videos-creation

1080x1350 (30fps, 36.0s) 그리드 포트폴리오 및 인트로 모션 그래픽 비디오 제작을 위한 종단간 워크플로우 및 기술 사양입니다. 참조 비디오("ref video")와 사용자 맞춤 에셋("My Data")을 기반으로 사용자의 반복적 지시 방법을 따릅니다.

grid-videos-creation란 무엇인가요?

이 스킬은 **1080x1350 해상도, 30fps, 36.0초 길이**의 그리드 포트폴리오 및 인트로 모션 그래픽 비디오를 제작하기 위한 완전한 워크플로우와 기술 사양을 제공합니다. Claude Code, Cursor, Codex와 같은 AI 에이전트가 **참조 비디오(`ref video/ref video.mp4`)** 의 프레임 타이밍, 이징 곡선, 전환 효과를 정확히 분석하고, **`My Data/` 폴더**에 있는 사용자 맞춤 이미지, 텍스트 파일을 사용하여 동일한 스타일의 비디오를 생성할 수 있도록 설계되었습니다. 이 스킬의 핵심은 **두 단계의 작업 방식**입니다. 첫 번째 단계에서는 사용자의 초기 프롬프트를 바탕으로 참조 비디오를 완벽히 분석하여 첫 번째 `Final Video.mp4`를 생성합니다. 두 번째 단계에서는 사용자가 제공하는 짧고 구체적인 수정 지시(예: '오른쪽 텍스트 스택에서 나이 제거', '캐릭터 아웃라인을 흰색으로 변경', '검색창 역할 텍스트 색상을 Let's Connect 색상과 동일하게')를 하나씩 빠르게 반영하여 비디오를 정교하게 다듬습니다. 기술적으로는 **빠른 렌더링 및 인코딩**을 위해 `scripts/generate_video_fast.py` 스크립트를 사용하며, 정적 프레임 바이트 캐싱(`STATIC_RANGES`)과 메모리 효율적인 매팅(matte) 처리로 1,080프레임 전체를 **약 12~16초** 내에 처리합니다. 또한, `3:4` 비율의 소스 이미지를 `4:5` 비율의 비디오 캔버스에 맞추는 정확한 리샘플링 및 크롭 로직, 장면별 상세한 프레임 구성(예: `"Helloo"` 애니메이션, 캐릭터 팝업, 지수 확대 전환, 검색창 역할 순환, 방사형 그리드 모자이크 및 3-필 아웃트로) 등이 사양에 포함되어 있습니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/abdulahadofficial432-arch/Gemini_Argon_Video_Skills/tree/HEAD/.agents/skills/grid-videos-creation

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

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

미리보기

스킬 README에서

입력 에셋 개요
1장면 인트로 및 캐릭터
2장면 검색창 애니메이션
3장면 모자이크 및 최종 아웃트로

문서

그리드 비디오 제작(Grid Videos Creation)

그리드 포트폴리오 / 인트로 모션 그래픽 비디오(1080x1350, 30 fps, 36.0s, H.264 비디오 + AAC 오디오)를 참조 비디오(ref video/ref video.mp4) 및 커스텀 이미지/텍스트 에셋(My Data/)을 기반으로 모델링하여 생성하거나 업데이트할 때 이 스킬을 사용하세요.


1. 지시 사항 전달 방법 (사용자 워크플로우 방식)

사용자가 프로젝트를 구성하고 지시 사항을 전달하는 방식을 이해하는 것은 이 워크플로우를 원활하게 실행하는 데 필수적입니다.

1단계: 폴더 설정 및 초기 프롬프트

  1. ref video/ 폴더: 대상 모션 그래픽 참조 비디오(ref video.mp4, 1080x1350, 30 fps, 36.0s)를 포함합니다. 정확한 프레임 타이밍, 이징 곡선, 사운드 효과(-c:a copy) 및 전환이 마스터 청사진으로 사용됩니다.
  2. My Data/ 폴더: 해당 인물의 맞춤 에셋을 포함합니다:
    • Grid Background.jpg — 1장면과 3장면에 사용되는 어두운 올리브 갈색 그리드 배경입니다.
    • Character.jpg — 단색의 어두운 배경과 피사체 주변의 선명한 흰색 컷아웃 외곽선이 있는 초상화입니다.
    • Plain Background.jpg — 1장면에서 2장면으로의 확대 전환에 사용되는 단색 올리브 녹색 배경입니다.
    • Bar.jpg — 중앙에 유리 형태 검색창(y = 646)이 있는 올리브 녹색 배경입니다.
    • Outro example.jpg 및 Outro example 2.jpg — 소셜 알약(in, Bē) 및 하단 "Let's Connect." 타이포그래피의 레이아웃 참조입니다.
    • Name and age and role.txt — 해당 인물의 이름, 주요 역할 및 전문 배지 텍스트를 지정하는 텍스트 파일입니다.
  3. 초기 프롬프트 스타일:

    "'ref video'를 완전히, 주의 깊게, 100% 분석한 후 'My Data' 폴더의 데이터를 사용하여 'ref video'와 동일한 스타일과 형식으로 똑같은 비디오를 만드세요."

2단계: 빠른 반복 시각적 개선

첫 번째 생성된 Final Video.mp4를 검사한 후, 사용자는 한 번에 하나씩 짧고 목표 지향적인 개선 지시를 제공합니다. 일반적인 개선 지시는 다음과 같습니다:

  • 속도 및 작업 처리: "'Render and encode Final Video.mp4' 작업을 종료하지 마세요. 이 프로세스를 빠르게 만드세요" → 항상 모든 1,080프레임을 약 12~16초 내에 렌더링 및 인코딩하는 빠른 정적 프레임 캐싱 스크립트(scripts/generate_video_fast.py)를 사용하세요.
  • 오른쪽 텍스트 스택 사용자 정의: "나이를 제거하고 'Jobless' 대신 'Your'를 추가하세요" 및 "시작 텍스트 'Your'를 굵게 표시하세요" → 나이 라인을 생략하고, 바로 굵은 "Your"로 시작한 다음, 주요 역할("Sr UI/UX")을 입력하고, 굵은 "Designer"를 슬라이드 인한 후, 기울어진 "Graphics Expert ❤" 알약 배지를 바운스 인합니다.
  • 캐릭터 컷아웃 외곽선 색상: "캐릭터 외곽선을 올리브색이 아닌 흰색으로 원합니다" → 1장면(Character.jpg)에서 캐릭터 컷아웃 주변의 원래 선명한 흰색 스티커 외골격을 유지하고, 2장면으로 전환하는 동안 캐릭터의 올리브 히잡을 확대합니다.
  • 애니메이션 검색창 역할 텍스트 색상: "흰색 대신 애니메이션 역할 텍스트를 'Let's Connect' 텍스트와 동일한 색상으로 만드세요" → 순환하는 중간 역할 텍스트(Creative, Brand, UI/UX, Web Graphics, Social Media, Creative Ads, Book Cover, One)를 시그니처 크림-라임 색상(#E7F3D0 / RGB(231, 243, 208))으로 렌더링하고, "Your"와 "Designer" / "Design" / "partner"는 진한 차콜(RGB(35, 38, 22))로 유지합니다.
  • 아웃트로에 연락처 알약 추가: "gmail 영역을 만들고 이 Gmail '[email protected]'을 Behance 아래 끝에 추가하세요" → Behance 아래에 알약 컨테이너를 복제하고, 왼쪽에 일치하는 원형 메일 아이콘 배지를 배치한 후 세 번째 알약 내부에 이메일 주소를 렌더링합니다.

2. 시각적 참조 및 콘텐츠 스크린샷

A. 입력 에셋 (My Data/ 폴더)

입력 에셋 개요

B. 1장면: 애니메이션 "Helloo" 인트로, 흰색 외곽선 캐릭터, 굵은 "Your", 및 배지 (00:00 – 00:18)

1장면 인트로 및 캐릭터

C. 2장면: 검색창 역할 순환 (#E7F3D0 크림-라임) 및 "Let's Connect" (00:19 – 00:32)

2장면 검색창 애니메이션

D. 3장면: 방사형 그리드 모자이크 전환 및 최종 3-필 아웃트로 (00:33 – 00:36)

3장면 모자이크 및 최종 아웃트로


3. 전체 기술 사양 (1080x1350 @ 30 fps, 1,080프레임)

색상 팔레트 및 글꼴

요소RGB 값Hex사용처
CREAM (Let's Connect 색상)(231, 243, 208)#E7F3D0"Helloo", 1장면 텍스트, 2장면 애니메이션 역할 제목(Creative .. One), "Let's Connect", 아웃트로 알약 및 "Let's Connect."
DARK_TEXT(35, 38, 22)#232616"Your", "Designer", "Design", 2장면의 필기체 "partner"
OLIVE_BG(105, 101, 63)#69653F단색 올리브 배경(Plain Background.jpg) 및 "Graphics Expert ❤" 알약 채우기
DARK_CIRCLE_ICON(48, 51, 34)#3033223장면 크림색 원 내부의 컷아웃 아이콘(in, Bē, ✉)
캐릭터 외곽선(255, 255, 255)#FFFFFF캐릭터 초상화 주변의 선명한 흰색 스티커 외곽선
  • 글꼴 (Poppins 패밀리):
    • Poppins-Regular.ttf ("I am <Name>"용 28px, 입력된 "Sr UI/UX"용 34px, 애니메이션 바 역할 및 "Let's "용 40px, "Graphics Expert" 배지용 2배 슈퍼샘플링 48px)
    • Poppins-SemiBold.ttf (오른쪽 굵은 "Your" 및 "Designer"용 36px, 바 "Your ", " Designer" 및 "Connect"용 40px)
    • Poppins-Light.ttf + Poppins-Regular.ttf (3번째 아웃트로 알약 내 Gmail 주소용 혼합 35px)

종횡비 매핑 (3:4 소스 이미지 → 4:5 비디오 캔버스)

My Data/의 소스 이미지는 896x1200 또는 1792x2400(3:4 종횡비)인 반면, 대상 비디오 캔버스는 1080x1350(4:5 종횡비)입니다.

  • 3:4를 직접 4:5로 늘리지 마십시오. (원과 얼굴을 수직으로 6.6% 찌그러뜨림)
  • 항상 너비를 1080(1080x1446, Image.Resampling.LANCZOS)으로 조정하고 수직으로 1350px를 크롭합니다:
    • Grid Background.jpg: .resize((1080, 1446)).crop((0, 48, 1080, 1398))
    • Plain Background.jpg & Bar.jpg: .resize((1080, 1446)).crop((0, 37, 1080, 1387))

장면별 프레임 분석

  1. F0001 – F0159 (0.00s – 5.30s) — "Helloo" 눈 애니메이션 및 슬라이드 업:
    • ref video.mp4 프레임 f_0001..f_0159에서 녹색 채널 매팅(np.clip((g - 42.0) / (240.0 - 42.0), 0.0, 1.0))을 통해 "Helloo" 알파 마스크를 추출하고 Grid Background.jpg 위에 CREAM을 합성합니다.
  2. F0159 – F0190 (5.30s – 6.33s) — 캐릭터 팝업 및 미소 곡선:
    • 연결 구성 요소 레이블링(scipy.ndimage.label)을 (0, 0)부터 사용하여 Character.jpg의 외부 어두운 배경을 제거하여 내부 어두운 영역(눈/눈썹)은 그대로 두고 흰색 외곽선을 유지합니다.
    • PchipInterpolator를 사용하여 F0159..F0187 동안 캐릭터가 y_offset = 1050에서 0으로 상승(CHAR_X = 58, CHAR_Y = 306)하는 애니메이션을 만듭니다.
    • 첫 번째 "o" 아래의 애니메이션 미소 곡선을 y=[402, 445], x=[818, 910] 범위 내에서 엄격하게 추출합니다(참조 비디오 캐릭터 머리의 하단 픽셀을 피함).
  3. F0204 – F0220 (6.80s – 7.33s) — 왼쪽 텍스트 "I am <Name>":
    • "I ", "am ", "<Name>"을 (71, 418)에서 CREAM(Poppins-Regular, 28px)으로 순차적으로 슬라이드 업합니다.
  4. F0270 – F0547 (9.00s – 18.23s) — 오른쪽 스택 (Your → Sr UI/UX → Designer → 배지):
    • F0270 – F0286: 굵은 "Your" (Poppins-SemiBold, 36px, 오른쪽 정렬 x = 1038)가 y = 770에서 슬라이드 인합니다.
    • F0307 – F0334: 애니메이션 포인터 커서가 이동하여 F0324..F0330에서 (1032, 795)를 클릭합니다.
    • F0330 – F0345: 굵은 "Your"가 52px 위로 부드럽게 이동(y = 718)하고 2번째 줄(y = 770)에 타이핑 커서 |가 나타납니다.
    • F0354 – F0465: 타자기 애니메이션이 키보드 오디오 클릭과 동기화되어 "Sr UI/UX"를 문자별로 입력합니다.
    • F0466 – F0480: 굵은 "Designer" (Poppins-SemiBold, 36px)가 y = 820 위치로 슬라이드 다운됩니다.
    • F0499 – F0524: 기울어진 올리브 알약 배지 "Graphics Expert ❤" (-4° 각도, 슈퍼샘플링된 파라메트릭 벡터 하트 포함)가 아래에서 바운스 업되어 3줄 텍스트 스택을 탄력 물리 바운스(dy = -90px 피크, dy = -28px로 안정화)로 밀어 올립니다.
  5. F0547 – F0574 (18.23s – 19.13s) — 지수 확대 카메라 전환:
    • 올리브 히잡(fx = 445, fy = 360)으로 지수적으로 확대(scale = 45.0 ** (ease_in_out_cubic(t) ** 0.95))하고 Plain Background.jpg로 크로스 페이드(F0556..F0574)합니다.
  6. F0582 – F0836 (19.40s – 27.87s) — 검색창 역할 순환:
    • Bar.jpg(F0582..F0605)와 "Your Creative Designer"를 y = 646에 중앙 정렬하여 페이드 인합니다.
    • 프레임 619, 651, 679, 706, 736, 770, 799에서 8개 역할(Creative, Brand, UI/UX, Web Graphics, Social Media, Creative Ads, Book Cover, One)을 모두 순환합니다.
    • "Your " 및 " Designer"는 DARK_TEXT((35, 38, 22), Poppins-SemiBold)로, 애니메이션 중간 역할은 CREAM((231, 243, 208), Poppins-Regular)으로 렌더링합니다.
  7. F0840 – F0995 (28.00s – 33.17s) — "Your One Design partner" 및 "Let's Connect":
    • F0840 – F0887: "Your One Designer"가 "Your One Design"으로 변경되고 왼쪽으로 이동하며, 필기체 "partner"(f_0875.jpg[620:682, 680:860]에서 추출)가 오른쪽에서 슬라이드 인합니다.
    • F0888 – F0913: "Your One Design partner"가 검색창 위로 상승(y = 646 → 542)하고 "Let's Connect"(CREAM)가 검색창 내부에 페이드 인됩니다.
    • F0953 – F0970: 커서가 "Let's Connect"로 이동하여 클릭(F0958..F0960)하고 오른쪽으로 나갑니다.
    • F0964 – F0995: 거대한 "Let's Connect."(Outro example 2.jpg)가 캔버스 하단(y = 1350 → 975)에서 상승합니다.
  8. F0996 – F1080 (33.20s – 36.00s) — 방사형 그리드 모자이크 공개 및 3-필 아웃트로:
    • F0996 – F1014: 방사형 파동(cx0 = 540, cy0 = 580)이 어두운 그리드 배경을 셀별로(20x23 그리드 셀) 강조된 셀 테두리와 함께 공개합니다.
    • F1015 – F1080: "Let's Connect." 위에 3개의 균일한 간격의 연락처 알약(y_top = 270, 수직 중앙 간격 179px)이 있는 최종 아웃트로 화면을 유지합니다:
      1. LinkedIn: in 배지 + 핸들 (imsyedamuskan)
      2. Behance: Bē 배지 + 핸들 (syedamuskan902)
      3. Gmail: ✉ 봉투 배지 + 이메일 ([email protected])

4. 빠른 렌더링 및 인코딩 (~12–16초)

약 12~16초 내에 비디오를 렌더링하거나 업데이트하려면:

  1. scripts/generate_video_fast.py를 실행합니다:
    python "C:\Users\WayWe Work-Station\Downloads\Make video\Skills\scripts\generate_video_fast.py"
    
  2. 빠르고 절대 멈추지 않는 이유:
    • FFmpeg 파이프 데드락 없음: stderr=subprocess.PIPE 없이 ffmpeg -loglevel error를 호출하여 OS 파이프 버퍼가 stdin.write()를 차단하지 않습니다.
    • 정적 프레임 바이트 캐싱 (STATIC_RANGES): frame[fn] == frame[fn - 1]인 모든 509개의 정적 프레임에서 원시 rgb24 바이트 버퍼(prev_bytes)를 재사용하여 고유 프레임 렌더링을 1,080개에서 571개로 줄입니다.
    • 대상 해상도 컷아웃 매팅: 전체 1792x2400 해상도 대신 대상 규모(779x1044)에서 scipy.ndimage 캐릭터 알파 매트를 계산하여 초기화 시간을 0.38초로 단축합니다.

Individual skills in this repo

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

관련 스킬