Communitygithub.com

릴 비디오 빌더

코드만으로 가로세로비 9:16의 짧은 수직 동영상(릴/쇼츠/틱톡/광고/설명 영상)을 무료로 제작합니다. 단어 단위 자막과 선택적 음성 해설/배경 음악 동기화를 지원합니다.

릴 비디오 빌더란 무엇인가요?

이 스킬은 사용자가 제공한 사실을 바탕으로 `reel.json` 파일을 자동 생성하고, Node.js 기반의 @napi-rs/canvas 및 ffmpeg를 사용하여 1080×1920 해상도의 MP4 동영상을 완전히 코드로 제작합니다. 사용자는 별도의 영상 편집 소프트웨어, AI 영상 생성, 브라우저, 유료 도구 없이 명령어만으로 전문적인 짧은 동영상을 만들 수 있습니다. Claude, Cursor, Codex 등 터미널 기반 AI 에이전트에서 동작하며, 영어와 힌디어를 기본 지원하고 사용자 추가 폰트로 다른 문자도 지원합니다. 스킬은 엄격한 규칙(사실 추측 금지, 무료 옵션만 사용, OS별 정확한 명령어 제공)을 따르며, 작업 흐름은 사실 정리 → 대본 제안 → `reel.json` 작성 → 검사(doctor/lint/stills) → 오디오 동기화(선택) → 렌더링 → QA로 구성됩니다. 광고 유형일 경우 플랫폼 정책을 검색(가능할 때)하여 부적절한 주장을 사전 차단합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add 22devpatel007-coder/short-video-genration-skill

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

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

문서

릴 비디오 빌더은(는) 무엇을 하나요?

하나의 파일 reel.json을 사용하여 1080×1920 MP4를 만듭니다. Node.js, @napi-rs/canvas 및 ffmpeg(번들)를 사용합니다. 모든 작업은 무료이며 사용자 자신의 컴퓨터에서 실행됩니다. AI의 역할은 사용자의 실제 사실을 바탕으로 reel.json을 작성하고, 검사를 실행하며, 사용자를 안내하는 것입니다. 전체 상세 내용은 README.md에, 스키마는 references/spec.md에 있습니다.

규칙 (엄격)

  1. 추측 금지. 입력이나 사실이 누락된 경우 질문하십시오. 통계, 가격, 평점, 사용 후기, 결과 또는 제품 주장을 절대 만들어 내지 마십시오. 데모나 가상 숫자를 포함하지 마십시오.
  2. 무료만 사용. 유료 도구, 유료 요금제 또는 유료 스톡 영상을 추천하지 마십시오. references/script-and-audio.md의 무료 옵션을 사용하십시오.
  3. 간결하게. 누락된 것만 한 번의 메시지로 물어보십시오. 합리적인 기본값을 사용하고 가정을 한 줄로 명시하는 것을 선호합니다.
  4. 사용자 OS에 맞는 정확한 명령어를 제공하십시오(모를 경우만 질문). 실행할 수 없는 것이 있으면 그렇게 말하고 테스트되지 않은 것을 나열하십시오.
  5. 프로젝트 폴더 안에 머무르십시오. 비밀 정보나 네트워크 호출을 비디오 코드에서 사용하지 마십시오.
  6. 확실히 더 나은 옵션이 있다면 한두 줄로 제안하고 사용자가 선택하도록 하십시오.
  7. 광고(meta.kind: "ad")의 경우: 플랫폼의 현재 정책(검색 도구가 있을 때 검색)에 따라 흐름과 주장을 확인하십시오. 리뷰 게이팅 방식, 오도하는 전후 비교, 검증되지 않은 결과, 과장된 결과를 면책 조항 없이 대본에 쓰기 전에 플래그를 지정하십시오.

입력(누락된 것만 질문)

브랜드 이름, 핸들, 한 줄 제품 설명; 해결하는 문제; 허용 및 금지된 사실; 길이(30초는 57줄, 5060초는 10~12줄); 자막 언어 및 음성 언어; 색상 팔레트(hex); 로고 PNG; CTA(행동 및 보상, 예: 키워드 및 제안 조건); 음성이 녹음/생성될지 또는 동영상을 무음으로 할지; 사용자 OS.

작업 흐름

  1. 사실: 사용된 사실과 제외된 사실을 나열합니다.
  2. 대본: 표(참고: references/script-and-audio.md)를 제안합니다: 번호, 시간, 장면 유형, 음성 해설(say), 감정, *강조*가 포함된 자막. 페이싱 확인(초당 2~2.5단어). 승인될 때까지 반복합니다.
  3. 프로젝트 폴더에 reel.json을 작성합니다(template/ 복사). references/spec.md의 일곱 가지 장면 유형 중에서 선택합니다. 한 줄에 하나의 시각 요소. 새로운 장면 유형이 정말 필요하지 않으면 엔진을 편집하지 마십시오.
  4. 점검: npm install을 한 번 실행(사용자가 직접 실행할 수 없는 경우 사용자가 수행), 그다음 npm run doctor, npm run lint, npm run stills를 실행하고 stills/reel/contact.png를 확인합니다. 모든 lint 오류를 수정합니다.
  5. 오디오, 무료 경로: audio/ 디렉터리에 01..NN 이름의 파일을 줄당 하나씩 녹음 또는 생성(npm run tts는 무료 edge-tts 패키지로 이 작업 가능), 선택적으로 audio/music.*, 그다음 npm run sync. 무음 경로: npm run estimate.
  6. npm run render는 out/reel.mp4를 생성합니다(20초 동영상당 약 30초 작업).
  7. 휴대폰에서 QA: 자막 안전 영역, 자막과 오디오 동기화, 맞춤법, 로고, 제안 조건, 과장된 결과에 대한 면책 조항.

기술 규약(위반 금지)

  • 그리기는 시간과 스펙의 순수 함수입니다: 난수, 시계, 타이머 또는 애니메이션 콜백 없음.
  • 안전 영역 및 자막 규칙은 lint.mjs에 의해 강제됩니다; 절대 우회하지 마십시오.
  • 타이밍은 timings.json(오디오 또는 추정)에서 가져옵니다. 줄 수가 스펙과 다르면 거부됩니다.

출력

결정 사항, 작성된 파일, 정확한 명령어, 테스트되지 않은 것, 그리고 여전히 필요한 것을 포함하여 답변하십시오. 실행 단계와 함께 프로젝트 폴더(zip 또는 파일 트리)를 전달하십시오.

알려진 함정

npm run 오류에서 패키지 누락: 사용자가 잘못된 폴더에 있거나 프로젝트 내에서 npm install을 실행하지 않았습니다. 자막의 누락된 글리프: theme.fontFiles로 폰트를 추가합니다. ffmpeg failed: npm run doctor를 실행합니다. 긴 동영상은 최종 MP4에만 디스크가 필요합니다(프레임은 파이프로 전달되며 저장되지 않습니다).

관련 스킬