Communitygithub.com

elkl111/reels-editing-lab-beta

비주얼 디렉터입니다. 말하는 사람의 발언을 비트 단위로 설명하는 팝업 그래픽(칩, 숫자, 채팅창, 체크리스트, 다이어그램 등)을 키트 스타일에 맞춰 계획합니다. 새 릴 빌드 단계에서 사용자가 그래픽을 더 추가하거나 줄이라고 요청하거나("팝업 더 보여줘", "이 부분을 설명해줘", "여기 체크리스트 넣어줘"), 어떤 그래픽이 있는지 물을 때("뭐 추가할 수 있어?", "옵션 보여줘") 사용하세요.

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

이 스킬은 화면에 등장하는 팝업 그래픽을 기획하는 비주얼 디렉터 역할을 합니다. 사용자의 릴 영상 대본(transcript)을 분석하여 말하는 내용을 시각적으로 보여주는 작은 그래픽 요소들을 비트 단위로 설계합니다. 예를 들어, 목록을 말할 때 항목별로 칩이 나타나고, 숫자를 언급하면 숫자가 표시되며, 프롬프트를 입력했다는 내용은 채팅창이 타이핑되는 식으로 표현합니다. 각 그래픽은 말하는 단어의 인덱스에 정확히 맞춰 등장하고 사라지며, 말하는 사람의 얼굴을 가리지 않도록 머리 주변에 배치됩니다. 사용자가 직접 요청하지 않는 한 밈이나 GIF를 추가하지 않으며, 커스텀 인서트가 필요한 경우 하위 에이전트를 병렬로 실행하여 HTML 파일을 생성하고 렌더링합니다. 이 스킬은 Claude Code, Cursor, Codex 등 AI 에이전트 플랫폼에서 사용할 수 있으며, 사용자의 키트 스타일과 밀도 설정에 따라 그래픽의 움직임, 카드 스타일, 색상 등을 조정합니다.

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

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

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

문서

비주얼 디렉터

훌륭한 토킹헤드 릴은 말하는 사람이 말하는 내용을 한 비트씩 보여줍니다. 목록은 각 항목이 언급될 때마다 칩이 튀어나오고, 숫자는 카운트업되며, "프롬프트를 입력했어"라는 말은 채팅창이 입력하는 모습으로 표시됩니다. 각 조각은 작고, 머리 주변(얼굴 위는 안 됨)에 배치되며, 해당 단어가 발화되는 순간 정확히 나타납니다.

이 작업은 build.json → "visuals": [...]에서 계획합니다. 엔진이 배치, 키트의 룩, 애니메이션, 팝업당 사운드를 처리합니다.

1. 릴을 비트 단위로 읽기

잠긴 라인(edl.json)을 단어 인덱스와 함께 살펴보세요: python3 -c "import json;w=json.load(open('projects/<name>/transcript.json'))['words'];c=json.load(open('projects/<name>/cut.json'));[print(' '.join(f\"{x['i']}:{x['w']}\" for x in w[a:b+1])) for a,b in (l['words'] for l in c['lines'])]"

보여줄 수 있는 내용이 있는 모든 비트를 표시하세요:

  • 사물의 목록
  • 숫자
  • 도구 또는 앱
  • 동작(타이핑, 전송, 예약)
  • 전/후 또는 이것 대 저것
  • 프로세스 또는 단계
  • 시스템
  • 사람 또는 스토리
  • 시간 범위
  • 거절된 아이디어
  • 강조할 가치가 있는 키워드

채움, 전환, 객체 없이 감정만 있는 것은 아무것도 표시하지 않습니다.

2. 각 비트에 맞는 조각 선택하기

말하는 내용조각예시
목록 ("마케팅, 인보이스, 이메일")chips, 각 단어가 발화될 때 항목 하나씩각각 word가 있는 항목들
버리거나 닫히는 것 ("내 머릿속의 그 모든 탭들")"close": true인 chips
숫자 ("100+ 클라이언트", "오후 3시", "2명 팀")number"value": "100+", "label": "clients"
한 줄의 키워드 또는 강조점word (생각이나 질문은 "style": "type")"text": "진정한 *지원*"
거절하는 것 ("50단계는 아니야", "또 다른 앱이 아니라")strike"pre": "No", "text": "50 steps", "strike_word": i
프롬프트 입력, AI에게 질문, DM 보내기chat"prompt": "...", "reply": "..." (선택 사항)
판매, 메시지, 예약, 알림notify"app": "Stripe", "title": "New payment: €497"
완료된 단계, 할 일 목록, 성과checklist각각 word가 있는 항목들
"단계 1 / 첫 번째 것 / 파트 2"step"n": 1, "text": "*train* it"
변화 또는 프로세스 (A → B → C)flow아이콘과 텍스트가 있는 항목들
시스템, 연결된 도구들, "모든 것이 한 곳에"hub아이콘이 있는 center와 nodes
시간 범위 ("한 달 안에… 3년 안에")scalemarks, from, to, move_word
클라이언트, 사람, 누군가에 대한 이야기person"name": "Abby", "note": "coach", "meter": 3
이것 대 저것, 예전 방식 대 새 방식versusleft (✗) / right (✓), right_word
사용자가 요청할 때만 넣는 밈 또는 GIFgif"file": "projects/<name>/memes/3.mp4", "caption": "me reading my old *captions*"
프로필, 스크린샷, 앱phone"image": "assets/profile.png" (사용자가 준 이미지만)

조각 위의 텍스트:

  • 칩, 노드 또는 레이블당 1–3단어
  • 사용자의 단어를 사용
  • 제목 형식도 괜찮지만, chat과 notify를 제외하고는 완전한 문장 금지

아이콘: uv run tools/icons.py calendar money email로 실제 이름을 찾고, 절대 추측하지 마세요. 알 수 없는 아이콘이 있으면 빌드가 중단됩니다.

시그니처 조각 (사용자 자신의 자료가 필요)

  • 그들의 릴이 주위를 공전: events(visuals 아님)에서 {"type": "orbit", "word": i, "until_word": j}.
    • 자신의 콘텐츠나 작업물에 관한 라인("나는 이런 걸 300개나 만들었어")에 사용하세요.
    • brand/reels/가 필요합니다. uv run tools/reels.py add <their reel files or a folder>로 채우세요: 사용자가 내보낸 자신의 릴, 또는 연결된 경우 Apify로 자신의 프로필에서 다운로드한 것.
    • 그들의 릴은 뒤와 앞을 지나갑니다. 릴당 최대 한 번.
  • Instagram 프로필 팔로우 콜 투 액션용("팔로우 해줘", "BRAIN 댓글 남겨줘"):
    • {"kind": "profile", "word": i, "until_word": j, "keyword": "BRAIN"}; keyword는 선택 사항이며 댓글 시트에 입력됩니다.
    • 숫자는 brand/instagram.json에서만 가져옵니다(name, handle, posts, followers, following, bio, avatar). 없으면 실제 숫자를 물어보세요(또는 Apify로 자신의 프로필에서 가져오세요). 절대 추정하거나 만들지 마세요.
    • 그리드는 brand/reels/를 사용합니다. Follow(및 Post)에서 탭 사운드가 재생됩니다.
  • 카드 형태의 다른 크리에이터 릴: "handle": "creatorname"이 있는 gif. @handle이 아래에 표시됩니다.
    • 항상 출처를 표시하고, 사용자가 지시한 클립만 사용하세요.
  • 커스텀 인서트 (어떤 조각도 맞지 않을 때, 예: 사용하는 앱의 재현, 파일 스크롤 등): 하위 에이전트로 빌드하세요. 아래 "커스텀 인서트"를 참고하세요.

움직임(motion)

키트의 visuals.motion: gentle / snappy / bouncy / blur (블러 팝업으로 나타나 선명해짐) / rise (차분한 에디토리얼).

  • word 팝에 "style": "rise"를 사용하면 각 글자가 줄에서 하나씩 순서대로 올라옵니다. 세리프 강조 단어에 좋습니다. 키트에서 visuals.word_style: "rise"로 기본값으로 설정할 수 있습니다.
  • 캡션은 captions.pop: "blur"로 블러 팝업이 가능합니다.

커스텀 인서트 (병렬 하위 에이전트)

  1. 먼저 타이밍을 고정: 맞춰야 할 단어 시간을 인서트 자체의 시계로 변환합니다(t = 0은 인서트가 나타나는 시점).
  2. 인서트당 하나의 하위 에이전트를 백그라운드에서 병렬로 생성(Agent 도구)하고, 계속 빌드합니다. 다음 정보를 브리핑하세요:
    • 무엇을 보여주는지, 그리고 어떤 라인 아래에서 재생되는지. 사용자의 실제 데이터만 사용; 그 외는 일반적인 플레이스홀더. 실제 인물 금지, 복사된 로고 금지.
    • 작업 위치: projects/<name>/inserts/<insert-name>/index.html. 다른 것은 건드리지 마세요.
    • 크기 및 지속 시간: 예: 900×700 px, 2.6초. 카드나 창 바깥의 배경은 투명하게 유지.
    • 계약: window.renderAt(t)는 t초 시점의 정확한 상태를 그립니다. 타이머, CSS 전환 또는 애니메이션 사용 금지, 프레임이 하나씩 캡처되기 때문입니다.
      • 로컬 폰트만 사용 (fonts/free/에서 복사).
      • 텍스트는 최소 24px, 사용자의 키트 색상 사용.
      • 타이핑된 텍스트: t 단계당 한 문자씩.
    • 비트, 음성에 고정된 시간.
    • 렌더링 uv run tools/insert.py <index.html> --dur <s> --w <w> --h <h> → insert.mov, 알파 채널 포함. 보고하기 전에 몇 프레임 확인.
    • 보고: 경로, 정확한 지속 시간, 비트 시간(사운드용). 이상한 점이 있으면 표시.
  3. 배치 {"kind": "insert", "file": "…/insert.mov", "word": i, "width": 640}. 인서트의 비트에 sfx_extra 클릭을 추가하세요.

밈과 GIF (요청 시에만)

  • 요청 없이 밈을 절대 추가하지 마세요. 밈은 취향 문제입니다. 보고서에서 제안("데이비드 로즈의 'ew'가 5번째 라인에 잘 어울릴 것 같아요")할 수는 있으며, 사용자가 동의할 때만 추가하세요.

  • 검색: uv run tools/memes.py search "<show> <character> <emotion or words>" --project projects/<name>. 예: "schitts creek david ew" 또는 "the office michael no god please no".

    • 최대 6개의 클립을 다운로드하고 SHEET=…/memes/sheet.png를 출력합니다. 시트를 읽고 사용자가 설명한 것과 일치하는 타일(올바른 캐릭터, 올바른 표정)을 선택하세요. 첫 번째 것이 아니라.
    • 타일은 1부터 6까지 번호가 매겨져 있으며, 왼쪽에서 오른쪽, 위에서 아래로 정렬됩니다.
  • 사용자 자신의 파일 ("이 GIF를 써줘"): uv run tools/memes.py add "<file>" --project projects/<name>은 memes/own-1.mp4를 생성합니다. 이미지도 작동합니다.

  • 배치:

    • {"kind": "gif", "file": "projects/<name>/memes/<n>.mp4", "word": i, "caption": "<their text>"}
    • 캡션은 선택 사항, 사용자의 단어로, 하나의 *emphasis* 포함. 기본 길이는 약 2.6초, 또는 "until_word" 설정.
    • 가로가 긴 클립은 머리 위에, 세로가 긴 클립은 턱 아래에 배치. "at": "full"은 캡션이 위에 있는 1.6초 전체 화면 컷어웨이를 만듭니다.
  • 보고서에: 어떤 것을 사용했는지 말하고, 시트를 여세요(open …/sheet.png). 사용자가 "밈 3번"이라고 말할 수 있습니다. 다른 클립은 이미 다운로드되어 있으므로, file만 변경하고 다시 빌드하면 됩니다.

  • 키 없음 (MEMES=no-key): 3분 무료 설정을 제안하세요:

    1. developers.giphy.com에 가서 가입하고 API 앱(SDK 아님)을 만든 후 키를 복사하세요.
    2. 채팅에 키를 붙여넣으세요.
    3. brand/keys.json에 {"giphy": "<key>"}로 저장하세요.

    사용자에게 직접 파일을 편집하도록 요청하지 마세요. 그때까지는 사용자 자신의 GIF 파일이 계속 작동합니다.

  • 한 번만 언급, TV나 영화 밈을 처음 사용할 때: 해당 클립은 스튜디오 소유입니다. 짧은 무음 반응 GIF는 Instagram에서 널리 사용되지만 약간의 위험이 있습니다. 사용자 자신의 클립에는 위험이 없습니다.

3. 타이밍 (대본의 단어 인덱스)

  • "word": i는 단어 i가 발화될 때 조각이 나타나게 합니다. 라인의 시작이 아닌 비트의 첫 번째 단어를 사용하세요.
  • 항목은 각각 고유한 "word"를 가지므로 각 칩, 체크 또는 노드가 발화될 때 정확히 나타납니다. 이것이 편집된 느낌을 주는 핵심입니다.
  • 조각 종료:
    • "until_word": j는 단어 j 이후에 종료
    • 그렇지 않으면 약 2–3초, 또는 마지막 항목 이후 1.4초까지 유지
    • "dur": 2.5로 길이 직접 설정
  • 다른 순간들도 단어에 맞춰 타이밍 가능: strike_word, reply_word (chat), right_word (versus), move_word / move_end_word (scale), meter_word (person), close_word (칩 닫기).

4. 키트의 밀도 (kit.json → visuals.density)

밀도빈도느낌
calm8–10초마다 하나깔끔한 전문가 설명
steady4–6초마다 하나대부분의 릴
busy2–4초마다 하나, 거의 연속빠른 "설명" 스타일

모든 밀도의 규칙:

  • 한 번에 하나의 조각만. 두 개가 겹칠 수 있는 경우는 다른 영역에 있고 같은 비트에 속할 때뿐.
  • 후크(처음 ~3초)나 스테이트먼트 중에는 절대 안 됨. 조각이 스테이트먼트를 대체할 수 있음: busy에서는 최대 1개의 스테이트먼트 사용.
  • 같은 종류를 연속으로 사용하지 마세요. 같은 목록이 계속되는 경우는 예외.
  • word 팝은 요약하거나 재구성해야 하며, 캡션을 그대로 반영하지 마세요. 같은 단어를 표시하면 엔진이 캡션을 숨깁니다. 작동은 하지만, "비즈니스의 포괄적인 개요" 대신 "비즈니스 전체" 같은 팝이 "non-negotiables"를 반복하는 것보다 더 가치를 더합니다.
  • highlight_words가 있는 단어에 팝업을 넣지 마세요.
  • chat은 자체적으로 작은 이야기를 연출: 프롬프트 입력(키 클릭 소리), 전송(스와이프 소리), AI "생각" 표시, 그다음 reply(제공된 경우). 타이핑이 끝난 후 약 1.5초를 주어 전송 시간을 확보. 사용자가 설명한 결과를 짧은 reply로 작성하면 더 효과적입니다.
  • 조각 사이에 짧은 숨 쉴 간격(≥0.4초)을 두세요.
  • "at"은 기본 위치와 충돌할 때만 영역을 재정의합니다(top, left, right, chest).

5. 빌드 및 확인

uv run tools/build.py projects/<name>. 빌드는 CHECK=…/check.png를 출력합니다: 각 순간과 팝업당 하나의 프레임. 읽고 다음 문제를 수정하세요:

  • 읽을 수 없음
  • 화면 밖
  • 얼굴 가림
  • 캡션과 충돌
  • 잘못된 단어 설명
  • SAFE ZONE: 라인에 나열됨 (Instagram의 사용자 이름, 캡션 또는 좋아요/댓글/공유 버튼 아래에 위치). 모든 것을 수정: 조각 이동("at"), 텍스트 단축, 더 일찍 종료. 모두 없어질 때까지 다시 빌드.

화면에 표시되는 내용:

  • 팝업, 후크 또는 스테이트먼트 텍스트에 em 대시 사용 금지. 쉼표, 마침표 또는 줄바꿈 사용.
  • 실제 숫자는 사용자 자신의 숫자이고 그가 말한 경우에만 사용. 채팅창, 댓글, DM은 일반 플레이스홀더 사용, 실제 인물 이름이나 증명용으로 만들어진 결과는 절대 사용 금지.
  • 다른 크리에이터의 게시물이나 릴이 화면에 나오면 @handle을 표시.

그런 다음 새 릴 스킬에서처럼 인계하며, 한 줄을 추가합니다(예: "팝업 12개: 4가지 작업에 대한 칩, '프롬프트'에 채팅창, AI 시스템 허브…").

사용자가 요청할 때

  • "어떤 그래픽을 추가할 수 있어?" / "옵션 보여줘": 키트에 대한 카탈로그 비디오가 있으면 열기(projects/*/catalog-<kit>.mp4). 없으면 최신 릴에서 렌더링: uv run tools/build.py projects/<name> --catalog. 각 조각을 한 번씩, 해당 룩으로, 레이블과 함께 보여줍니다. 절대 길게 설명하지 마세요.

  • "팝업 더/덜 보여줘": 이 릴의 밀도 변경; 사용자가 "항상"이라고 말하면 키트의 visuals.density에 저장.

  • "여기 체크리스트 넣어줘" / "팔로우 하라고 말할 때 내 프로필 보여줘": 해당 단어에 정확히 그 조각을 추가하세요.

  • 스타일 ("테두리 카드", "더 차분한 애니메이션", "더 굵은 아이콘"): 키트의 "visuals" 블록:

    • card: solid / outline / glass
    • motion: gentle / snappy / bouncy
    • icon_stroke: 1.5–2.5
    • radius
    • 색상: accent, strong, alert, word, card_color; 키트의 색상 이름 또는 hex 값

    키트를 변경하고, 프리셋은 사용하지 마세요.

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

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.

관련 스킬