Communitygithub.com

tatacardona/Reels-FR-Doc-Juanes

Futuros Residentes / Doc Juanes의 원본 비디오(카메라 앞에서 말하는 사람, 녹화된 대본)를 편집하여 Remotion으로 동적인 9:16 세로형 Reels로 변환합니다. 클래퍼보드, NG 테이크, 반복, 무음 구간을 자르고, 오디오를 정리하며, 얼굴을 가리지 않는 색상 강조 단어별 자막을 추가하고, 컷마다 화면을 전환하며, 필요시 사진 오버레이, 이모지/스티커(사운드 효과 포함), 전환 시 광채 효과, 무료 음악을 추가합니다. Mac과 Windows에서 작동합니다.

Reels-FR-Doc-Juanes란 무엇인가요?

이 스킬은 Futuros Residentes와 Doc Juanes의 원본 비디오 녹화물을 Remotion을 사용하여 역동적인 9:16 세로형 Instagram/TikTok Reels 또는 YouTube Shorts로 자동 편집하는 Claude Code 에이전트 전용 전문 도구입니다. 주요 기능으로는 원치 않는 클래퍼보드, NG 테이크, 반복 구간 및 무음 구간 제거, 오디오 정리, 얼굴을 절대 가리지 않는 지능형 단어별 색상 강조 자막 추가, 모든 컷에서의 장면 전환, 요청 시 추가되는 사진 오버레이 및 이모지/스티커, 전환 시 광채 효과, 저작권이 없는 음악 추가 등이 있습니다. 이 스킬은 Mac과 Windows 모두에서 작동하며, 각 편집 결정 전에 승인을 받고, 각 프로젝트에 대해 새로운 대화를 시작하며, 예상 토큰 소비를 제시함으로써 비용 관리에 중점을 둡니다. 또한 파일 명명 규칙, 포트폴리오 관리, Google Chat을 통한 팀 알림 및 음악 선택에 대한 참조 파일을 포함한 자세한 워크플로우를 제공합니다. 중요하게도, 이 스킬은 Janeth Cardona만이 수정할 수 있으며, 다른 사용자는 개선 사항이 있을 경우 그녀에게 연락해야 합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add tatacardona/Reels-FR-Doc-Juanes

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

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

문서

Futuros Residentes / Doc Juanes 릴 편집

편집 결정을 내리기 전에 references/estilo.md를 읽으세요: 승인된 스타일과 각 규칙의 이유가 있습니다. 무언가 실패하면 references/problemas.md를 확인하세요: 잘못될 수 있는 거의 모든 것이 이미 한 번 발생했습니다. 음악은 references/musica.md를 참조하세요.

비디오를 요청한 사람과 협업하는 방법

  • 그/그녀에게 스페인어로, 명확하고 기술적인 용어 없이 작성하세요. 프로그래머가 아닐 수 있습니다: 당신이 무엇을 보고 무엇을 할 것인지 설명하세요.
  • 실행하기 전에, 행동 계획을 요약하고 승인을 기다리세요, 항상, 각 단계에서 (초기 계획, 각 변경 라운드, 표지, 음악). 요약에는 두 가지 기준이 포함됩니다: 시청각적 (무엇을 할 것인지, 단계별) 그리고 재정적: 토큰 소비 예측 ("토큰 소비" 참조). 원자재를 미리 준비하고 기록할 수 있으며, 계획이 구체적이도록 합니다.
  • 당신은 오디오를 들을 수 없습니다. 측정 및 재전사를 통해 확인하고, 주관적인 내용(음향 효과, 음악 볼륨, 매우 빡빡한 컷)은 그/그녀가 듣도록 요청하세요.
  • 각 버전에서 그/그녀에게 프레임과 MP4를 보여주세요. 변경을 요청하면, 그/그녀가 언급한 편집된 비디오의 초 단위로 찾아내고 (src/Reel/edit.json에 매핑) 어떤 문장인지 확인하세요.
  • 브랜드: 계획에서 비디오가 Doc Juanes인지 **Futuros Residentes (FR)**인지 확인하세요. 프로젝트 폴더와 알림이 전송되는 Google Chat 공간을 정의하세요 (9단계).
  • 이름: 계획에서 밑줄이 있는 대문자로 된 짧은_이름을 제안(또는 요청)하세요 (예: JUANCHO_PASASTE); 이것은 프로젝트 폴더의 이름이기도 합니다.
    • 검토 중: 각 버전에 번호를 매겨 이전 버전을 보지 않도록 합니다 ("변경 사항이 감지되지 않음"): NOMBRE_CORTO_REEL_v2.mp4, NOMBRE_CORTO_PORTADA_1.jpg… 다운로드에는 최신 버전만 유지합니다.
    • 최종 버전이 승인되면, 번호를 포함한 다른 모든 것을 제거하고 이름을 바꿉니다: NOMBRE_CORTO_REEL.mp4 및 NOMBRE_CORTO_PORTADA.jpg, 그리고 다운로드에서 폐기된 버전과 표지를 제거합니다.
    • 표지: 하나가 선택되는 즉시, 즉시 NOMBRE_CORTO_PORTADA.jpg로 이름을 바꾸고 (번호 없이), 다운로드 및 out/portadas/에, 비디오가 여전히 검토 중이더라도, 다른 옵션을 제거합니다. 이후 선택된 표지에 대한 조정을 요청하면, 번호가 없는 동일한 파일을 덮어씁니다.
    • 그/그녀에게 보내는 테스트 이미지 (글꼴, 색상, 조명, 효과, 검토 프레임): NOMBRE_CORTO_PRUEBA_<주제>_N.jpg (예: NOMBRE_CORTO_PRUEBA_FUENTES_1.jpg). 최종 버전이 승인되면, 폐기된 버전과 마찬가지로 제거합니다: REEL과 PORTADA만 남습니다.
    • rm으로 사람의 파일을 절대 삭제하지 마십시오: ./scripts/papelera.sh <파일들>을 사용하세요 (Mac 휴지통 또는 Windows 휴지통; 복구 가능).
  • 음악: 모든 비디오에 음악이 있는 것은 아닙니다. 요청된 경우에만 추가합니다. 이미 사용된 노래를 절대 반복하지 마십시오 (목록은 references/musica.md에 있음), Janeth가 재사용을 승인하지 않는 한.
  • 대화형 프로그램(npx create-video와 같은)은 터미널 패널의 탭에서 실행됩니다: 그/그녀에게 탭을 클릭하고 거기서 응답하라고 말하고, 각 질문을 설명하세요.

이 스킬을 변경할 수 있는 사람

스킬은 GitHub (github.com/tatacardona/Reels-FR-Doc-Juanes)에 있으며 Janeth Cardona만 수정합니다. 어떤 컴퓨터에 있는지 확인하려면: git -C ~/.claude/skills/editar-reel-fr config user.email.

  • 응답이 [email protected] (Janeth의 컴퓨터)인 경우: 스킬을 변경하기 전에 항상 그녀에게 물어보고 그녀의 승인을 기다리세요; 한 줄로 무엇을 변경할 것인지와 그것이 모든 비디오에 왜 유용한지 설명하세요 (그녀가 직접 변경을 요청한 경우 이미 승인된 것입니다). 비디오의 특정 사항 (노래, 시간, 위치, 볼륨)은 해당 프로젝트에만 속하며, 스킬에는 절대 속하지 않습니다. 변경 후: git -C ~/.claude/skills/editar-reel-fr add -A && git commit -m "<변경 사항>" && git push.
  • 다른 모든 컴퓨터에서는 절대 스킬 파일을 수정하지 마십시오. 모든 사람에게 도움이 되는 개선 사항이나 문제를 발견하면, 그 사람에게 Janeth에게 알리라고 말하고 보낼 텍스트를 작성하세요 (무슨 일이 있었는지, 어떤 비디오에서, 무엇을 제안하는지).
  • 사용된 노래는 references/musica.md에 기록됩니다; 다른 컴퓨터에서는 Janeth에게 제목, 아티스트 및 링크를 전달하여 추가하도록 하세요.

토큰 소비 (계정은 팀 전체가 공유)

Claude의 각 단계는 전체 대화를 다시 읽습니다: 이것이 거의 모든 비용이며 길이에 따라 증가합니다. 따라서:

  • 비디오당 새 대화. 비디오가 승인되면 다음 비디오를 위해 새 대화를 시작할 것을 제안하세요. 동일한 대화를 계속하면 2~3배 더 비쌀 수 있습니다.
  • 일괄 변경: 모든 수정 사항을 번호가 매겨진 단일 메시지로 모으도록 요청하고, 단일 내보내기에서 적용하세요.
  • 적게 그리고 작게 읽으세요: 축소된 프레임 스트립 (SCALE=0.25-0.35), 파일 및 출력의 필요한 부분만 (tail, grep), 의심스러운 부분만 다시 전사하세요. 큰 이미지는 비용이 많이 듭니다.
  • 묻지 않고 기다리세요: 긴 내보내기는 백그라운드에서 실행됩니다. 매분 확인하지 마세요.
  • 요청되지 않은 단계 없음: 스티커, 음악, AI 배경 또는 추가 검색은 요청된 경우에만 수행합니다.

각 계획의 예측 (실제 30-45초 비디오에서 측정된 수치, Claude Opus 5.5 API 공개 요금, 새 대화 기준). 계획의 단계, 범위 및 총계를 보여주는 짧은 표를 표시하고, 대략적인 것임을 명확히 합니다:

단계Claude 단계 수예상 비용
계획 준비, 전사 및 제시15-25US$ 1-2
시각적 제안 (글꼴, 색상, 조명) 샘플 포함8-15US$ 1-1.5
편집 구성, 승인 텍스트 및 v1 내보내기20-35US$ 2-3
각 변경 라운드 + 새 내보내기10-25US$ 1-2.5
음악 검색 및 조정10-20US$ 1-2
표지 3개8-15US$ 1-1.5
일반적인 전체 비디오 (계획, v1, 2라운드, 표지)80-130US$ 7-12

Team/Enterprise 플랜의 경우 청구서가 다를 수 있습니다. 수치는 옵션을 비교하는 데 사용됩니다. 사람이 비용을 절약하려면 구체적인 대안(라운드 감소, 음악 없음, 새 표지 없음, 또는 간단한 비디오에 더 경제적인 모델 사용)을 제공하십시오. 결정은 그 사람의 몫입니다. 각 비디오를 마감할 때, python3 scripts/consumo.py --desde "<비디오 첫 번째 메시지 텍스트>"로 실제 소비를 측정하고 예측과 함께 공유하십시오. 차이가 크고 Janeth의 컴퓨터에 있는 경우 이 표를 조정할 것을 제안하십시오.

0단계: 도구 (머신당 한 번) 및 스킬 업데이트

git -C ~/.claude/skills/editar-reel-fr pull -q        # 스킬의 최신 버전을 가져옴 (각 비디오)
source ~/.claude/skills/editar-reel-fr/scripts/setup-tools.sh   # $PY, $FF, $PROYECTOS, $DESCARGAS 내보내기

자체 환경에 완전한 ffmpeg, faster-whisper, DeepFilterNet (에코 제거) 및 OpenCV를 설치합니다. 첫 번째 전사는 large-v3-turbo 모델 (~1.6GB)을 다운로드합니다: 먼저 허가를 요청하세요.

  • Mac: Node.js 및 Python 3이 필요합니다 (Xcode 도구와 함께 제공되거나 한 번 설치).
  • Windows: Claude Code는 Git Bash를 사용하며, 이러한 프로그램은 거기서 실행됩니다. 한 번만, Python 3.11 및 Node.js LTS를 설치합니다 (winget install Python.Python.3.11 및 winget install OpenJS.NodeJS.LTS, 사람의 허가를 받아; Python 3.12 이상은 작동하지 않습니다). Windows에서 무언가 실패하면 references/problemas.md를 확인하고 Janeth에게 알리세요.

1단계: Remotion 프로젝트

  • 프로젝트는 **$PROYECTOS/<BRAND>/SHORT_NAME**에 있으며, <BRAND> = Doc Juanes 또는 FR (Mac: 동영상 → Reels Doc Juanes; Windows: 비디오 → Reels Doc Juanes), 비디오당 하나입니다. 복사할 이전 프로젝트: 두 하위 폴더에 있습니다.
  • 가장 빠른 방법: 이전 프로젝트에서 package.json, package-lock.json, tsconfig.json, remotion.config.ts, src/index.ts, src/index.css 및 src/Root.tsx와 node_modules를 복사합니다 (Mac: cp -c -R, 즉시 복제; Windows: npm ci). 이전 프로젝트가 없는 경우: npx create-video@latest (Blank, Tailwind Yes), npm i 및 npm i @remotion/google-fonts@<remotion 버전>.
  • 템플릿 및 스크립트: cp -R ~/.claude/skills/editar-reel-fr/assets/template/src/Reel src/Reel 및 mkdir -p scripts && cp ~/.claude/skills/editar-reel-fr/scripts/* scripts/.
  • 구성을 등록합니다 (assets/template/Root.snippet.tsx 참조) 및 "resolveJsonModule": true.

2단계: 원자재 준비

  1. 프레임을 추출하고 ("$FF" -ss 20 -i crudo -frames:v 1 x.jpg) 확인: 방향 (사람이 옆으로 나오면 ccw/cw 사용), 벽 색상 (키워드 색상 결정) 및 얼굴 위치 (FACE_ORIGIN).
  2. FF="$FF" ./scripts/prep.sh "<crudo>" <none|ccw|cw> → public/video-vertical.mp4 (그림자를 밝게 하는 조명 곡선 포함; LIGHT=0으로 제거) + work/의 오디오.
  3. 배경이나 조명 개선 요청 시 (배경 복잡, 위쪽 조명으로 인한 어두운 얼굴): scripts/fondo-luz.py AI로 사람을 분리하고 흐릿한 배경, 얼굴을 따라가는 채우기 조명, 원하는 경우 벽에 스테인드 글라스 스타일의 컬러 조명으로 public/video-fondo.mp4를 만듭니다. edit-config.json → "fondo"에서 조정 (스크립트 헤더 참조); build-edit.py 이후에 실행됩니다 (사용된 부분만 처리; 부분이 변경되면 다시 실행하십시오, 그렇지 않으면 해당 프레임이 처리되지 않은 채로 나타남) 및 VIDEO_SRC = "video-fondo.mp4"로 활성화됩니다. 그 전에 테스트 프레임을 보여주세요. 스타일은 미묘함을 선호합니다: 약한 흐림 (5), 매우 부드러운 가장자리 (14) 및 매우 희미한 스테인드 글라스/보케.

3단계: 전사 및 매핑

"$PY" scripts/transcribe.py          # 시간이 포함된 문장 → work/transcript.json
"$PY" scripts/energy.py words        # 각 단어의 볼륨 대비 문장 (+dB = 강조)

편집 맵을 구성하고 짧은 목록으로 말하세요:

  • 제외: 클래퍼보드 ("준비, 대본 N…"), 가짜 테이크 ("다시", 욕설, 웃음), 반복된 문장 (가장 깨끗한 테이크 유지; 일반적으로 마지막 것), 잘못된 시작, 마무리 ("준비").
  • 후크: 첫 번째 강력한 문장; 먼저 옵니다.
  • 늘어진 단어 (예: 3초 "아니오"), 이상한 단어 또는 전사되지 않은 음성 = 반복된 테이크 또는 잘못된 시작: 해당 부분만 다시 전사하세요 (오디오 조각에 대한 WhisperModel) 및 energy.py zoom <start> <end>로 세부 조정.
  • 대본에 잘못된 데이터 (잘못 말한 숫자)가 있는 경우, 잘라내기를 제안하십시오; AI로 음성을 모방하지 마십시오.

4단계: 오디오

FF="$FF" PY="$PY" ./scripts/audio.sh   # 에코가 적고 자연스러운 음성 (DeepFilterNet + 부드러운 확장기, −14 LUFS)
"$PY" scripts/energy.py                # 깨끗한 음성에 대해 측정 → 더 빡빡한 컷
"$PY" scripts/sfx-stickers.py          # 소리가 있는 스티커가 있는 경우에만
"$PY" scripts/sfx-tear.py              # 찢어지는 사진이 있는 경우에만

5단계: edit-config.json: 편집 결정

기본: assets/edit-config.example.json. 모든 시간은 원시 비디오의 초 단위입니다:

  • clips: 문장 또는 아이디어당 하나의 클립, 순서대로, 넉넉한 여백 포함. 스크립트는 내부 및 외부의 침묵을 자르고, 단어를 절대 자르지 않습니다. fx: punch (계속), whoosh (주제 변경), leak (색상이 있는 햇빛 섬광; 영감을 주는 비디오의 경우 estilo.md 참조), flash (흰색 섬광). zoom은 클립의 프레임을 고정합니다; steps: [[seg, zoom], …]는 오디오를 자르지 않고 프레임의 계단식입니다. hold_zoom: true = 단일 프레임. tail: 0.1 = 컷이 부드러운 마지막 자음을 잘라내는 경우 클립 끝에 추가 여백.
  • emphasis: 힘있게 말하거나 중요한 단어의 [단어, 초] (~1.5-2초마다 약 1개).
  • word_fixes: 단어의 실제 시간. 이후 클립 내에 있는지 확인하십시오 (이전 침묵에 떨어지면 자막에서 사라집니다).
  • idea_start: 아이디어 시작의 대문자 (0.1초 미만의 모든 단어에 영향을 미침: 다음 단어가 매우 가까운 경우, 예: "Y no", 첫 번째 단어 바로 전에 시간 사용).
  • text_fixes: [{"at": seg, "text": "pregunta:"}] 단어의 정확한 텍스트 (예: ":" 유지).
  • brand_words ("Futuros Residentes", "Doc Juanes" 보호; "UdeA"와 같은 다른 추가), small_extra (단독으로 절대 사용되지 않는 짧은 단어: "fue", "esa", "mi", "tan"…).
  • photos: {src, show_at, tear_at} (찢어짐) 또는 {src, show_at, hide_at}.
  • stickers (요청된 경우에만; 예제는 assets/edit-config.stickers.example.json에 있음): {kind, show_at, hide_at, x, y, size, sfx: [[파일, 초, 볼륨]]}. 유형: broken-heart (break_at) 및 src/Reel/Stickers.tsx의 ART 그림. 새 것의 경우, 자체 SVG로 그리십시오 (Apple 이모지나 저작권이 있는 이미지 절대 사용 금지). 사람이 손을 움직이는 곳에 배치하십시오 (프레임 확인), 얼굴이나 자막 위에는 절대 배치하지 마십시오. 효과가 머리를 따라가야 하는 경우, "$PY" scripts/head-track.py <start> <end> + follow_head: true가 프레임별 위치를 제공합니다 (track).
  • sounds: [[파일, 초, 볼륨, 오프셋_초]]; shakes: 흔들림이 있는 초 (충격).
  • end_push: {at, to}: 기본 종료, 얼굴로의 부드러운 확대 (~1.6) 검은색 페이드 없음. end_hold: 끝에 추가 초.
  • speed: 가속 요청 시 (7단계 참조).
  • 기본 글꼴 (일반 단어): Montserrat Black 900, 검은 테두리가 있는 흰색, 비디오 브랜드가 다른 것을 요구하지 않는 한 (예: 웹사이트 글꼴이 있는 Futuros Residentes 비디오).
  • 강조된 단어: 비디오의 분위기에 따라 계획에서 제안하십시오, 실제 프레임에 대한 2~3가지 옵션 포함: 단일 글꼴 또는 두 가지 글꼴 (예: 감성적인 부분에는 우아한/세리프, 임팩트 있는 부분에는 굵은 글꼴), 동일한 색상 또는 다른 색상 사용. 분위기에 맞는 글꼴 및 색상 (영감, 향수, 활기찬, 코믹…). EMPH_* (첫 번째) 및 EMPH2_* (두 번째, emphasis에서 "alt"로 표시된 단어)는 constants.ts에 있습니다. 색상은 벽과 대비되어야 합니다.
  • echo: [[start, end]] 중요한 문장에 부드러운 에코 (이후: "$PY" scripts/eco.py). 제안하십시오 그러한 문장을 감지하면, 또는 요청되면 적용하십시오.

…

[번역을 위해 잘림]

관련 스킬