Communitygithub.com

beachyphotoandfilm-arch/video-skills

각 릴에 맞춤 Instagram 커버를 디자인합니다. 릴의 내용을 읽고, 짧은 후크 헤드라인을 작성하며, 태그된 사진 라이브러리에서 사진을 선택하고, 기존 커버 스타일로 레이아웃한 후, 폰 크기의 그리드 뷰에서 검수합니다. AI 이미지 생성 없이 로컬에서 렌더링됩니다.

video-skills란 무엇인가요?

이 스킬은 인스타그램 릴(post/reel) 각각에 대해 고유한 커버 이미지를 자동 생성합니다. 주요 기능은 릴의 스크립트를 분석해 주제를 파악하고, 'hooks.md'에 정의된 훅 유형과 규칙에 따라 짧은 헤드라인을 작성하며, 기존에 태그된 사진 라이브러리('library.json')에서 적절한 사진을 선택하여 레이아웃을 구성하는 것입니다. 로컬 환경에서 Puppeteer를 사용해 HTML/CSS 기반으로 렌더링하므로 AI 이미지 생성이 전혀 일어나지 않으며, 브랜드 폰트와 색상을 설정 파일에서 지정할 수 있습니다. 생성된 커버는 1080x1920 JPG와 함께 그리드 검수용 이미지도 함께 제공하여, 폰 화면에서도 가독성과 시각적 일관성을 확인할 수 있도록 돕습니다. Claude Code, Cursor 등 MCP를 지원하는 IDE에서 실행 가능합니다.

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

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

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

문서

릴 커버

모든 릴은 고유한 커버를 갖습니다. 실제 사진과 실제 서체로 제작되며, Instagram 프로필 그리드에 표시되는 부분 안에 텍스트가 들어갑니다.

설정: 여기에 브랜드 정보를 입력하세요

첫 실행 전에 이 설정들을 한 번만 수정하세요.

설정위치기본값
강조 색상scripts/cover.html의 --brand#3b82f6
헤드라인 폰트scripts/cover.html의 --display-fontAnton (무료, Google Fonts)
서브라인 폰트scripts/cover.html의 .subMontserrat Bold (무료)
기본 서브라인커버 하단예: "from a Home Cook", 또는 없음
사진 폴더library.json의 photos_dir<PATH_TO_YOUR_COVER_PHOTOS>
Canva 사진 폴더 (선택사항)library.json의 canva_folder<YOUR_CANVA_FOLDER_ID>
Canva 커버 마스터 문서 (선택사항)현재 스타일 참조용<YOUR_CANVA_COVER_MASTER_DOC_ID>
Canva 스크래치 디자인 (선택사항)Canva에서 사진 내보내기용<YOUR_CANVA_SCRATCH_DESIGN_ID>
커버 로그pick.py의 COVER_LOG 환경 변수프로젝트 루트의 drafts/social/cover-log.json
완성된 커버 저장 위치8단계<YOUR_VIDEO_FOLDER>/<Video> YYYY-MM-DD/Covers/
금지어hooks.md 규칙목록 (예: 이전 오퍼 이름)

Instagram 전용으로 제작되었습니다. 이 커버는 일반 IG + TikTok + Shorts 게시물의 비디오 썸네일로 사용할 수 있습니다 (예: Metricool의 videoThumbnailUrl). 디자인에 영향을 미치는 것은 Instagram 그리드뿐입니다. 이미 커버가 있는 게시물의 커버를 절대 교체하지 마세요.

AI로 이미지를 생성하지 마세요. 배경은 사용자의 사진이며, 레이아웃은 기존 커버에서 가져옵니다. 코드는 단지 배열만 합니다.

기본 하우스 스타일 (취향에 따라 변경)

마스터 문서에서 가장 최신 커버만 참조하세요. 과거에 사용했던 오래된 스타일은 고려하지 않습니다.

  • 밝고 중립적인 배경의 사진에 관련 소품(노트북, 카메라, 휴대폰, 제품)이 있고, 텍스트가 들어갈 자리는 평평한 벽
  • 헤드라인은 흰색 디스플레이 폰트, 항상 대문자, 가운데 정렬, 2~3줄, 비교적 작게
  • 선택적 서브라인은 Montserrat Bold, 일반 대소문자
  • 기본 설정: 그림자 없음, 테두리 없음, 텍스트 뒤에 띠나 어두운 영역 없음, 강조 색상 텍스트 없음
  • 레이블, 기울임꼴, 스크립트/필기체 폰트, 큰 숫자나 시리즈 레이아웃 없음
  • 유일한 추가 요소: 가끔 강조 색상의 손으로 그린 화살표
  • 릴 아이콘 아래에는 아무것도 배치하지 않음: Instagram 그리드는 각 타일의 오른쪽 상단에 아이콘을 배치합니다. render.mjs는 x 760 초과, y 540 미만에 요소가 있을 경우 경고합니다.

헤드라인 규칙, 훅 유형 및 레이블은 hooks.md에 있습니다. 헤드라인을 작성하기 전에 반드시 읽으세요.

파일

scripts/cover.html하나의 레이아웃: 헤드라인 + 선택적 서브라인, arrow / inset / avatar 추가 요소 포함. 상단에 브랜드 설정이 있습니다.
scripts/render.mjs1080x1920 JPG 및 두 가지 검수 이미지를 렌더링하고, 안전 영역을 벗어난 텍스트나 8MB를 초과하는 파일에 대해 경고합니다.
scripts/pick.py주제별로 사진을 추리고, 마지막으로 사용된 9장을 차단하며, 최근 레이아웃과 훅 유형을 출력합니다.
library.json모든 사진, 태그 포함 (포즈, 소품, 빈 공간 위치, 초점). 예시 포함; 직접 구축하세요.
커버 로그 (COVER_LOG)배포된 모든 커버. 고유성을 유지합니다.
photos_dir원본 해상도 사진 (로컬 전용, git에 보관 금지)

scripts/에는 puppeteer-core (npm i puppeteer-core를 scripts/에서 실행하거나 scripts/node_modules를 다른 스킬의 설치에 심볼릭 링크)와 Google Chrome 및 ffmpeg가 필요합니다. render.mjs는 기본 macOS Chrome 경로를 가리킵니다. executablePath가 다를 경우 변경하세요.

실행 방법

1. 릴 파악하기. 각 릴의 대본, 캡션 및 오프닝 텍스트 카드가 필요합니다. 릴이 제공하는 하나의 약속을 명명하세요.

2. 헤드라인. 마지막 커버와 다른 유형의 훅을 선택하세요 (pick.py가 출력). 각각 38 단어로 된 옵션을 34개 작성하고, 가장 강력한 것을 선택하세요. 오프닝 텍스트 카드를 그대로 반복해서는 안 됩니다.

3. 사진.

python3 .claude/skills/reel-covers/scripts/pick.py "<주제 단어>" --space top

그런 다음 상위 3~4개를 선택하기 전에 살펴보세요 (ffmpeg로 콘택트 시트를 만드세요). 소품을 주제와 일치시키세요: 이메일, 시스템 또는 웹사이트 관련은 노트북; 장비 관련은 카메라 또는 제품; 판매 및 마인드셋 관련은 말하는 모습. 고객 사례의 경우, 고객의 삽입 사진이나 아바타를 사용하세요 (허가 필요).

4. 레이아웃. 마지막 커버와 동일하지 않아야 합니다 (pick.py 참조). 사진의 빈 공간(space)에 텍스트를 배치하고, 얼굴이 가려지지 않도록 focus를 설정하며, 텍스트 블록이 300에서 1250 사이에 위치하도록 y를 설정하세요.

5. 렌더링.

OUT="<작업폴더>/covers" node .claude/skills/reel-covers/scripts/render.mjs covers.json
{"covers":[{"id":"3-the-exact-close","img":"<PATH_TO_YOUR_COVER_PHOTOS>/<file>.jpg",
  "data":{"head":"the exact close I use on sales calls","sub":"from a Home Cook","y":560,"headroom":280}}],
 "history":["<커버 로그에서 가장 최근에 배포된 커버 파일, 최신순>"]}

~를 실제 경로로 확장하세요; render.mjs는 확장하지 않습니다. 0이 아닌 종료 코드는 경고를 의미하므로 공유 전에 수정하세요.

6. 직접 확인하세요. _proof.png와 _grid-phone.png를 여세요:

  • 헤드라인이 그리드 검수 이미지(130px 너비)에서 읽을 수 있나요? 아니라면 단어를 줄이세요.
  • 얼굴이 전체 커버와 그리드 크롭 모두에서 텍스트와 겹치지 않나요?
  • 그리드에서 다른 커버 옆에 놓았을 때, (사진, 레이아웃, 텍스트 위치)가 다르지만 분명히 같은 세트에서 온 것처럼 보이나요?

7. 게이트. 사용자에게 _grid-phone.png와 _proof.png를 보여주고, 각 헤드라인과 하나의 대체 헤드라인을 함께 제시하세요. 질문: "이 커버들이 스크롤을 멈추게 하나요?" 요청에 따라 사진이나 단어를 바꾸고 다시 렌더링하세요. 몇 초면 됩니다.

8. 승인 후:

  • 각 JPG를 <YOUR_VIDEO_FOLDER>/<Video> YYYY-MM-DD/Covers/에 릴 이름으로 복사하세요 (예: 3. the exact close.jpg).
  • 커버 로그에 커버당 하나의 항목을 추가하세요: {"date":"YYYY-MM-DD","video":"<video-slug>","reel":"3. the exact close","photo":"<file>","layout":"stack","hook_type":"how","head":"the exact close I use on sales calls","file":"<Covers 폴더의 JPG 절대 경로>"}
  • 파일을 스케줄링 단계에 전달하여, 각 파일을 업로드하고 Instagram 게시물에 첨부합니다.

고유성 규칙

  • 마지막 9개 커버에 사용된 사진은 사용할 수 없습니다. pick.py가 이를 강제합니다.
  • 동일한 레이아웃이나 훅 유형을 연속으로 두 번 사용할 수 없습니다.
  • 서브라인을 순환시키세요: 없음, 가운데 정렬, 또는 오른쪽으로 밀고 기울임 (subdx, subrot).
  • 사진에 따라 텍스트 위치를 다양하게 하세요 (상단, 중간, 왼쪽 또는 오른쪽 정렬). 항상 상단 중앙에 배치하지 마세요.
  • 라이브러리가 부족해지면 (좋은 사진이 최근에 모두 사용됨), 규칙을 위반하지 말고 새 사진 촬영을 제안하세요.

레이아웃 교훈

  • 9:16 크롭은 얼굴을 위쪽에 배치합니다. 대부분의 사진은 2:3입니다. 1920 높이로 확장하면 측면이 잘리고 위쪽은 잘리지 않으므로, 원본에서 낮아 보이는 얼굴이 y 600~800 정도에 위치합니다. 가장 흔한 실수는 텍스트가 대상의 머리카락 위에 놓이는 것입니다. 다른 것보다 먼저 모든 검수 이미지에서 이를 확인하세요.
  • 텍스트를 줄이는 대신 headroom으로 수정하세요. "headroom": 150-350은 사진을 아래로 밀고 대상 위의 평평한 벽을 늘립니다. 평평한 스튜디오 벽에서는 보이지 않습니다. 복잡한 야외 배경(나무와 하늘은 번짐)에서는 사용하지 마세요.
  • 헤드라인 크기: 자동은 4단어 이하의 경우 104px, 더 긴 경우 84px이며, 3줄에 맞게 축소됩니다.
  • 서브라인이 머리에 닿으면 생략하세요. 그것은 질감일 뿐, 메시지가 아닙니다.
  • 릴 아이콘을 고려한 텍스트 배치: 블록을 y 560 이하에서 시작하거나 (headroom으로 사진을 아래로 밀어 머리가 가려지지 않도록), 높게 유지하고 align: left, right: 320을 사용하세요. 배치 전체에서 두 가지를 혼합하세요.
  • 3:4 그리드 크롭은 y 240 위를 숨기지 않습니다. 텍스트는 280 이하에서 시작하세요 (render.mjs가 경고함).

사진 추가

로컬 폴더에서: 중복 확인을 위해 photos_dir에 대해 md5 체크를 수행하고, <name>-<k>__local<MMDD>.jpg로 복사한 후 태그를 추가하세요.

Canva에서 (선택사항). Canva는 업로드 폴더에서 직접 이미지를 다운로드할 수 없습니다. 작동하는 방법은 내보내기 전용으로 사용되는 스크래치 디자인입니다:

  1. <YOUR_CANVA_FOLDER_ID>에서 list-folder-items를 실행하고, 에셋 ID를 library.json과 비교하세요 (각 파일 이름의 __ 뒤에 ID를 유지).
  2. open_transaction으로 <YOUR_CANVA_SCRATCH_DESIGN_ID>에서 read-design을 실행한 후, 각 새 사진에 대해 add_page(2400x3600, 제목 = 에셋 ID)가 포함된 edit-design 호출을 한 번 실행하세요. 새 페이지 ID를 읽은 후, 페이지당 하나의 insert_fill(전체 페이지, top 0, left 0)을 포함한 호출을 한 번 실행하세요. commit을 실행합니다.
  3. **PDF, export_quality: pro**로 export-design을 실행한 후, pdfimages -j -f <first> -l <last> -p all.pdf ex/img를 실행합니다. PDF는 원본 JPEG를 그대로 포함합니다. JPG 내보내기도 작동하지만 페이지당 하나의 URL을 제공합니다.
  4. 각 파일을 <name>__<assetid>.jpg로 photos_dir에 저장합니다. 여러 사진이 동일한 Canva 이름을 공유할 수 있으므로, ID가 구분합니다. 그런 다음 태그를 추가하세요.

동일한 사진이 두 번 업로드된 경우, 하나의 복사본을 ok로 유지하고 다른 하나에 "ok": false, "note": "duplicate of N"을 표시하거나, 중복 금지 규칙이 동일한 사진을 두 번 선택할 수 있습니다.

library.json에서 각 새 파일을 보고 태그를 추가하세요:

{"file":"photo_-13.jpg","pose":"smiling at laptop","props":["laptop","desk"],"topics":["email","follow","systems","website"],
 "cap":false,"space":["top"],"focus":"50% 55%","ok":true}

space는 텍스트가 얼굴에 닿지 않고 배치될 수 있는 위치입니다. 흐릿하거나, 어둡거나, 어색한 사진은 삭제하지 말고 "ok":false로 표시하세요.

관련 항목

  • video-reels: 오프닝 텍스트 카드. 커버 헤드라인은 이를 반복해서는 안 됩니다.
  • 스케줄링 스킬 (선택사항): 커버를 업로드하고 릴을 예약합니다.

Individual skills in this repo

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

beachyphotoandfilm-arch/video-skills

Sync camera footage to a separate lapel or field-recorder track (e.g. Tascam DR-10L and similar) and lay it up in DaVinci Resolve. Stitches the recorder's split files, finds each clip's exact place in the audio by matching words then waveforms, cuts one lapel slice per clip so every later skill works unchanged, checks for clipping, and builds a synced timeline in a new Resolve project. Trigger on "sync the lapel", "sync my audio", "line up the recorder", "I used a lav", or any shoot with a separate audio folder (live talks, events, workshops). Run it before paper-edit or video-reels.

beachyphotoandfilm-arch/video-skills

Turn raw talking-head footage into an assembled rough cut inside DaVinci Resolve. Pulls the clips off your footage drive, transcribes them locally, removes failed takes, restarts, asides and dead air, then creates a new Resolve project with two paper-edit timelines ready for your fine trim. Trigger on "paper edit", "cut my raw footage", "make a rough cut", "clean up this video", or when the user points at a folder of raw camera files for a YouTube video.

beachyphotoandfilm-arch/video-skills

Render finished reels out of DaVinci Resolve, write captions in the creator's voice, attach a custom Instagram cover from reel-covers, and schedule them to Instagram, TikTok and YouTube Shorts through Metricool. Handles the Drive upload hop, collision checks against the existing calendar, and cleanup. Trigger on "schedule the reels", "post these", "put these on the calendar", or after reels are approved.

beachyphotoandfilm-arch/video-skills

Build animated brand overlays (motion graphics) for a talking-head video, timed to the speaker's exact words, plus a DaVinci Resolve import file. House style is in-scene type (text beside and behind the speaker's head) plus diagrams. Transcribes the rough cut locally, picks the moments, renders transparent .mov clips, and writes an FCPXML that drops every clip onto the timeline already in position. Trigger on "make animations for this video", "add overlays/motion graphics", "animate this", "b-roll graphics for my YouTube video", or when the user shares a rough cut and asks for graphics.

beachyphotoandfilm-arch/video-skills

Cut vertical Instagram reels out of a long-form talking-head video, hook first. Picks the strongest standalone moments from the transcript, opens each reel on its punchiest line, builds vertical timelines in DaVinci Resolve framed on the speaker's face with the LUT applied, and finishes them: a hook (a held text card, or a word-by-word "build" hook with punch-in) and burned-look captions on V3; this-or-that reels get product graphics and a comment-keyword CTA card. You trim and render, nothing to import. Trigger on "make reels", "clip this for Instagram", "cut some verticals", or after a YouTube video is cut.

beachyphotoandfilm-arch/video-skills

Design YouTube thumbnails and titles for a talking-head video. Pulls graded full-res frames out of the raw footage, renders brand-styled variants in two proven layouts, and proofs them at phone size where the click actually gets decided. Trigger on "make thumbnails", "thumbnail for this video", "title and thumbnail", or after a video is cut.

beachyphotoandfilm-arch/video-skills

Run the whole YouTube video pipeline end to end, one stage at a time, stopping for the creator's approval at every gate. Paper edit, punch-ins, reels, reel covers, scheduling the reels, overlays, thumbnail and title, then scheduling the long-form video, all through Metricool. Keeps state per video so you can stop anywhere and pick up later. Trigger on "/youtube", "let's do the whole video", "run the video pipeline", "continue the <name> video", or when handed raw footage for a YouTube video.

관련 스킬