Communitygithub.com

영상 생성기

대본을 바탕으로 선명하고 비용이 들지 않는 포르투갈어 내레이션 영상을 녹화합니다. 애니메이션 모드(Reels/TikTok/Shorts 1080×1920, 캐릭터, 단어별 자막, 움직이는 카메라, 배경음악 및 효과, 썸네일, 품질 관리)와 튜토리얼 모드(실제 웹 페이지 녹화, 커서, 확대/강조 포함, 2560×1440)를 지원합니다. 사용자가 영상, Reels, 썸네일을 만들거나 녹화, 편집, 수정, 또는 대본을 영상으로 변환해 달라고 요청할 때 사용하세요.

영상 생성기란 무엇인가요?

이 스킬은 포르투갈어로 대본을 입력하면 전문가 수준의 내레이션 영상을 자동 생성하는 AI Agent용 도구입니다. 두 가지 주요 모드(애니메이션 모드와 튜토리얼 모드)를 지원하며, 특히 애니메이션 모드는 Reels/TikTok/Shorts에 최적화된 1080×1920 세로 영상에 캐릭터 애니메이션, 단어 단위 자막, 항상 움직이는 카메라, 배경음악 및 전환 효과를 자동으로 추가합니다. 튜토리얼 모드는 실제 웹 페이지를 2560×1440 해상도로 녹화하며 커서 움직임, 확대/축소, 하이라이트 기능을 제공합니다. 사용자는 대본과 약간의 설정(예: 캐릭터 포즈 PNG, 색상 팔레트)만 제공하면 나머지는 자동화된 파이프라인(대본 → 각 장면별 HTML 페이지 → 음성 합성 → 동기화된 애니메이션 렌더링 → 최종 MP4 + 품질 검사 JSON + 썸네일)을 통해 처리됩니다. 터미널 명령어 기반으로 작동하며, Claude Code, Cursor, Codex 등에서 실행할 수 있습니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/scamposgabriel/gerador-de-videos/tree/HEAD/.claude/skills/gerador-de-video

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

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

문서

영상 생성기은(는) 무엇을 하나요?

포르투갈어로 응답하세요. 화면 텍스트와 내레이션은 전문 용어 없이 작성합니다. 새 영상을 시작하기 전에 docs/04_VIDEO_ANIMADO.md (애니메이션) 또는 docs/01 및 docs/02 (튜토리얼), 그리고 docs/03_QUALIDADE_E_CHECKLIST.md를 읽으세요.

애니메이션 영상 흐름 (가장 많이 요청됨)

  1. 대본 승인. 대본이 없으면 roteirista 스킬을 사용하여 사용자에게 대본 + 스토리보드를 보여준 후 녹화하세요.
  2. 템플릿 복사: videos/exemplo-bolinha-vermelha → videos/<영상-짧은-이름> (새 폴더, 예제는 절대 변경하지 마세요).
  3. roteiro.py: FALAS (한 개의 대사 = 한 개의 장면, cena="이름"), MARCA (채널 이름, 아바타), 그리고 필요하면 PERSONAGEM (포즈 PNG가 있는 폴더)을 교체하세요. saida와 saida_so_voz도 조정하세요.
  4. pagina.html: 각 장면에 대해 MONTA에 등록된 cNome(r, c) 함수를 만드세요. 템플릿의 구성 요소를 재사용하세요: quando(cena, "단어") (음성이 단어를 말하는 순간), entra() (동기화된 등장), sai(), anim(), personagem() (정확한 단어에서 포즈 변경; 손에 든 물체는 .extra로), bola()/bolaDiv(), jardim(), cachorro(), som(), 마지막 카드 (montarFim) 및 썸네일 (montarCapa, render(t < 0)에서 그림). 색상은 --fundo, --tinta, --destaque에서.
  5. 전체 녹화 전 확인: py motor/animar.py videos/<폴더> --fotos 0,3,8,15 (실제 해상도의 PNG가 saida/fotos에 생성됨)를 실행하여 장면별로 확인할 시트를 만드세요. 사운드 포함 테스트: --ate 12.
  6. 녹화: py motor/animar.py videos/<폴더>를 실행하세요. 음악이 포함된 MP4, "음성만" 버전, 그리고 saida/controle_de_qualidade.json(자동 QA: 해상도, FPS, 1초 이상 정지 이미지, 반복 프레임, 검은 화면, 볼륨 -14 LUFS, 피크)이 생성됩니다.
  7. 썸네일: py ferramentas/capa.py videos/<폴더> → saida/Capa.png.
  8. 텍스트 확인: py ferramentas/verificar_textos.py videos/<폴더> (잘리거나, 화면 밖으로 나가거나, Instagram 버튼 아래에 있는 텍스트 확인).
  9. 파일 경로를 전달하고 사용자가 듣고 확인해야 할 사항을 알려주세요 (당신은 오디오를 듣지 못합니다). 절대 게시하지 마세요.
  10. 사전 게시 (선택 사항, QA 통과 후): 차원별 편집 QA (py creative-intelligence/ci.py avaliacao modelo ...), 버전 간 훅 비교 (ci comparar) 및 예측 평가 (Higgsfield)는 비용 승인 및 자료 소유자의 허가를 받은 경우에만 가능합니다 (ci prever ... --modelo-autorizacao). engenharia-reversa 스킬의 섹션 5를 참조하세요. 녹화나 튜토리얼에 필수 사항이 아닙니다. 엔진은 이에 의존하지 않습니다.

프레임 시트 (2초 간격): ffmpeg -i saida/<비디오>.mp4 -vf "fps=1/2,scale=240:427,tile=9x3" -frames:v 1 folha.png.

튜토리얼 모드 (실제 웹 페이지)

modelos/roteiro_modelo.py를 videos/<폴더>/roteiro.py로 복사하세요. 작업은 docs/02_ACOES_DO_ROTEIRO.md를 참조하세요. 테스트: py motor/gravar.py videos/<폴더> --so 02-04; 그 다음 전체 영상을 녹화하세요.

비용이 많이 들었던 규칙 (반복하지 말 것)

  • render(t)는 오직 t에만 의존합니다 (이전 프레임에서 저장된 값 없음); 그라데이션 정지는 항상 순서대로.
  • 절대 멈추지 않기: 카메라는 항상 움직입니다 (느린 줌 + 표류); 끝난 클립은 뒤에서 앞으로 재생; 마지막 카드도 움직입니다.
  • 첫 프레임에 액션: 첫 1초에 이미 미스터리를 보여줍니다 (빈 장면이 기다리지 않음).
  • Reels (1080 × 1920): 제목은 150~440 px 사이; 자막은 약 1330 px에 최대 16자 (860 px 제한); 1600 px 아래 또는 오른쪽 (x > 960) 11001750 px 사이에는 중요한 요소를 배치하지 마세요 — Instagram 버튼 및 설명 영역.
  • 시연 대상은 크게 배치: 카메라를 가까이 당기세요; 잔디/앞 요소는 대상물 아래쪽에만.
  • "전 × 후" 비교는 두 프레임에서 동일한 구도; 그 사이에 눈에 띄는 전환 (예: 와이프).
  • 세로 영상에서 중간에 가로 띠를 넣지 마세요; 가로 클립은 세로로 잘라서 사용 (최대 확대 ~1.2배).
  • 캐릭터 PNG: 배경이 진짜 투명한지 확인하세요 (5% 색상이 영상에서 사각형으로 보입니다).
  • 의도적인 줌은 0.5초 미만으로 텍스트를 화면 밖으로 밀어낼 수 있습니다. 그 외에는 텍스트 검사기가 깨끗해야 합니다.
  • 브라우저 screencast나 Playwright 비디오를 사용하지 마세요 (흐릿하게 나옵니다). 엔진이 프레임 단위로 촬영합니다.
  • roteiro.py의 Windows 경로는 항상 r"..." 형식으로.
  • 음성: 짧은 문장; vozes.py는 숨 쉴 시간을 두고 (voz["respiro"]) 문장별로 생성합니다. 자연스러운 속도 2.4~3.2 단어/초 (엔진이 지속 시간을 표시합니다: 단어 ÷ 초).
  • 스톡 이미지 클립: 사용을 허락하는 라이선스만 (Mixkit "Free"; "Restricted"는 광고 금지); midia/CREDITOS.md에 기록.

보안

  • 음성은 외부 서비스(Edge TTS 또는 ElevenLabs)로 전송됩니다: 대본에 이름, CPF, 고객 데이터를 절대 넣지 마세요.
  • 키는 오직 ~/.secrets/에만 저장 (ElevenLabs: ~/.secrets/elevenlabs/.env); 절대 출력하지 않고, 저장소에 복사하지 마세요.
  • 시뮬레이션이나 가상 캐릭터: 화면에 표시 ("근사 시뮬레이션", "가상 캐릭터").
  • 사용자 승인 없이 유료 API 크레딧을 사용하지 마세요.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬