Communitygithub.com

elkl111/reels-editing-lab-beta

말하는 머리 릴을 원본 클립에서 편집합니다. 사용자가 '새 릴 있어', '이 릴 편집해 줘', '새 클립'이라고 말하거나, 비디오를 채팅으로 드래그하거나 inbox/에 넣거나, 러프 컷에 수정 사항을 주면 사용합니다. 채팅 안에서 전사, 러프 컷, 리뷰를 모두 처리합니다.

reels-editing-lab-beta란 무엇인가요?

이 스킬은 사용자가 말하는 머리 릴을 원본 비디오 클립에서 완전히 편집하는 AI 에이전트입니다. 모든 작업은 채팅 안에서 이루어집니다. 먼저 `transcribe.py`를 사용해 클립을 전사하고, 오해된 이름을 수정합니다. 그런 다음 사용자가 드래그한 파일이나 `inbox/` 폴더의 최신 비디오를 처리합니다. 핵심 기능은 러프 컷 제작으로, `lines.md`의 전사 내용을 분석해 최적의 테이크, 거짓 시작, 필러 등을 제거하고 `cut.json`에 편집을 저장합니다. 이후 `roughcut.py`로 렌더링하고 `verify.py`로 검증합니다. 리뷰 단계에서는 사용자에게 라인 목록을 보여주고 '드롭 3', '9번을 '중요한 것'에서 끝내' 같은 명령으로 수정합니다. 최종 빌드에서는 훅, 라벨, 강조 단어, 클로즈업, 배경 그래픽, 사운드 이펙트를 자동으로 추가하며, 사용자의 브랜드 키트를 존중합니다. 이 스킬은 클로드 코드, 커서, 코덱스와 같은 플랫폼에서 작동하며, 사용자가 편집 과정을 완전히 제어할 수 있도록 합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/elkl111/reels-editing-lab-beta/tree/HEAD/.claude/skills/new-reel

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

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

문서

릴 편집하기

모든 작업은 이 채팅에서 이루어집니다. 편집자처럼 짧고 간결하게 말하세요: 불필요한 전문 용어나 설정 없이. 각 단계의 시간을 측정하고, 작업을 넘길 때 시간을 알려주세요("러프 컷 완료: 0:40").

1. 전사

  • 클립은 사용자가 드래그하거나 이름을 지정하지 않는 한 inbox/에 가장 최근에 추가된 비디오입니다.
  • 하나의 릴에 여러 클립 (여러 부분으로 나누어 촬영했거나, 여러 테이크를 찍었거나, "이 세 클립"이라고 말한 경우): 촬영된 순서대로(가장 오래된 것부터) 모두 전달하세요: uv run tools/transcribe.py "<클립 1>" "<클립 2>" … --name <이름>. 이들은 하나의 전사본으로 합쳐지며, lines.md는 각 클립이 시작되는 위치를 표시합니다(── 클립 2: … ──). 따라서 모든 클립에서 각 라인의 최고 테이크를 선택합니다. 새 클립이 여러 개 inbox/에 있고 함께 속하는지 명확하지 않으면, 한 줄로 물어보세요.
  • transcribe.py가 먼저 클립을 확인합니다. PROBLEM: 줄과 INTAKE=refused(가로, 너무 긴, 소리 없음)를 출력하면, 메시지를 친절하게 전달하고 중단하세요. NOTE: 줄(HDR 변환, 긴 클립)은 한 줄로 간단히 언급할 수 있습니다.
  • 사용자에게 알리세요: "지금 전사 중입니다. 몇 초면 끝납니다."
  • uv run tools/transcribe.py "<클립>" --name <작업-이름>
  • brand/preferences.md와 brand/names.txt 파일이 있으면 읽으세요.

잘못 들은 이름. 전사 도구는 브랜드 및 도구 이름을 모르므로, 들은 대로 씁니다: "Claude"는 종종 "cloud"나 "clawed"로, "Skool"은 "school"로, "ChatGPT"는 "chat GPT"로 나오며, 사용자의 이름이나 제안도 잘못 나올 수 있습니다. lines.md에서 이런 부분을 찾으세요. cut.json 텍스트에서 수정하고, 빌드 시 build.json의 "spell"에서도 수정하세요(자막에서 사용됨). 잘못 들은 것만 수정하고, 사용자의 표현은 절대 바꾸지 마세요. 사용자가 사용하는 이름을 알게 되면, brand/names.txt에 한 줄에 하나씩 추가하여 다음 릴에서 제대로 인식되도록 하세요.

전사 도구(Parakeet)는 말한 내용을 그대로 기록하며, 멈춤 없이 다시 시작된 부분도 포함합니다("while most of the pe… while most of the people"). 모든 시도가 전사본에 포함되므로, 모든 시도를 잘라낼 수 있습니다.

2. 러프 컷 만들기

projects/<이름>/lines.md를 읽으세요. 각 구절은 P# [첫단어-마지막단어] 시작→끝 | 텍스트 형식입니다. 단어 인덱스는 transcript.json을 가리킵니다. 정확하게 다듬으려면 인덱싱된 단어를 출력하세요: python3 -c "import json;w=json.load(open('projects/<이름>/transcript.json'))['words'];print(' '.join(f\"{x['i']}:{x['w']}\" for x in w))"

무엇을 남길지 다음 순서로 결정하세요:

  1. 리테이크: 한 라인이 여러 번 말해졌을 때, 마지막으로 완전하고 유창한 테이크를 유지하세요. 이전 시도는 리허설이며, 반쪽 단어("pe", "m") 및 중단된 시작을 포함합니다. 리테이크는 종장 다시 표현되므로 의미를 기준으로 매칭하세요.
  2. 거짓 시작: 흐지부지되거나, 중단되거나, 즉시 다시 시작되는 부분은 제거하세요. 긴 구절 내부를 주의 깊게 살펴보세요. 중단 없이 구절 중간에 다시 시작되는 경우가 많기 때문입니다("and these are and these are the non-negotiables" → 마지막 "and these are the non-negotiables"만 유지).
  3. 혼잣말: "okay", "let me start over", "was that good?", 그리고 실수 후 웃음은 제거하세요.
  4. 필러: 라인이 없이도 잘 작동할 때 앞에 붙은 "so", "um", "uh" 또는 "okay"는 제거하세요. 라인 내부의 "uh"와 "um"은 그 주변을 분할하여 제거하세요.
  5. 개성 유지. 곁말과 웃긴 농담은 콘텐츠입니다. 확실하지 않으면 유지하고 언급하세요.
  6. 사용자가 달리 요청하지 않는 한, 말한 순서를 유지하세요.

projects/<이름>/cut.json을 작성하세요:

{"lines": [
  {"text": "while most of the people are debating…", "words": [19, 33]},
  {"text": "This is what I want you to do instead.", "words": [53, 61]}
]}
  • 하나의 항목 = 하나의 검토 가능한 라인: 문장이나 짧은 생각, 약 2~8초.
  • words는 전체 단어의 포함 범위입니다. text는 정확히 그 단어들입니다(명백한 오청만 수정).

그런 다음:

  1. uv run tools/roughcut.py projects/<이름>은 컷을 렌더링하고, 번호가 매겨진 라인을 출력하며 QuickTime에서 비디오를 엽니다.
  2. uv run tools/verify.py projects/<이름>은 다시 들어봅니다. 사용자에게 보여주기 전에 "누락된", "추가된" 또는 "반복된" 부분을 수정하세요: cut.json을 조정하고 다시 실행하세요. 철자만 다른 경우("Chat GPT" 대 "ChatGPT")는 괜찮습니다.
  3. 오프닝 확인 (hooks 스킬, 섹션 A): 워밍업 시작 부분("so today I want to talk about…")을 다듬으세요. 이후 라인이 더 강력한 콜드 오프닝을 만들 수 있으면, 적용하지 말고 리뷰에서 제안하세요.

3. 채팅에서 리뷰

사용자에게 보여주세요:

러프 컷 준비 완료: 1:31 → 0:51, 소요 시간 0:40. QuickTime에서 재생 중입니다.
제거한 내용: 오프너 시도 3번, "and these are" 2번, "let me show you" 7번 중 6번.

 1. while most of the people are debating… (4.3초)
 2. or to go back to Claude… (5.6초)
 …

드롭 또는 변경할 내용을 알려주세요("3번 드롭", "9번을 '중요한 것'에서 끝내", "5번의 이전 테이크 사용"), 또는 "좋아"라고 말해주세요.

라인 목록은 roughcut이 출력한 그대로 유지하세요(lines_review.txt에도 있음).

4. 수정 사항 적용

사용자는 보통 라인 번호로 간단히 답합니다.

  • "3번 드롭" → 해당 항목 제거.
  • "9번을 …에서 끝내" 또는 "'which I love' 잘라내" → 해당 항목의 단어 범위 축소.
  • "이전 테이크 사용" → lines.md에서 찾아 범위를 교체.
  • 시각에 대한 메모("여기 내 화면 보여줘", "이 부분에 큰 텍스트") → 빌드 단계를 위해 projects/<이름>/notes.md에 저장.

러프컷과 검증을 다시 실행하세요(변경되지 않은 부분은 재사용되므로 몇 초 걸림). 무엇이 변경되었는지와 새 길이를 한두 줄로 답변하세요. 사용자가 "좋아"라고 말할 때까지 반복하세요.

수정 사항이 모든 릴에 적용된다면(예: "내 'honestly'는 절대 자르지 마"), brand/preferences.md에 한 줄로 추가하세요.

  • "콜드 오프닝" → 제안한 라인을 cut.json의 맨 위로 이동하고, 다시 실행한 후 다음 라인이 잘 따라오는지 확인하세요.

사용자가 "좋아"라고 말하면, 러프 컷이 확정되고 빌드가 시작됩니다.

5. 완성된 릴 빌드(자동, 사용자의 스타일로)

러프 컷이 확정되면 바로 빌드하세요. 승인을 요청하지 마세요.

  1. 사용자의 키트 읽기: brand/kit.txt가 이름을 지정하고, 키트는 packs/<키트>/kit.json에 있습니다. rules는 무엇이 어디에 얼마나 들어갈지(intensity)를 정의합니다.
  2. 확정된 라인 읽기(edl.json → lines) 및 projects/<이름>/build.json 작성:
    • 훅 1번 라인에, hooks 스킬로 작성: 릴을 분석하고, 다른 패턴으로 3가지 옵션을 작성하며, 네 가지 검사(진실, 구체적, 흥미, 인간적)를 통과하는 것만 유지하고, 세 가지 모두를 "options"에 저장합니다. 가장 좋은 것은 eyebrow(2–4단어)와 text(최대 약 8단어, 하나 *강조*)에 들어갑니다.

    • 커버: "cover": {"eyebrow": "…", "text": "…"}, 주제를 명명하는 더 명확한 3–6단어 제목(hooks 스킬, B2).

    • 레이블 (이름 ✳ 하는 일): 기본적으로 추가하지 않음. 릴이 사용자에 관한 경우에만 추가: 자신을 소개하거나("저는…", "처음 오셨나요…"), 자신의 이야기를 하거나, 사용자가 요청한 경우. 해당 라인에 {"type": "label", "at_line": n}을 사용하세요. 키트의 label이 여전히 YOUR NAME / WHAT YOU TEACH라고 되어 있으면, 한 번만 표현을 물어보고(짧게, 각 면 최대 ~22자) 키트에 저장하세요.

    • 스테이트먼트 (큰 텍스트 순간): 단일 가장 강력한 아이디어에 대한 1.6초 전체 화면 강조, 2–4개의 강력한 단어로 다시 작성하고 하나 *강조* 단어 포함. 아이디어가 떠오르는 단어에 "word": i로 시간을 맞추세요(예: "you can work across them"의 "work"), 전체 라인이 아닙니다. 릴당 최대 2개, 처음 5초 이후에만, 연속으로 사용하지 마세요. intensity가 clean이면 건너뜁니다. 화자를 가리므로 드물게 사용하세요.

    • 철자 (자막): 모든 잘못 들은 이름에 대해 {"<단어 인덱스>": "Claude"}. ""는 단어를 앞 단어에 접습니다: "Chat" "GPT" → {"40": "ChatGPT", "41": ""}.

    • 하이라이트 단어: 약 세 번째 자막마다 하나씩, 요점을 전달하는 명사와 숫자에 사용합니다(transcript.json의 단어 인덱스). 필러 단어는 절대 안 됩니다.

    • 비주얼 (팝업 설명 그래픽): visuals 스킬로 계획하고, 키트의 밀도에 맞춥니다. busy에서는 이것이 편집의 주요 레이어입니다.

    • 클로즈업 (스튜디오 스타일): {"line": n, "close": true}를 zooms에 추가하면 해당 라인에 대해 더 타이트한 샷(키트 zoom.close, 약 1.5×)으로 바로 전환됩니다.

      • 감정적이거나 중요한 라인에서 와이드와 클로즈를 번갈아 사용하며, 최대 다른 섹션마다 한 번씩.
      • 줌은 소스가 4K일 때 4K 원본에서 잘라내므로 선명도를 유지합니다. 첫 빌드는 약 30초 더 걸립니다.
      • 그래픽은 클로즈업 시 더 큰 얼굴에 맞춰 자동으로 이동합니다.
    • 줌: 1–3번의 펀치인, {"line": n}, 요점을 전달하는 라인(약속, 숫자, 전환)에 사용합니다. 훅 라인이나 스테이트먼트 라인에는 절대 사용하지 마세요. 점프 줌은 컷에서 자동으로 발생합니다(키트 zoom.jump).

    • 배경 (화자 뒤에 텍스트 또는 그림, Apple Vision으로 화자만 남김): 릴당 최대 1-2개, 핵심 명사나 공개에 사용합니다. {"type": "behind", "line": n, "text": "One *folder*"}는 벽에 머리 높이에 거대한 단어를 배치합니다(1–3단어가 가장 잘 읽힘). "image": "path/to/file.jpg"를 추가하면 벽을 밈, 스크린샷, 사용자가 제공한 B-roll 스틸, 또는 assets/의 파일로 대체합니다. 순간당 약 20초의 추가 빌드 시간이 소요됩니다.

    • 사운드 이펙트는 키트의 사운드 세트("sfx": {"palette": "soft"}; 세트는 sfx/palettes.json에 있음)에서 자동으로 제공됩니다:

      • soft: 부드럽고 차분함
      • clicky: 기술적이고 선명함
      • playful: 가볍고 재미있음
      • punchy: 대담하고 에너지 넘침

      각 순간은 3개 이상의 사운드를 순환하며, 빌드는 간격을 두고 반복을 제한하므로 모든 하이라이트에 직접 사운드를 추가하지 마세요.

      • 말하는 내용과 일치하는 1~3개의 사운드를 추가하세요: 프롬프트 입력 시 "sfx_extra": [{"at": 12.3, "sfx": "keyboard"}], "just click"에 mouse_click, 아하 순간에 ding 또는 sparkle, "screenshot"에 shutter, "next"에 page_flip, 공개 직전에 riser. at 시간은 완성된 릴 기준입니다.
      • 하나의 이벤트에 사운드를 고정하려면 그 안에 "sfx": "thud"를 사용하세요. build.json에서 "sfx": false를 사용하면 사운드 없음.

사운드: 사용자가 말할 수 있는 것

  • "어떤 사운드가 있어?" / "다른 사운드는?"
    • open sfx/sound-menu.mp4: 번호가 매겨진 카드와 각 사운드의 재생이 포함된 미리 만들어진 40초 비디오. 오디오 미리보기를 생성하거나 합성하지 마세요. 메뉴가 이미 존재합니다.
    • 채팅에서 4개의 세트를 각각 한 줄로 나열하고 "또는 메뉴에서 번호로 선택하세요"를 추가하세요.
  • "이 릴에는 clicky 사운드 사용" (이 릴만): build.json에 "sound_set": "clicky"를 추가한 후 다시 빌드하세요.
  • "항상 clicky" (모든 릴): 키트의 sfx.palette를 설정하세요.
  • "3번 없음" / "버블 싫어": 키트의 sfx.avoid 목록에 이름을 추가(영구적)하고 다시 빌드하세요. 번호는 sfx/LIBRARY.md와 일치합니다.
  • "6번 더": sfx.favour에 추가하세요. 즐겨찾기는 하이라이트 단어에서 순환을 주도합니다.
  • "사운드 줄여" / "더 조용하게":
    • 줄이기: 사운드가 필요 없는 highlight_words를 삭제하거나 키트의 "highlight": []를 설정.
    • 조용하게: sfx.volume_db를 3만큼 낮춤.
  • 빌드는 SOUNDS=set: soft; soft_pop ×3, tick ×2…를 출력합니다. 보고서에서 세트를 언급하여 사용자가 이름으로 요청할 수 있도록 하세요.
  1. uv run tools/build.py projects/<이름>은 final.mp4를 렌더링하고(50초 릴 기준 약 30초) 엽니다. 사운드는 Instagram에 맞게 자동으로 청소되고 레벨링됩니다(LOUDNESS= 줄, 약 -14 LUFS).

  2. 또한 cuts.png를 확인하세요: 각 컷의 양쪽 프레임. 각 "후" 프레임은 새 샷이 깨끗하게 보여야 합니다. 빌드는 휴대폰에서 확인할 수 있는 작은 final-phone.mp4도 만듭니다. 언급하세요.

  3. 넘기기 전에 확인: 훅, 레이블 및 각 스테이트먼트에서 프레임을 캡처하고(ffmpeg -ss <t> -i final.mp4 -frames:v 1 …), 화면 밖, 읽을 수 없거나 얼굴을 가리는 부분이 없는지 확인하세요. 빌드가 출력하는 모든 SAFE ZONE: 줄(Instagram의 사용자 이름, 캡션 또는 버튼 아래 그래픽)을 수정하고 다시 빌드하세요. 그런 다음 uv run tools/verify.py projects/<이름> --video final.mp4(단어, 일시 정지, 음량 및 안전 영역)를 실행하고 목록에 있는 내용을 수정하세요.

  4. 사용자에게 두세 줄로 수행한 작업을 알리고 변경을 요청할 수 있음을 알리세요("훅 없음", "다른 큰 순간", "더 차분하게"). 예:

    훅: "Build your business brain". 또는 훅 2: "…" / 훅 3: "…"를 말하세요. 하나의 큰 순간: "work across them", 하이라이트 단어 4개, 펀치인 2개. 사운드: 소프트 세트(soft_pop, swoosh, tick).

    훅 교체 및 조정은 hooks 스킬, 섹션 C를 따르세요.

    그런 다음 추가: "완성된 릴 폴더에도 있습니다. 게시할 준비가 되었습니다. 다음 릴을 위해 이 폴더에서 새 채팅을 시작하고 /new-reel을 입력하세요." 새 채팅 라인은 채팅에서 첫 번째 완성된 릴에만 말하세요.

조정: build.json(또는 변경 사항을 유지하려면 키트)을 편집하고 빌드를 다시 실행하세요. 영구적 선호 사항은 brand/preferences.md에 저장하세요.

밈("5번 라인에 Schitt's Creek David 밈 넣어", "이 GIF 사용", "밈 3", "전체 화면으로", "더 크게", "텍스트 없음"): visuals 스킬의 밈 섹션을 따르고 다시 빌드하세요.

"이 색상 대신 사용" / "세이지와 크림으로" / "다른 글꼴": 키트를 변경하세요(colors 값, 역할 유지; 팝업 색상의 경우 visuals.rotate, 무료 Google Fonts 사용 가능). 그런 다음 다시 빌드하세요. 명확하지 않은 경우에만 "이 릴만? 아니면 항상?" 물어보세요. 사전 설정을 편집하지 마세요.

키트 미리보기: uv run tools/build.py projects/<이름> --sheet는 사용자의 푸티지 위에 모든 조각을 하나의 이미지로 렌더링합니다.

Individual skills in this repo

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

elkl111/reels-editing-lab-beta

Write hooks for a reel that are curious but human, true to the reel and specific to it. Use in the new-reel flow (opening check after the rough cut; on-screen hook and cover title in the build), when the user asks to change the hook ("hook 2", "different hook", "punchier hook"), or before filming ("give me hooks for a reel about X", "how should I open this?").

elkl111/reels-editing-lab-beta

Bundle a problem report for the Lab's maker. Use when the user says something is broken, wrong or confusing and wants to report it ("report a problem", "this isn't working, tell Elena", "send feedback"), or when a tool keeps failing after you've tried to fix it.

elkl111/reels-editing-lab-beta

First-time onboarding for the Reels Editing Lab. Installs what's missing, runs a short brand interview, lets the user pick their look on their own footage, and saves it as their kit. Use when the user says "set me up", "get started", "onboard me", or when brand/kit.txt doesn't exist yet (the Lab hasn't been set up).

elkl111/reels-editing-lab-beta

Update the Reels Editing Lab to the newest version. Use when the user says "update", "update the Lab", "is there a new version?", or was told a new version is out.

elkl111/reels-editing-lab-beta

The visual director. Plans the pop-up explainer graphics (chips, numbers, chat windows, checklists, diagrams…) that illustrate what the speaker says, beat by beat, in their kit's style. Use in the new-reel build step, when the user asks for more or fewer graphics ("more pop-ups", "illustrate this part", "a checklist here"), or asks what graphics exist ("what can you add?", "show me the options").

관련 스킬