Communitygithub.com

elkl111/reels-editing-lab-beta

Reels 편집 연구소 첫 온보딩. 누락된 항목을 설치하고, 짧은 브랜드 인터뷰를 진행하며, 사용자가 자신의 영상에서 원하는 스타일을 선택한 후 키트로 저장합니다. 사용자가 '설정해 줘', '시작하기', '온보딩'라고 말하거나 브랜드/kit.txt가 아직 없을 때(연구소가 아직 설정되지 않음) 사용하세요.

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

이 스킬은 Reels 편집 연구소(Reels Editing Lab)를 처음 시작하는 사용자를 위한 완전한 온보딩 프로세스를 제공합니다. 기술에 익숙하지 않은 사용자를 위해 설계되어, 필요한 소프트웨어(Homebrew, ffmpeg, uv 등)를 설치하고, 간단한 브랜드 인터뷰를 진행한 후, 사용자의 얼굴이 담긴 영상에서 다양한 스타일을 미리 보고 선택할 수 있도록 합니다. 최종적으로 사용자의 선호도가 반영된 개인 키트를 저장하여 이후의 모든 릴 편집에서 자동으로 사용됩니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 AI 에이전트 플랫폼에서 작동하며, 연구소가 아직 설정되지 않았거나 사용자가 온보딩을 요청할 때 실행됩니다. 설치 과정부터 사용자와의 자연스러운 대화, 키트 저장까지 모든 단계를 포함하며, 사용자가 직접 명령어를 실행해야 하는 경우(예: Homebrew 설치)를 제외하고는 모든 작업을 에이전트가 처리합니다.

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

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

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

문서

설정하기

사용자가 연구소를 처음 열었습니다. 사용자는 기술에 익숙하지 않습니다. 과정이 끝나면 모든 것이 설치되고, 자신의 얼굴로 확인한 스타일과 자신만의 키트가 저장됩니다. 그럼 첫 번째 릴을 만들 준비가 됩니다.

어조: 따뜻하고, 간결하며, 한 번에 한 단계씩. 기다리는 동안 무슨 일이 일어나고 있는지 알려주세요. 절대 가공되지 않은 도구 출력물을 그대로 보여주지 마세요. 절대 사용자에게 명령어를 실행하라고 요청하지 마세요. (단, Homebrew가 누락된 경우 한 줄 명령어는 예외입니다. 1단계 참조)

한 줄의 짧은 메시지로 시작하세요:

Reels 편집 연구소에 오신 것을 환영합니다. 설정하는 데 약 10분이 소요됩니다: 몇 가지를 설치하고, 3가지 간단한 질문을 한 다음, 사용자의 동영상에서 직접 스타일을 선택합니다. 시작해 볼까요.

1. 설치 (약 5분, 대부분 음성 모델 다운로드)

python3 tools/doctor.py를 실행하세요. 체크리스트와 DOCTOR=ok 또는 DOCTOR=missing:<이름>을 출력합니다. 다음 순서대로 누락된 항목을 수정하고, 마지막에 doctor를 다시 실행하세요:

  1. mac / space: 둘 중 하나라도 실패하면 중단하고 친절하게 설명하세요(Apple 칩 Mac 필요, 약 6 GB 여유 공간).
  2. homebrew: 사용자를 대신해 설치할 수 없습니다. 실제 터미널에서 Mac 비밀번호가 필요하기 때문입니다. 이유를 한 줄로 설명한 다음, doctor의 수정 항목에서 정확한 명령줄을 알려주고 Terminal 앱(Cmd+Space, Terminal 입력)을 열고, 붙여넣고, Enter를 누르고, Mac 비밀번호를 입력하라고 하세요(입력하는 동안 아무 것도 표시되지 않는 것은 정상입니다). 프롬프트를 따르라고 하세요. 마지막에 Homebrew가 echo와 eval로 시작하는 두 줄의 "다음 단계"를 출력하면, 그것도 붙여넣으라고 하세요. 완료했다고 말할 때까지 기다린 후 다시 확인하세요.
  3. apple-tools: xcode-select --install을 실행하세요. Mac 창이 나타나면 설치를 클릭하고 완료되면 알려달라고 하세요(몇 분 소요). Homebrew가 보통 이미 설치하므로 먼저 확인하세요.
  4. ffmpeg: brew install ffmpeg (brew가 아직 PATH에 없으면 /opt/homebrew/bin/brew 사용).
  5. uv: curl -LsSf https://astral.sh/uv/install.sh | sh, 그런 다음 uv가 아직 발견되지 않으면 ~/.local/bin/uv를 사용하세요.
  6. python-tools: uv sync
  7. renderer: uv run playwright install chromium
  8. speech-model: uv run tools/get_models.py를 백그라운드에서 실행하세요(2.3 GB). 연결이 끊기면 자동으로 다시 시작됩니다. 시작한 후 인터뷰로 넘어가서 다운로드되는 동안 기다리세요. 3단계에서 필요하기 전에 다시 확인하세요.

설치하는 동안 각 기능이 무엇을 위한 것인지 한 줄로 설명하세요(doctor의 설명이 이를 위해 작성되었습니다).

2. 브랜드 인터뷰 (질문 3개, 한 번에 하나씩)

대화하듯이 질문하고, 메시지당 하나의 질문을 하세요. 사용자의 정확한 답변을 그대로 유지하세요.

이름, 태그라인 또는 "무엇을 하는지" 레이블을 묻지 마세요: 연구소는 기본적으로 추가하지 않습니다(새 릴 스킬, "레이블" 참조).

  1. 에너지. "카메라 앞에서 어떤 스타일인가요: 차분하고 사려 깊게, 따뜻하고 수다스럽게, 아니면 고에너지로?" 이는 편집의 활기를 설정합니다(4단계 표 참조).
  2. 브랜드. "브랜드나 디자인 파일, 브랜드 색상 또는 폰트가 있나요? 디자인 파일(.md 또는 PDF)을 드롭하면 스타일을 만듭니다. 또는 색상 코드를 붙여넣거나, inspiration 폴더에 마음에 드는 릴 스크린샷 3-6장을 드롭하세요. 또는 '아니요, 옵션을 보여주세요'라고 말하세요."
  3. 절대. "릴에 절대 넣고 싶지 않은 것이 있나요? 예를 들어 대문자 텍스트, 특정 이모지, 사운드 효과, 절대 하지 않을 말 등."

답변을 brand/profile.md에 저장하세요:

# 프로필
- 에너지: 따뜻하고 수다스럽게
- 브랜드: 색상 #… / 폰트 … / inspiration/의 스크린샷 / 없음
- 절대: …

또한 각 "절대" 항목을 brand/preferences.md에 한 줄 규칙으로 추가하세요.

3. 자신의 얼굴에서 스타일 확인하기

물어보세요: "이제 카메라를 보고 말하는 클립 하나를 드롭해 주세요. 이상적으로는 20초 이상입니다. 이 채팅이나 inbox 폴더로 드래그하세요. 좋은 테이크일 필요는 없습니다. 단지 스타일을 시험해보기 위한 것입니다."

클립이 들어오고 음성 모델이 완료되면:

  1. uv run tools/transcribe.py "<clip>" --name welcome-sample

  2. projects/welcome-sample/lines.md를 읽으세요. 처음 3-5개의 깔끔한 라인, 약 12-20초로 cut.json을 작성하세요. 새 릴 러프 컷 규칙(마지막 깔끔한 테이크, 잘못된 시작 없음)을 사용하세요. uv run tools/roughcut.py projects/welcome-sample --no-open 및 uv run tools/verify.py projects/welcome-sample을 실행하고 플래그가 지정된 항목을 수정하세요. 이 컷을 검토하도록 요청하지 마세요. 샘플일 뿐입니다.

  3. 새 릴 스킬처럼 build.json을 작성하세요: 사용자가 실제로 말한 내용에서 hooks 스킬로 작성된 훅(연구소의 첫인상이므로 좋게 만드세요), 1-2개의 하이라이트 단어, 1개의 줌, 가장 강력한 라인에 대한 하나의 명제문. visuals 스킬로 2-4개의 팝업을 추가하세요(예: 사용자가 언급한 목록의 칩, 프롬프팅에 대해 말하면 채팅 창). 연구소가 실제로 하는 일을 보여주기 위함입니다. 비하인드 모먼트는 추가하지 마세요.

  4. 스타일 시트: uv run tools/build.py projects/welcome-sample --looks presets를 실행하세요. 모든 스타일의 사용자 클립이 나란히, LOOKS= 다음에 인쇄된 순서대로 있는 이미지 하나가 열립니다. 먼저 이미지를 직접 보고(읽기) 텍스트를 읽을 수 있고 얼굴을 가리지 않는지 확인하세요.

  5. 각 스타일을 인쇄된 순서대로, 각 키트의 description(packs/<name>/kit.json)을 사용하여 한 줄씩 간략히 소개하세요. 위쪽 행은 훅과 자막을 보여주고 아래쪽 행은 팝업을 보여줍니다. 그런 다음 스타일은 최종 선택이 아니라 시작점임을 명확히 말하세요:

    가장 마음에 드는 느낌을 선택하세요. 모든 것은 나중에 변경할 수 있습니다: "이거지만, 세이지와 크림 색상으로", "내 색상 사용: #…", "더 부드러운 폰트", "분홍색 없음". 클립에서 다시 만들어서 볼 수 있도록 해드립니다.

    어떤 것을 움직이는 것으로 보고 싶은지 물어보세요.

  6. 사용자가 선택한 각 스타일에 대해: uv run tools/build.py projects/welcome-sample --kit <name> --out sample-<name>을 실행하세요. QuickTime에서 열립니다. 두 개를 선택하면 둘 다 빌드하고 하나씩 엽니다.

2단계에서 브랜드 색상, 폰트 또는 스크린샷을 제공한 경우 "또는 브랜드에서 스타일을 만들 수도 있습니다"라고 제안하세요. 5단계를 참조하세요.

4. 키트 저장하기

사용자가 선택하면 (예: "Editorial, 하지만 세이지와 크림 색상으로" 또는 "Playful, 하지만 더 차분하게"):

  1. packs/<preset>/kit.json을 packs/<사용자이름-소문자>/kit.json으로 복사하세요. 복사본에서:

    • "name": 사용자 이름
    • "preset": false
    • "based_on": "<preset>"
  2. 사용자의 에너지를 적용하세요:

    에너지강도줌 점프 / 펀치sfx 음량_db명제문 수
    차분하고 사려 깊게clean1.04 / 1.08−17최대 1
    따뜻하고 수다스럽게signature1.07 / 1.13−13최대 1–2
    고에너지full1.12 / 1.22−10최대 2

    rules.intensity, zoom, sfx.volume_db 및 rules.statement 문구를 일치하도록 변경하세요.

    사운드 세트 (sfx.palette):

    • 차분: soft
    • 따뜻함: soft 또는 playful
    • 고에너지: punchy
    • 기술 또는 AI 주제: clicky 고려

    모든 사운드는 sfx/sound-menu.mp4에서 들을 수 있고 "playful 사운드 사용"이라고 말하여 세트를 전환할 수 있다고 한 번 언급하세요. "사운드 효과 없음"이라고 말한 경우 "sfx": {}로 설정하세요. 대문자 없음이라고 말한 경우 style.caption_case, style.hook_case 및 style.statement_case를 "none"으로 설정하세요.

  3. 인터뷰 또는 요청 시점의 색상을 적용하세요 ("이 색상 대신 사용"):

    • 16진수 코드 또는 일반 이름에서: "sage" 또는 "dusty pink"도 괜찮습니다. 세련된 16진수를 선택하고 알려주세요.
    • colors의 값을 바꾸고 역할을 유지하세요: 밝은 색은 카드와 자막에, 어두운 색은 명제문 배경과 잉크에, 밝은 색은 하이라이트와 visuals.rotate에 사용합니다.
    • 대비 확인: 텍스트가 배경에서 읽을 수 있어야 합니다.
    • 키트의 스타일 시트를 다시 렌더링하세요 (--looks <their-kit>) 전체 샘플 전에 사용자가 볼 수 있도록.
    • 폰트도 동일하게 작동합니다: 무료 Google Font라면 모두 가능합니다 (fonts.py가 존재를 확인합니다).
  4. 키트의 폴더 이름을 brand/kit.txt에 쓰세요.

  5. 사용자의 키트로 샘플을 한 번 더 빌드하세요: uv run tools/build.py projects/welcome-sample --out sample-mine. QuickTime에서 열립니다. 물어보세요: "이것이 당신의 스타일입니다. 바꾸고 싶은 것이 있나요?" 변경 사항을 키트(프리셋 아님)에 적용하고 사용자가 만족할 때까지 다시 빌드하세요. "자막 더 작게", "노란색 덜", "기울기 없음"과 같은 작은 변경은 kit.json에서 한 줄 편집입니다.

5. 브랜드에서 스타일 만들기 (요청 시)

디자인 파일에서 (가장 좋은 방법)

사용자에게 브랜드 또는 디자인 문서(.md, PDF 또는 Google Doc 내보내기, 예: BRAND-DESIGN.md)가 있는 경우:

  1. 파일을 가져오세요. 사용자에게 채팅으로 드래그하거나 brand/에 드롭하도록 요청한 다음, 스타일의 진실 공급원으로 brand/design.md(또는 PDF 유지) 사본을 저장하세요.

  2. 키트에 매핑하세요:

    디자인 파일에서kit.json에서
    색상 팔레트(16진수 코드 및 각각의 용도)colors, 추가로 roles: 배경 → hook_card 및 label_bg, 텍스트 색상 → ink 및 hook_text, "명제문" 또는 어두운 블록 → statement_bg, 하이라이트 색상 → highlight_blocks, 악센트 → accent_pill, visuals.rotate
    "순수 검정이나 흰색은 절대 사용하지 않음" 유형 규칙가장 어두운 브랜드 색상을 잉크로 사용
    헤드라인 및 디스플레이 폰트fonts.display / poster, 이탤릭체 → fonts.italic, 산세리프 → label 및 자막
    시그니처 무브(이탤릭 혼합, 단어 뒤 하이라이트 블록, 기울기, 스티커, 모두 대문자)moves 및 style (hook_case, statement_case, radius)
    분위기 ("차분", "발랄", "럭셔리")visuals.motion, visuals.density, sfx.palette
    사진 또는 비디오 스타일(따뜻함, 무드 있음, 밝음, 필름 느낌)grade: contrast, saturation, brightness, warmth (−0.05 ~ 0.05), vignette (0–0.5), legibility (텍스트 뒤 어두운 그라데이션, 0–0.5). 피부는 자연스럽게 유지: 필름 그레인, 과도한 크러쉬 금지.
    아이콘, 그래픽 요소, 스티커, 버튼(선 두께, 둥글기 또는 사각형, 채워진 색상 타일)visuals.icon_stroke (얇은 1.5 → 굵은 2.5), visuals.radius, visuals.card (solid / outline / glass), visuals.accent (아이콘 타일 색상), visuals.rotate (칩 및 스티커 색상)
  3. 유료 또는 커스텀 폰트: 폰트 파일을 찾으세요. 사용자가 있으면 fonts/private/에 드롭하고 키트가 "file"을 사용합니다. 없으면 가장 가까운 무료 Google Font를 선택하세요: 대비, 너비(키가 크거나 좁은지?), 이탤릭체 존재 여부를 일치시키세요. 대체한 폰트와 그 이유를 알려주세요. 예: "유료 세리프 → Instrument Serif: 동일한 키가 크고 대비가 강한 느낌, 이탤릭체 있음."

  4. 보여주세요: --looks <their-kit>를 렌더링하고 sample-mine을 빌드하세요. 파일에서 직접 가져온 부분과 해석한 부분을 말하세요.

  5. 동기화 유지: 나중에 사용자가 디자인 파일을 업데이트하면("브랜드 색상을 바꿨어요"), brand/design.md를 다시 읽고 같은 방식으로 키트를 업데이트하세요.

스크린샷 또는 붙여넣은 색상에서

사용자가 프리셋 대신 자신만의 스타일을 원할 때:

  1. inspiration/의 스크린샷, 브랜드 가이드 또는 붙여넣은 코드를 읽으세요. 다음을 기록하세요:
    • 유형: 세리프 또는 산세리프, 두께, 모두 대문자 여부, 이탤릭 혼합 여부
    • 자막 처리: 윤곽선, 그림자 또는 상자; 전체 구문 또는 단어별
    • 카드 모양 및 둥글기
    • 4–6가지 색상
    • 얼마나 복잡한지
  2. 가장 가까운 프리셋에서 시작하여 다른 점만 변경하세요. 폰트는 무료 Google Fonts여야 합니다: {"family": "<Google Font name>", "google": true, "weight": N} (이탤릭체의 경우 "italic": true 추가). 각 폰트가 uv run tools/fonts.py "<family>" --weight N으로 다운로드되는지 확인하세요. 유료 폰트를 소유한 경우 파일을 fonts/private/에 드롭하고 {"family": "...", "file": "fonts/private/<file>", "weight": N}을 사용할 수 있습니다.
  3. 다른 제작자의 정확한 폰트와 색상을 복사하지 마세요. 느낌을 취하되 상표가 있는 스타일은 피하세요.
  4. 확인을 위해 --looks <their-kit>를 렌더링한 다음 4단계와 같이 sample-mine을 빌드하고 채팅에서 반복하세요.

6. 마무리

약 3줄로 다음을 알려주세요:

  • 스타일이 저장되었으며 모든 릴에서 자동으로 사용됩니다.
  • 릴을 편집하는 방법: inbox/ 또는 채팅에 클립을 드롭하고 "이 릴을 편집해 줘"라고 말하세요. 사용자가 자르고, 채팅에서 라인을 검토하고, 사용자의 스타일로 빌드합니다.
  • 팝업 그래픽이 사용자가 말하는 내용을 설명합니다. "그래픽 보여줘"라고 하면 스타일의 모든 14개 그래픽 카탈로그가 재생됩니다.
  • 선택 사항: "reels orbiting you" 효과와 프로필 그리드(tools/reels.py add)를 위해 사용자 자신의 릴 6개를 채팅에 드롭하세요. 팔로우 애니메이션을 위해 실제 Instagram 숫자를 한 번 제공하세요(brand/instagram.json에 저장됨).
  • 어떤 라인이든 밈이나 GIF를 요청할 수 있음("여기에 David Rose 'ew' 밈 넣어 줘"). 검색하려면 무료 GIPHY 키가 필요하며, 처음에는 도움을 드릴 것입니다. 사용자 자신의 GIF 파일은 즉시 작동합니다.
  • 색상과 폰트는 절대 잠겨 있지 않습니다: "이 색상 대신 사용"은 어떤 릴에서든, 언제든지 작동합니다.
  • 언제든지 말만 하면 무엇이든 변경할 수 있음("자막 더 작게", "이번 거는 소리 없이", "이번 릴은 Loud 스타일 시도해 봐").
  • 완성된 릴은 Finished reels 폴더에 저장됩니다.
  • 명령어: 새 클립용 /new-reel(각 릴마다 이 폴더에 새 채팅 시작), 새 버전을 얻으려면 /update, 문제가 발생하면 /report-problem.

그런 다음 제안하세요: "방금 주신 전체 클립을 첫 번째 실제 릴로 편집해 볼래요?" 예인 경우 이 채팅에서 새 릴 스킬을 실행하세요.

키트 스타일 스위치 (조정용)

kit.json → "style":

  • caption_outline: px; 0은 그림자만 의미
  • caption_case: "none" / "uppercase"
  • hook: "card" / "bare" (카드 없음, 윤곽선 텍스트)
  • hook_size
  • hook_case
  • statement_case
  • label: "ticket" / "pill"
  • label_mark: 이름과 주제 사이의 기호
  • radius
  • shadow / shadow_soft: rgba 색상

"captions":

  • mode: "karaoke" (단어가 빛남), "phrase" (전체 구문), "word" (한 번에 하나의 큰 단어)
  • size
  • max_words
  • position_y

"moves":

  • tilt_degrees
  • highlighter_blocks

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

Edit a talking-head reel from a raw clip. Use whenever the user says "I have a new reel", "edit this reel", "new clip", drags a video into the chat or drops one in inbox/, or gives edits to a rough cut ("drop line 3", "end line 9 at…", "good, move on"). Covers transcription, the rough cut and the review, all in the chat.

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

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").

관련 스킬