Communitygithub.com

bp-abe/skills-video

애니메이션 비디오(Remotion, MP4 16:9 및/또는 9:16)를 처음부터 끝까지 제작합니다. 주제, 대본, 느슨한 메모 또는 지침에서 시작해 콘텐츠를 기반으로 컨셉을 창조하거나 특정 스타일 라인을 따르며, 로컬 음성 복제 또는 Gemini TTS, Lyria 또는 코드로 작곡한 배경 음악, 그리고 다양성 검증과 독립 비평가 리뷰를 포함한 CC0 효과를 사용합니다. 또한 녹화된 비디오 편집(무음 및 잘못된 테이크 제거, 확대/축소, 단어별 자막, Premiere용 XML) 기능을 제공합니다.

skills-video란 무엇인가요?

이 기술은 고품질 애니메이션 비디오 제작을 위한 완전 자동화 기술입니다. 사용자가 주제, 대본, 메모, 지침 등 어떤 형태로든 요청을 하면, 기술이 리서치, 대본 작성, 컨셉 개발부터 음성, 배경 음악, 자산 생성, 렌더링 및 배포까지 전체 파이프라인을 자동으로 실행합니다. Remotion을 기반으로 하며 MP4 16:9 및 9:16 출력을 지원하고 클론된 VoxCPM2 음성(내부용) 또는 Gemini TTS, Lyria 또는 코드 기반 배경 음악, CC0 라이선스 효과를 사용합니다. 주요 특징은 간결한 브리프 기반 작업, 컨셉 다양성 확보, 엄격한 품질 관문, 그리고 독립 비평가를 통한 리뷰입니다. 기술은 직관적인 인터페이스를 제공하며, 오프라인 모드, 녹화된 비디오 편집 기능도 내장하고 있습니다. Claude Code, Cursor, Codex를 포함한 주요 AI 에이전트 플랫폼에서 사용 가능합니다.

지원 대상✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/bp-abe/skills-video/tree/HEAD/video-animado

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

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

문서

애니메이션 비디오 (Remotion)

인프라일 뿐, 취향은 아닙니다. 이 기술은 모델이 스스로 가져오지 못하는 것들을 저장합니다 — 도구(음성, 배경 음악, 렌더링, 텍스트 추출), 회사 컨텍스트(승인된 음성, API 키, 방화벽, 라이선스), 진실 규칙, 수치 기반 기술, 리뷰 및 기술 교훈 — 그리고 비디오의 모양을 규정하지 않습니다. 스타일, 장치, 외관은 매 비디오마다 콘텐츠에서 탄생합니다. 기술을 발전시킬 때, 항상 읽히는 내용에 외관 예시, 미적 레시피 또는 "기본" 컴포넌트를 절대 추가하지 마십시오. 그것은 중독되고 반복됩니다.

읽을 것

항상필요 시
이 파일 · APRENDIZADOS.md (기술) · direcao.md (직무)gemini.md (음성, API, 기능) · assets.md (라이선스, 자산 출처) · edicao.md (녹화) · critica.md (리뷰) · referencias.md (요청이 연구된 비디오 중 하나를 언급할 때만) · biblioteca/ (컨셉 선택 후에만) · VIDEOS.md 및 이전 프로젝트 (스타일 라인이 요청된 경우에만 — "다른 사람들이 어떤 음성을 사용했는지" 확인하는 용도 금지) · historico/ (문제가 익숙해 보일 때)

요청 읽기

기술은 감독 역할을 합니다: 요청이 원하는 바를 이해하고 행동합니다. 질문 목록을 만들지 않으며, 차단 요소(모호한 정치/역사적 프레임, 소스가 해결하지 못하는 사실, 불확실한 사용 권리)에 대해서만 추천과 함께 질문합니다.

요청에 포함된 내용…수행할 작업
주제만 있음모든 것을 생성(리서치, 대본, 컨셉, 음성, 배경 음악)하여 바로 전달합니다.
대본텍스트는 그대로 유지(별도로 선택적 조정 제안); 브리프를 보여주고 확인 후 제작("바로 진행"은 생략).
메모, 이야기, 키워드이를 기반으로 대본 작성(어조, 컷, 익명화) 후 제작 전에 대본 + 브리프를 보여줍니다.
콘텐츠 없는 문의 ("~에 어떤 애니메이션을 추천하나요…")컨셉을 선택하지 않음: 컨셉은 텍스트에서 탄생합니다. 선택이 무엇에 달려 있는지 설명하고 콘텐츠를 요청합니다.
제안 요청브리프만 (PROPOSTA.md).
구체적인 지침엄격히 따름; 명시되지 않은 부분에만 자유를 둡니다.
편집할 녹화본편집 모드: edicao.md.
기존 비디오 조정해당 부분만 변경하고 다시 렌더링합니다.
스타일 라인 ("비디오 X와 같게", "시리즈")VIDEOS.md의 항목을 로드하고, 해당 프로젝트의 tema.ts 및 조각을 복사하여 룩 유지; roteiro.linha_de_estilo.
빈 시트 ("처음부터", "준비된 것 없음")기술적 베이스만; 라이브러리 또는 연구된 참조 자료는 일체 사용 금지.
외부 참조 (링크, 비디오)프레임 단위로 연구하고 문법(리듬, 기술)을 가져오며, 콘텐츠나 룩은 가져오지 않습니다.
"API 사용 없음""offline": true, 로컬 음성, 배경 음악은 partitura 또는 arquivo, 이미지 생성 없음.

요청은 조합될 수 있습니다. 기본값: ~45–60 초 기준 · 16:9 + 9:16 · 내부용으로 승인된 참조에서 복제된 VoxCPM2 음성 ("voz": "voxcpm", 템플릿에 이미 포함) — 공개용 비디오(캠페인, 소셜 미디어, 고객)는 다른 음성을 요청합니다: 브리프와 함께 추천과 질문. 다른 음성 요청: 이름 → 사용; 설명 → gemini.md; "옵션" → 샘플 · 판매 목적인 경우에만 URL이 포함된 CTA. 길이는 콘텐츠가 요구하는 대로; 선택한 음성의 측정된 속도로 추정합니다(측정 전에 약속 금지). 긴 비디오: 각각 기능을 가진 막과 하위 에이전트 간에 완전히 분할된 패스.

감독의 브리프 (코드 작성 전)

순서대로 — 로그라인과 한계를 먼저, 미학을 다음으로, 도구를 마지막으로 (기술부터 시작하면 기술이 아이디어를 집어삼킵니다). PROPOSTA.md(받은 대본/제안) 또는 ANALISE.md 상단에 작성합니다. 항상 바(Bar) 높이기: 모션 디자인 스튜디오의 포트폴리오 조각처럼 — 최대한의 완성도, 기본이 아닌. 이는 모든 스타일(미니멀하거나 복잡한)에 적용되며 완성도가 나타나는 위치가 다를 뿐입니다.

  1. 로그라인: 한 문장으로 표현하는 비디오 + 대상 + 게재 위치 + 시청자가 끝났을 때 느끼거나 행동해야 할 것.
  2. 한계: 길이, 포맷, 진실(소스; 일러스트레이션인 것), 권리, API 예산.
  3. 편향 없는 아이디에이션: 3개의 매우 다른 컨셉, 콘텐츠에서만 (라이브러리나 이전 비디오를 열지 않고), 각각 완전함: 장치, 시각적 세계, 재료, 팔레트, 타이포그래피, 움직임, 사운드 팔레트 및 배경 음악. conceitos.json에 선언하고 python3 scripts/diversidade.py --conceitos 실행 — 모델은 이력을 보지 않아도 반복되는 세계적 반사 작용을 가지고 있습니다; 스크립트(레지스트리만 읽음)가 이를 지적합니다. 2개 미만의 자유로운 컨셉 → 다시 창안. out/conceitos/에 각각 빠른 스틸 이미지 하나씩 생성하고 보고 선택; 승인할 브리프가 있는 경우 3개의 스틸 이미지를 함께 제공합니다. 3개와 그 이유를 기록; 선택된 컨셉의 재료는 roteiro.conceito.materiais로 이동합니다.
  4. 비주얼 바이블 (각 선택의 이유와 품질 기준 문장 포함) → src/tema.ts. 반복 캐릭터 → 캐릭터 바이블 (비율, 팔레트, 표정, 절대 변하지 않는 것).
  5. 디컷 페이지: 블록별로 각 블록의 기능, 나타나는 것, 전환, 사운드.
  6. 도구: 음성; 배경 음악; 자산 — 라이선스가 있는 웹 (assets.md, CREDITOS.md), 생성 (scripts/img.py, Veo: gemini.md 참조) 또는 코드로 그리기.
  7. 자산 패스 (바이블 이후, 애니메이션 전): 이 비디오를 위해 만들어진 세트, 대본의 각 아이디어당 하나의 자산(캐릭터, 오브젝트, 배경, 텍스처), 모두 동일한 처리. 생성됨: roteiro.json의 tratamento_imagem + imagens, 첫 번째 승인된 이미지가 다른 이미지의 ref 스타일이 되고, recorte는 분리된 요소용 (python3 scripts/img.py). 쿼터 없음 또는 오프라인: 동일한 주의를 기울여 코드로 그리기. 생성된 이미지는 실제 사람이나 "일러스트레이션" 레이블이 없는 사실을 절대 나타내지 않습니다. 이것이 스튜디오 작품과 정확하지만 평범한 작품을 가장 크게 구분짓는 요소였습니다.

관문 (건너뛰지 마세요)

브리프 → 대본 → 음성 → 측정 → 사운드 + 비트 → 자산 → 스토리보드 → 애니메틱 → 전체 패스 → 비평 → 렌더링 → 전달 → 발전
  1. 프로젝트: bash ~/.claude/skills/video-animado/novo.sh ~/videos/<slug>. 프로젝트의 ANALISE.md에는 관문 체크리스트가 이미 포함되어 있습니다: 통과할 때마다 표시; 요청이 생략한 경우에만 건너뛰고 이유를 명시.
  2. 대본 roteiro.json(단일 소스) + ROTEIRO.md(소스 포함). 음성 전에 항상 사실 확인.
  3. 음성: python3 scripts/tts.py (변경된 블록만 재녹음). 확인: ~/.venvs/tts-local/bin/python scripts/check_voz.py.
  4. 측정: python3 scripts/tighten.py; 자연스러운 발화 또는 주의 → ~/.venvs/tts-local/bin/python scripts/align.py (cueW).
  5. 사운드 + 비트: 배경 음악 (lyria → scripts/music.py; arquivo; 코드로 작곡된 partitura, 블록별 intensidade 및 장면 eventos 포함) 및 python3 scripts/sound.py (타임라인, 효과, 피크, 악보의 beats.json). 배경 음악 준비됨 → ~/.venvs/tts-local/bin/python scripts/beatmap.py. 패밀리별 효과(biblioteca/sfx/INDEX.md), 재료에 따라 sfxVar로 선택 (피크가 자동으로 액션에 맞춰짐).
  6. 스토리보드: 대본의 각 순간마다 스틸 이미지, 바이블 및 "무엇을 뺄 수 있을까?"에 대해 비평.
  7. 애니메틱: 빠른 렌더링 (npx remotion render Video-9x16 out/animatic.mp4 --scale=0.4)으로 완성 전에 리듬과 비트 조정.
  8. 전체 패스 src/Video.tsx (템플릿 예제는 단순 동기화일 뿐: 대체; 컨셉이 요구하는 컴포넌트를 구축). 긴 비디오: tema.ts 및 핵심 규칙을 사용하여 하위 에이전트 간에 장면 그룹 분할.
  9. 비평: python3 scripts/qa_folhas.py out/<mp4> + 점수가 있는 클린 하위 에이전트 (critica.md 참조), 모든 항목이 ≥ 8이 될 때까지 (최대 3라운드; 비평가는 비디오의 바이블을 기준으로 판단, 자신의 취향이 아님). python3 scripts/diversidade.py 통과 (요청된 연속성: roteiro.linha_de_estilo).
  10. 렌더링: bash scripts/render.sh (−14 LUFS, 2패스, 대본의 포맷); qa_folhas.py의 relatorio.txt에서 확인 (−14 ± 1).
  11. 전달: MP4 + 커버 프레임 (npx remotion still … out/capa.png) + 리뷰 시트 + ANALISE.md (브리프, 결정, 소스, 비평 노트, 사람이 들어야 할 것) + Finder에서 열린 파일 (open -R). 최종 메시지에서 평점(1–5)과 변경할 점을 요청.
  12. 기술 발전: 요청자의 평점 → diversidade.py --registrar → APRENDIZADOS.md에 기술적 교훈 (짧게; 추가할 때 병합 또는 제거), VIDEOS.md에 미적 선택, biblioteca/에 재사용 가능하고 주제가 없는 조각 (+ INDEX.md), 두 포맷에서 테스트 및 수정된 템플릿 버그, gemini.md의 새로운 기능. 2개 비디오에서 반복된 직무 교훈 → direcao.md (룩 예제 없이).

코드 계약

  • 시간은 절대 단독 숫자가 아님: cue, cueW, blockStart, naBatida(frame), batida(i), virada().
  • 포맷: useFmt() + pick(paisagem, retrato); 모든 장면은 두 포맷에서 실행(자르기보다 재구성).
  • 움직임: mola(frame, at, 'ui'|'padrao'|'pesada'|'viva'); 규칙은 direcao.md 참조.
  • 템플릿의 중립 코어: tema.ts (비디오의 색상 및 글꼴), lib.ts (시간, 포맷, 비트, 스프링), stage.tsx (corte/wipe/zoom 또는 사용자 정의 전환 TransFn, Sheet, Soundtrack, sfxVar 포함 SceneStack), acabamento.tsx. 준비된 조각은 biblioteca/componentes/에 선택적으로, 컨셉 후에만 공개.
  • 모든 애니메이션은 프레임에서 시작 (useCurrentFrame + interpolate/mola); interpolate는 항상 extrapolateLeft/Right: 'clamp'와 함께 사용; CSS transition/animation 사용 금지 (렌더링에 나타나지 않음).
  • 템플릿의 @remotion/* 패키지 4.0.528 (transitions, paths, shapes, noise, motion-blur, lottie, three, media-utils, layout-utils); 새 패키지는 동일한 버전.

엄격한 규칙

  • API 키는 ~/.config/secrets.env에 위치 (source로 로드; 절대 출력 금지). 할당량/지출 한도 없음: 로컬 음성 및 partitura 사용.
  • 음성 복제는 서면 승인 필요; 실제 사람의 복제된 음성은 명시적인 공개 승인이 없는 한 내부용입니다.
  • 제3자 자산은 명확한 라이선스가 있어야 하며 CREDITOS.md에 등록; 권리 기반이 없는 실제 사람 사진, 상업 음악 또는 공식 작품을 모방한 제3자 로고는 절대 사용 금지.
  • 진실: 소스가 있거나 "일러스트레이션/예제" 레이블이 있는 데이터; 화면이나 게시물 캡션에 허위 정보 없음.
  • MP4 및 오디오 파일은 공개 리포지토리에 업로드 금지. 문의 없이 커밋 금지.
  • 기술을 변경하는 병렬 세션 (git status에 자신의 변경이 아닌 수정 사항이 있는 경우): 일회성 교환만 허용, 또는 자체 워크트리 사용 (claude --worktree) 및 머지 — 다른 세션의 파일을 덮어쓰지 마십시오.

Individual skills in this repo

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

관련 스킬