Communitygithub.com

reel

RAW 영상(세로 9:16)을 처음부터 끝까지 자르고 편집합니다. 패널이나 선택 과정 없이, 사용자가 보낸 원본 영상에서 묵음, 호흡, "음", 더듬거림, 실수, 재시도, 반복을 제거하고, 승인된 레퍼런스 릴과 동일한 VSL 엔진(애니메이션 UI 포함)으로 편집합니다.

reel란 무엇인가요?

이 스킬은 사용자가 보낸 원본 영상(세로 9:16)을 입력받아, 두 가지 엔진(컷 편집 엔진과 VSL 편집 엔진)을 순서대로 실행하여 완성된 릴(reel)을 자동으로 제작합니다. 컷 편집 엔진은 음성 분석을 통해 묵음, 호흡, 말더듬, 오류 등을 제거하여 매끄러운 발화 클립을 생성합니다. 이후 VSL 편집 엔진은 승인된 레퍼런스 스타일(전체 화면, 펀치 인, 분할 화면 전환, 키워드에 맞춰 등장하는 UI 요소, 립싱크 자막, 절제된 사운드 효과, -14 LUFS 오디오)을 적용하여 최종 편집본을 만듭니다. 이 스킬은 사용자가 "이 릴 편집해줘", "자르고 편집해줘", "이 영상으로 릴 만들어줘", "VSL 만들어줘" 등으로 요청할 때 자동으로 호출되며, 별도의 패널이나 스타일 선택 없이 빠르게 결과물을 제공합니다. Claude Code, Cursor, Codex 등 AI 에이전트 플랫폼에서 사용할 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/lucascorel/skill-motion-graphic/tree/HEAD

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

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

문서

reel · VSL 엔진으로 컷 편집 및 편집

하나의 스킬, 두 개의 엔진, 패널 없음. 사용자가 영상을 보내면 컷 편집 엔진(corte/)으로 자르고 VSL 엔진(modelo/, 승인된 레퍼런스를 생성한 변경 불가 키트)으로 편집하며, 하우스 규칙(regras-da-casa.md, 모든 규칙보다 우선)과 ESTILO.md(엔진 사양)를 따릅니다. 결과는 스튜디오가 VSL 스타일(네이티브 스킨)로 제공하는 것과 동일합니다: 동일한 색상, 폰트, 사운드, 규칙. 절대 영상을 게시하거나 전송하지 마십시오(R9). 영상이나 파일에 제3자 이름을 포함하지 마십시오(R11).

시작하기 전에 다음 파일을 순서대로 전체 읽으세요: regras-da-casa.md → corte/CORTE.md → ESTILO.md → modelo/README.md → modelo/exemplo/LEIA.md. 읽을 가치가 있는 교훈: 품질 기준은 예시이며, 최소 기준이 아닙니다(modelo/exemplo/beats-exemplo.js가 기준; 각 영상마다 고유한 맵이 있음).

스킬 맵

SKILL.md              이 파일 (전체 흐름)
regras-da-casa.md     R1–R11: 얼굴 절대 가리지 않음, SFX 절제, 실제 자료 사용, 단어 잘리지 않음, −14 LUFS…
ESTILO.md             VSL 엔진 사양: 레이아웃, 프레이밍, 움직임, 자막, UI 요소, 사운드, 파이프라인, 승인 기준, 교훈
pele.json             네이티브 값(폰트, 5가지 색상, 불변 값) — 레퍼런스 스킨
corte/                컷 편집 엔진: CORTE.md (스크립트) · references/EDICAO-BRUTA.md (이유) · scripts/ · exemplo/
modelo/               VSL 엔진: kit/ (변경 불가) · montar.mjs · preparar.sh · ferramentas/ · exemplo/ (승인된 릴) · README.md
ferramentas/          preparar.py · rosto.py · ancoras.py · verificar.py · zona-segura.py · recortar.py · audio-final.sh
anexos/               레퍼런스 프레임 및 색상 전/후 비교

S=~/.claude/skills/reel (또는 REEL_SKILL). 환경 변수(R10): WHISPER_MODEL, VSL_PYTHON (mediapipe 또는 opencv 포함 Python), FACE_MODEL, VSL_NODE_MODULES, CHROME, RVM_PYTHON (매트 전용).

플로우 (고정 순서)

0 · 프로젝트

  1. 각 릴마다 영상 옆에 폴더 하나를 만듭니다: reel-<slug>/ 안에 corte/, render/, qa/, entrega/, assets/를 생성합니다. 다른 편집본을 재사용하지 마십시오. 원본 영상 폴더 밖에 쓰지 마십시오.
  2. 해당 머신에서 처음 실행 시: python3 $S/corte/scripts/0-checar.py (ffmpeg, whisper-cli, numpy, 모델 확인).
  3. 한 줄로 진행 상황을 말합니다("VSL 엔진으로 컷 편집 및 편집 중; v1이 몇 분 내에 준비됩니다") 그리고 각 느린 단계 전에 미리 알립니다. 긴 단계는 백그라운드에서 실행합니다.

1 · 컷 편집 (컷 편집 엔진, corte/CORTE.md 전체)

B=$S/corte/scripts · 모든 작업은 corte/ 디렉토리 내에서:

python3 $B/1-tomadas.py "<원본영상>" corte && cat corte/tomadas.txt      # 선택 전에 전체를 읽으세요
# corte/keeps.json 작성 (keep 규칙: 각 문장의 가장 좋은 완전한 테이크; 잘못된 시작은 제외)
python3 $B/2-vicios.py corte
python3 $B/3-corte.py "<원본영상>" corte                                  # J/L = 4프레임 (VSL 기본값)
python3 $B/4-conferir.py corte --prompt "<영상 속 고유명사>" && cat corte/conferencia.txt

기준(R5): conferencia.txt의 모든 블록 승인; 단어가 잘리지 않음; 정지 구간 0.25초 이하. 단어 잘림 → 해당 구간 보호(raw/force) 후 재컷. 사용자가 영상이 이미 깨끗하다고 말하면 건너뜁니다: cp "<영상>" corte/clean.mp4 후 $S/ferramentas/preparar.py corte/clean.mp4 preparo로 전사. 출력: corte/clean.mp4, corte.wav, edl.json, cortepalavras.json.

2 · VSL 엔진 · 준비

cp -R "$S/modelo" motor && cd motor && bash preparar.sh

음성과 함께 9:16 카메라(assets/clean.mp4), 키트 형식의 전사 텍스트, npm install, 입 움직임 추적 및 첫 번째 마운트를 생성합니다. pele-resolvida.json이 없으면 스킨은 네이티브(레퍼런스와 동일)입니다: 직접 생성하지 마십시오.

3 · 1단계 · 설계도 (modelo/README.md)

  1. 전사본(R6): assets/transcript.json을 수동으로 수정합니다(Cloud → Claude, A → IA, 브랜드 표기법대로 이름, CTA 코드워드는 대문자); 원본은 transcript-whisper.json에 보관됩니다.
  2. 프레이밍: python3 $S/ferramentas/rosto.py assets/clean.mp4 ../preparo --916 실행 후 펀치가 적용된 단일 프레임에서 측정 → vsl.json (punch, face, head, fullPos, splitPos; 색상과 그리드는 변경되지 않음). 머리 위 여유 공간이 ~300px 미만이면 FULL 모드에서 상단에 아무것도 배치하지 않음: lettering, kicker, 스탬프는 가슴 위치(R1).
  3. 실제 자료(R3): 공식 스크린샷과 로고를 assets/img/에 + ../assets/SOURCES.md(출처, 라이선스, 날짜); 사실과 가격은 공식 페이지에서 가져옴; 화면이 없으면 일러스트레이션으로 선언(ferramentas/ilustracoes/). 로고, 숫자, 스크린샷을 절대 임의로 만들지 마십시오.
  4. 맵 → 비트: assets/map.md (시간 × 발화 × 카메라 × UI 요소, exemplo/mapa.md 참조) 그 다음 src/beats.js, 맵의 각 라인에 대해 K.* 호출 하나씩, 시간은 K.at("정확한 문구")만 사용 (exemplo/beats-exemplo.js를 전체 읽은 후). 1.5–3초마다 새로운 요소; FULL ≈ SPLIT; 모든 전환과 모든 lettering에 K.hideMouth 사용; 마지막에 K.mouthCaps.
  5. node montar.mjs && npx hyperframes lint (오류 0; 빈 스냅샷 = 앵커 손상, 콘솔 로그 확인).
  6. ../entrega/planta.json (n, layout, de, ate, fala, tela) 및 node ferramentas/cards.mjs → entrega/cards/P01.png….

게이트: 기본적으로 2단계로 바로 이동 — 사용자가 빠른 결과를 요청했습니다. 사용자가 요청하거나("먼저 보여줘") 사용자만 해결할 수 있는 내용(사실, 가격, 이름)에 의문이 있을 때만 맵이나 카드를 보여주고 멈추십시오.

4 · 2단계 · 렌더링 (modelo/README.md)

npx hyperframes snapshot --at <각 전환 및 각 비트> -o snapshots      # 얼굴 자유롭게(R1), 잘리거나 겹치지 않음
node ferramentas/zona-segura-dom.mjs . --strict                           # "안전 영역 OK"
npx hyperframes render -q high -o ../render/_reel-bruto.mp4
node montar.mjs --so-camera && npx hyperframes render -q high -o ../render/_camera-so.mp4 && node montar.mjs
bash ferramentas/audio-final-vsl.sh ../render/_reel-bruto.mp4 ../render/reel-v1.mp4   # −14 LUFS ±0.3 · 피크 ≤ −1 dBTP
node ferramentas/sons.mjs && bash ferramentas/folha.sh ../render/reel-v1.mp4 ../qa/folha-final.png
python3 "$S/ferramentas/verificar.py" .. --video render/reel-v1.mp4 --sfx ../sons.json --camera ../render/_camera-so.mp4

그 후 프로젝트 폴더에 MINUTAGEM.md(비트별: 시간, 발화, 나타나는 요소, 레이아웃, 사운드)와 progresso.md를 작성합니다. 보여주기 전에 비판적으로 검토: VERIFY.md 전체 승인, 프레임 시트, R1(얼굴), R2(SFX ≤ 0.8/s 절제 모드), R6(자막), R7(안전 영역), R8(오디오). 전달 전 최대 2회 조정.

5 · 전달 및 반복

다음과 함께 응답: reel-v1.mp4 경로, 길이(원본 → 컷 → 최종), LUFS 및 피크, 화면 수 및 효과 수, 컷에서 제외된 부분 및 보호된 부분, 자막 수정, 사실 출처, 미해결 사항. 조정 요청 → reel-v<N+1>.mp4 (이전 버전은 render/에 보관); 컷 변경 → 재전사 및 리맵(corte/scripts/remapear.py 사용), 수동으로 재크로노미터링 금지.

운영 규칙

  • 엔진은 재작성되지 않습니다. modelo/kit/ 및 corte/scripts/는 그대로 유지; 각 영상은 src/beats.js, vsl.json, keeps.json 및 조정 사항만 작성합니다. 컷 파라미터는 corte/references/EDICAO-BRUTA.md의 섹션 9 진단을 통해서만 변경하며, 한 번에 하나씩 기록됩니다.
  • 라운드당 하나의 버전, 완전하고 검증됨.
  • 절제된 사운드("sfxModo": "enxuto", vsl-padrao.json 기본값): 타이핑 포함 초당 0.8개 이하 효과, 타이핑은 항상 연속적. 레퍼런스의 정확한 사운드("referencia")는 요청 시에만 사용.
  • 항상 실제 자료; 일러스트레이션은 선언된 경우만. 얼굴 절대 가리지 않음. 안전 영역.
  • 이 세션에서 직접 제작. 사용자가 특정 에이전트나 모델을 요청하면, 이 SKILL.md + ESTILO.md + modelo/README.md를 브리핑으로 하는 범용 에이전트를 시작하고 결과물을 비판적으로 검토합니다.
  • 문제 발생 시(ffmpeg, whisper, 모델, npm, Chrome): 한 줄로 해결 방법을 알려줍니다; corte/scripts/0-checar.py가 머신을 진단합니다.

관련 스킬