Communitygithub.com

reel-critic

완성된 9:16 릴(TikTok, Instagram Reels, YouTube Shorts)을 게시 전에 검토하고, 수정을 거쳐 최종 통과될 때까지 반복합니다.

reel-critic란 무엇인가요?

이 스킬은 짧은 세로형 동영상(릴)이 게시되기 전에 품질 기준을 충족하는지 자동으로 검사하는 비평 도구입니다. TikTok, Instagram Reels, YouTube Shorts 등 9:16 비율의 동영상을 대상으로 하며, 길이, 형식, 음량, 음성 타이밍, 배경음 대비 음성 레벨, 후크 모션, 프레임 정체 및 하드 컷 등을 측정합니다. 또한 음성 대본과 실제 발화를 비교하고, Claude가 연속 사진 시트를 분석하여 프레이밍, 캡션 밴드 및 안전 구역 문제를 찾아냅니다. 검사 항목 중 하나라도 실패하면 해당 단계(예: 한 장면, 한 음성 라인, 믹스)만 다시 수행하며, 최대 3회까지 반복합니다. 최종적으로는 캡션과 영어 해시태그를 제공하여 사용자가 직접 게시할 수 있도록 합니다. 주로 /stickman3d 또는 /stickman3dmn 빌드 후, 또는 사용자가 릴 검토/비평을 요청할 때 사용됩니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/atuuuuuuu/reel-critic/tree/HEAD

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

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

문서

/reel-critic

릴은 통과할 때까지 완성되지 않습니다. make.sh가 <reel>/<name>.mp4를 생성한 후에 실행하세요. PY는 스틱맨 키트 파이썬(numpy)입니다: PY="$HOME/.claude/plugins/cache/claude-animation-skills/animation-skills/1.0.0/kit/.venv/bin/python". CRITIC="<base directory of this skill>".

1. 단어(Words)

최종 mp4를 텍스트로 변환합니다: bash "$CRITIC/tools/stt.sh" <reel> [video] [mon|eng] (ElevenLabs Scribe via Composio, audio/stt_final.json 생성). Composio ElevenLabs 할당량이 없으면 ElevenLabs 웹 앱에서 mp4를 텍스트로 변환(Speech to Text, 타임스탬프와 함께 JSON 내보내기)하고 audio/stt_final.json으로 저장하세요. Whisper는 몽골어에 약하므로 몽골어 릴에는 사용하지 마세요.

2. 측정(Measure)

"$PY" "$CRITIC/tools/critic.py" <reel> [video.mp4] 명령어가 <reel>/critic/report.md, report.json 및 critic/sheets/sheet_NN.jpg를 생성합니다(초당 1프레임, 시트당 10프레임; 시트 NN의 프레임 i는 약 NN*10 + i초에 해당). 종료 코드 0은 모든 측정 검사가 통과했음을 의미합니다. 임계값은 rules.json에 저장됩니다:

검사 항목규칙재수행 단계
길이40~68초스크립트
크기, fps, 코덱1080x1920, 30fps, h264 + aac렌더/마스터
음량, true peak-11.5~-8.5 LUFS, <= -1 dBTP마스터
음성 시작첫 단어가 0.3초 이내음성
음성 간격대사 사이에 0.9초 이상 무음 없음음성
배경음 대비 음성음성이 일시정지(음악+효과음)보다 최소 9dB 이상 높음믹스
후크 모션처음 0.5초 내에 움직임이 있어야 함카메라
화면 변화 지속프레임이 거의 변하지 않는 2초 이상 구간 없음카메라
하드 컷최대 2개(휩 글라이드는 컷이 아님)카메라
대본 일치율캡션 대체 후 단어 오류율 <= 8%음성

3. 보기(Look)

모든 연속 사진 시트를 읽습니다(스택: ffmpeg -i sheet_00.jpg -i sheet_01.jpg ... -filter_complex vstack=N). 청록색 상자: 안전 구역(x 100980, y 2201500). 노란색 띠: 캡션 밴드(y 1250~1420). 다음 경우에 릴을 실패 처리합니다:

  • 얼굴이나 주요 소품이 캡션 밴드 아래에 있거나 안전 구역 밖에 있는 경우;
  • 피사체가 프레임 가장자리에 잘리거나, 렌즈 가까이 있는 소품이 피사체를 가리는 경우;
  • 캡션이 가리는 텍스트가 있는 표지판이나 타이틀 카드, 또는 몽골어 릴에 화면상의 영어 텍스트가 있는 경우;
  • 특정 비트의 화면이 그 순간의 음성 내용을 보여주지 않는 경우(각 프레임의 캡션 단어 확인);
  • 깨진 프레임: 검은 화면, 텍스처 누락, 공중에 떠 있거나 바닥에 파묻힌 캐릭터. 휩 글라이드 중간의 프레임은 흐리거나 빈 바닥을 보일 수 있습니다: 이는 괜찮습니다. 각 발견 사항을 시간과 재수행 단계와 함께 report.md의 ## Picture 아래에 기록합니다.

4. 판정 및 수정 루프(Verdict and fix loop)

2단계가 종료 코드 0으로 끝나고, 3단계에 발견 사항이 없으며, 1단계의 차이 목록에 음성이 실제로 잘못 말한 단어가 없는 경우에만 PASS입니다(STT 철자 오류는 포함되지 않음, 잘못된 단어는 직접 들어보세요). FAIL인 경우, 실패한 부분만 다시 수행한 후 1~3단계를 다시 실행합니다. 3회 후 중단하고 사용자에게 여전히 실패하는 항목을 보여줍니다.

  • 카메라/프레이밍 문제(특정 시간): web/shots.js를 편집하고, render.js stills로 확인한 후, bash "$CRITIC/tools/rerender.sh" <reel> <t1,t2,...> 실행(해당 시간을 포함하는 샷만 다시 렌더링, 재연결, 재마스터). 여러 샷에 보이는 세트 변경은 전체 make.sh가 필요합니다.
  • 음성 라인 문제: 해당 라인을 다시 녹음(stickman3dmn: retake.py 또는 ElevenLabs 웹 앱), 단어 시간 재구축, make.sh <reel> keep 실행.
  • 믹스/음량 문제: audio.py 편집, AUDIO_ONLY=1 make.sh <reel> keep 실행.
  • 스크립트/길이 문제: 사용자에게 돌아갑니다. 스크립트는 사용자의 승인이 필요합니다.

5. 실제 데이터로 학습(Learn from real numbers)

python3 "$CRITIC/tools/stats.py" --out <reel>/critic/stats.json 명령어가 Composio를 통해 Instagram 릴 인사이트(조회수, 공유 수, 저장 수, 평균 시청 시간)와 TikTok 동영상 통계를 가져옵니다. 연결되지 않은 플랫폼은 건너뜁니다(composio link instagram, composio link tiktok; Instagram 인사이트는 비즈니스 또는 크리에이터 계정 필요). 게시물이 10개 이상 쌓이면 상위 1/3과 나머지를 비교(시청 시간, 길이, 후크 유형)하여 사용자에게 rules.json 변경 사항을 제안하고 적용 전에 동의를 받습니다.

6. 인계(Hand-over)

사용자에게 다음을 제공합니다: mp4 경로, 길이, 측정된 음량, 판정 표, 수정된 그림 관련 발견 사항, 그리고 릴 언어로 된 TikTok, Instagram, YouTube Shorts용 캡션과 3~5개의 영어 해시태그(Hervee 채널의 경우 항상 #whatif, 추가 주제 태그 예: #mongolia #ulaanbaatar, TikTok의 경우 #fyp, YouTube의 경우 #shorts). 사용자는 직접 게시합니다.

규칙의 출처(Where the rules come from)

README.md 참조: 리텐션 및 후크 연구, 안전 구역 측정 및 검토된 자동화 도구.

관련 스킬