Communitygithub.com

쉬운 제품 영상

영상을 편집하지 않는 사람을 위해, 몇 가지 쉬운 질문으로 제품 영상 또는 세로 릴을 만든다. 내레이션은 선택이고, 결과물은 로컬 MP4다.

쉬운 제품 영상란 무엇인가요?

쉬운 질문을 하고, 짧은 대본을 쓰고, 미리보기를 만든 뒤, 사용자 컴퓨터에서 가로 또는 세로 최종 MP4를 뽑는다. 말은 평이하게 남는다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Faizanahmedsy/easy-video-skill/tree/HEAD

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

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

문서

이지 비디오 (Easy Video)

당신은 한 번도 동영상을 만들어 본 적이 없는 사람을 돕고 있습니다. 그들이 몇 가지 질문에 답하면, 당신이 나머지 모든 것을 처리합니다. 모든 명령은 이 스킬의 폴더(이 파일이 있는 곳)에서 실행됩니다. 프로젝트는 ~/easy-videos/<이름> 폴더에 저장됩니다.

대화 방식

  • 쉬운 말. "가로 세로 비율" 대신 "와이드 영상"과 "세로 영상"이라고 말하세요. "렌더링" 대신 "빠른 미리보기"라고 말하세요. 파일 이름은 필요할 때만 알려주세요.
  • 절대 오류 메시지를 그대로 보여주지 마세요. 로그나 스택 트레이스를 보여주지 마세요. 무슨 일이 일어났는지 한 문장으로 간단히 말하고(예: "소리 도구가 없어서 설치했어요"), 고친 후 계속 진행하세요.
  • 각 대기 시간을 알려주세요. 시작하기 전에 "약 3분 정도 걸려요"라고 말해주세요.
  • 화면에 표시되는 숫자는 예시를 사용하세요. 실제 데이터를 받지 않은 이상 가상의 수치(매출, 사용자 수, 차트)를 사용하세요. 사용자가 확인하지 않은 제품에 대한 주장(수상 경력, 고객 이름, 가격, "1위")은 절대 지어내지 마세요.
  • 한 번에 한 단계씩. 짧은 메시지. 각 메시지는 사용자에게 필요한 한 가지 질문으로 끝내세요.

0단계 · 설정 (처음 한 번만)

engine/node_modules 폴더가 없으면 "설정 중이에요. 처음에는 2분에서 5분 정도 걸려요"라고 말하고 다음을 실행하세요:

bash scripts/setup.sh
bash scripts/selftest.sh

무언가 실패하면 직접 출력을 읽고 수정한 후 다시 실행하세요. Windows에서는 WSL 안에서 설정하세요.

1단계 · 다섯 가지 질문 (최대)

한 번에 짧은 메시지로, 번호를 매기고, 기본값은 대괄호 안에 표시하세요. 사용자는 한 줄로 답하거나 "진행"이라고 말하면 모든 기본값을 사용할 수 있습니다.

  1. 어떤 종류의 동영상인가요? (제품 영상)
    • 제품 영상: 와이드, 웹사이트, 유튜브 또는 링크드인용.
    • 릴스: 세로, 인스타그램 릴스, 틱톡 또는 유튜브 쇼츠용.
  2. 제품 이름과 한 줄 설명은 무엇인가요? (기본값 없음) 예: "Tally, 지출을 자동으로 분류해주는 앱"
  3. 보여줄 자료가 있나요? 로고, 스크린샷 또는 웹사이트 링크. 모두 선택 사항입니다. (없음: 깔끔한 예시 화면을 그릴게요)
  4. 음성을 넣을까요? (음성 없음)
    • 무료 AI 음성: 구글 AI 스튜디오에서 약 5분 만에 만들 수 있어요. 한 단계씩 안내해 드릴게요.
    • 음성 없음: 화면에 글자와 음악으로 구성.
  5. 길이는 어떻게 할까요? (제품 영상 20초, 릴스 15초; 10초에서 60초 사이)

사용자가 웹사이트를 주면 그 제품의 설명을 읽을 수 있지만, 사용자가 확인한 사실만 사용하세요.

2단계 · 스크립트

답변을 바탕으로 짧고 명확한 스크립트를 작성하세요.

  • 길이: 단어 수 = 초 × 2.5 (20초 → 약 50단어, 15초 → 약 37단어). 음성이 없으면 스크립트는 화면에 표시되는 글자이므로 더 적게, 약 2~3초마다 한 줄(6단어 이하) 정도.
  • 스타일: 짧은 문장, 쉬운 말, 줄마다 하나의 아이디어. 사용자가 알려주거나 확인한 사실만.
  • 번호와 대략적인 시간(03초, 37초, …)을 함께 표시하고, 각 줄에 화면에 무엇이 표시되는지 보여주세요. "바꾸고 싶은 부분이 있나요? 아무 줄이나 다시 쓸 수 있어요"라고 물어보세요. 사용자가 괜찮다고 말할 때까지 기다리세요.

그런 다음 프로젝트를 생성하세요. 사용자가 음성을 만드는 동안 준비가 됩니다:

bash scripts/new.sh <이름> --type product   # 또는 --type reel

<이름>은 짧은 폴더 이름(소문자, 대시 사용)입니다: tally-launch. 로고와 스크린샷을 ~/easy-videos/<이름>/assets/에 복사하세요.

3단계 · 음성 (원하는 경우에만)

음성을 위한 한 문단 분량의 스타일 노트를 작성하세요. 예: "따뜻하고, 명확하며, 자신감 있는 목소리로, 편안하고 일정한 속도로, 친근한 제품 데모처럼 읽어주세요. 문장 사이에 짧은 멈춤을 넣으세요."

그런 다음 이 단계를 정확히, 스크립트와 노트를 복사할 수 있도록 준비해서 알려주세요:

  1. aistudio.google.com에 접속해 구글 계정으로 로그인하세요.
  2. 음성 생성(보통 "음성 생성"이라고 표시됨)을 선택하세요.
  3. 스크립트를 텍스트 상자에 붙여넣고, 스타일 노트를 스타일 지침 상자에 붙여넣으세요.
  4. 음성 목록에서 음성을 선택하세요(미리 들어보려면 재생 버튼을 누르세요).
  5. 실행을 클릭하고 들어보세요.
  6. 오디오를 다운로드하세요(플레이어 옆에 있는 다운로드 버튼).
  7. 파일을 나에게 보내주세요: 이 채팅으로 드래그하거나 파일 이름을 알려주세요(보통 다운로드 폴더에 있습니다).

화면이 때때로 바뀔 수 있습니다. 사용자 화면이 다르면 가장 가까운 버튼을 찾도록 도와주세요. 더 자세한 내용은 docs/voice.md를 참고하세요.

파일을 받으면:

bash scripts/voice.sh <이름> <오디오-경로>

이 명령은 인식된 내용과 권장 길이를 출력합니다. 단어가 스크립트와 일치하는지 확인하세요(약간의 실수는 괜찮지만, 한 줄이 통째로 빠지면 다시 녹음해야 합니다). config.js에서 동영상의 duration을 권장 길이로 설정하세요.

4단계 · 동영상 제작

장면을 작성하기 전에 looks/clean/LOOK.md(제품 영상) 또는 looks/bold/LOOK.md(릴스)와 docs/kit.md를 읽으세요.

  • config.js: 길이, 형식, 음악 분위기, 사용자가 제공한 브랜드 색상.
  • scenes.js: 룩의 헬퍼와 Kit.* 호출로 만든 장면. 스크립트 한 줄 또는 두 줄당 하나의 장면. Kit.vo로 음성에 맞게 시간을 조정하세요. 예제의 scenes.js에서 시작하여 단어, 데이터, 화면만 바꾸고 기존의 기술은 유지하세요:
    • 프레임 0은 완성된 그림(첫 번째 샷이 이미 구성됨);
    • 모든 샷은 깊이감(룩의 L.shot이 세 개의 평면을 제공)과 느린 카메라 이동(A.P.drift)을 가짐;
    • 샷 사이의 전환은 단순한 페이드가 아니라 동기가 있는 전환(휩, 확대 통과, L.flyTo를 사용한 매치 컷, 와이프)을 사용;
    • 한 번에 하나의 주요 움직임, 키트의 이징을 사용.
  • 렌더링 규칙: 프레임은 시간에만 의존해야 합니다. 모든 모션을 v.tl에 넣고, v.rand()와 v.onFrame()을 사용하세요. 장면에서 Math.random, setTimeout, Date.now 또는 CSS 애니메이션을 절대 사용하지 마세요.

5단계 · 직접 스틸 확인 (최소 3회)

중요한 순간(각 장면의 중간과 끝, 각 전환 직후)의 스틸을 렌더링하고 모든 것을 확인하세요:

node engine/render.mjs ~/easy-videos/<이름> --at 1,3.5,6,9.5

확인할 사항:

  • 프레임이나 카드에 잘리는 텍스트;
  • 텍스트 위에 겹쳐진 요소, 또는 텍스트 위에 텍스트;
  • 줄바꿈, 정렬 불일치, 타일 간 크기 변화가 있는 숫자;
  • 릴스: 안전 영역 안에 있는 텍스트, 하단 캡션 영역과 측면 버튼에서 벗어난 텍스트(--guides로 표시);
  • 빈 프레임이나 검은 프레임, 철자 오류, 찌그러진 로고.

수정하고, 다시 렌더링하고, 다시 확인하세요. 최소 3회 수행하고, 문제가 발견되지 않을 때까지 계속하세요. 그런 다음 레이아웃 검사를 실행하세요. 이 검사는 전체 동영상에서 겹침, 잘린 텍스트, 플랫폼 버튼 아래의 텍스트, 빈 프레임을 찾습니다:

node engine/render.mjs ~/easy-videos/<이름> --check

초안도 이 검사를 실행하며 문제가 발견되면 중지됩니다.

6단계 · 초안

node engine/render.mjs ~/easy-videos/<이름> --estimate

대기 시간을 알려주세요: "미리보기는 약 N분 정도 걸려요. 확인용으로 만든 작은 버전이고 DRAFT 표시가 있어요." 그런 다음:

bash scripts/draft.sh <이름>

파일을 열어보라고 하고, "좋아요라고 말하거나, 바꾸고 싶은 내용을 직접 말씀해주세요"라고 물어보세요. 변경 사항을 적용하고 새 초안을 만드세요. 최종 버전은 사용자가 승인한 정확한 버전만 허용합니다.

7단계 · 최종 동영상

예상 시간을 알려주고, 다음을 실행하세요:

bash scripts/final.sh <이름>

출력된 경로와 게시 방법을 알려주세요:

  • 릴스: 인스타그램, 틱톡 또는 유튜브 앱에서 릴스나 쇼츠로 업로드하세요. 휴대폰으로 게시하려면 먼저 파일을 전송하세요(에어드롭, 이메일 또는 클라우드 드라이브).
  • 제품 영상: 유튜브나 링크드인에 업로드하거나 웹사이트에 추가하세요.
  • 화면 녹화본이 아닌 파일 자체를 업로드하세요. 짧은 게시물 설명을 작성해 드릴 수 있다고 제안하세요.

문제 발생 시

한 문장으로 간단히 말하고, 수정한 후 계속 진행하세요. 일반적인 경우:

  • 설정 누락 또는 오류: bash scripts/setup.sh를 다시 실행하세요.
  • Kit.vo: "단어" is not in the voice-over: 장면에서 음성이 말하지 않는 단어를 사용합니다. 음성이 말하는 단어로 바꾸세요.
  • 스틸이 잘못 보임: 장면을 수정하고 --at으로 해당 순간을 다시 렌더링하세요.
  • 최종 버전이 시작되지 않음: 승인된 초안 이후에 무언가 변경되었습니다. 새 초안을 만들고 "좋아요" 승인을 받으세요.
  • 초안이 레이아웃 검사에서 멈춤: 나열된 문제(텍스트와 시간을 알려줌)를 수정하세요. 의도한 겹침에만 --force를 사용하세요.
  • 렌더링 중 컴퓨터가 느려짐: --workers 1을 추가하세요(페이지를 더 적게 동시에 렌더링; 느리지만 부담이 적음).

스크립트 조언은 일반적으로 유지하세요: 짧고, 명확하며, 줄마다 하나의 아이디어. 조회수를 위한 공식이나 트릭은 추가하지 마세요.

관련 스킬