/explainer
┌──────────────────────┐
│ Steal what works │ 제목, 악센트 색상 한 단어
│ [before] ⟶ [after] │ 비교: 카드, 화살표, 나타내기 (또는 번호 목록)
│ ╭──head──╮ │ 머리가 패널 위로 튀어나옴
│ ╭────┴────────┴────╮ │
│ │ 스피커, 자막 │ │ 둥근 패널, 눈높이 = 패널 상단
│ ╰──────────────────╯ │
└──────────────────────┘
첫 사용
이 스킬의 폴더는 Claude Code가 로드할 때 표시하는 "기본 디렉토리"입니다. 키트를 이 폴더에서 확인하고(심볼릭 링크도 작동), 한 번 설정합니다:
SKILL_DIR="<this skill의 기본 디렉토리>" # Claude Code가 "이 스킬의 기본 디렉토리"로 출력한 경로
KIT=$(python3 -c 'import os,sys;print(os.path.realpath(os.path.join(sys.argv[1],"..","..","kit")))' "$SKILL_DIR")
PY="$KIT/.venv/bin/python"; [ -x "$PY" ] || bash "$KIT/setup.sh" --cutout
GROQ_API_KEY가 전사를 위해 설정되어 있어야 합니다 (console.groq.com에서 무료로 받을 수 있음). ffmpeg와 Node가 필요합니다.
포맷
모든 스펙은 "format"을 받습니다: "vertical" (1080×1920: 릴, 쇼츠, 세로 장편), "horizontal" (1920×1080: YouTube 및 기타 장편) 또는 "auto" (기본값: 원본 영상의 비율을 따름). "$PY" "$KIT/reel.py" probe <video>를 실행하면 auto가 무엇을 선택하는지 알 수 있습니다. 시트는 플랫폼이 가리는 영역을 빨간색으로 표시합니다: 세로에서는 Instagram/TikTok UI, 가로에서는 YouTube 플레이어 크롬. 전체 길이 비디오의 경우, 이 스킬을 직접 클립을 자르는 대신 /long-form 내의 순간(moment) 으로 사용하세요.
단계
- 클립. 사용자가 제공한 클립을 사용합니다 (모든 크기 가능; 1080×1920 또는 1920×1080으로 자름, 포맷 참조). 제공된 클립이 없을 때만 요청합니다.
- 단어.
"$PY" "$KIT/reel.py" words <video>는 각 단어와 시간을 출력합니다 (첫 사용 시 전사). 한 문장씩[ends …]와 함께 마지막 단어의 종료 시간을 출력합니다. 하나의 요점을 전달하는 3~8초 길이의 구간을 선택하되, 완전한 문장으로 구성합니다:start는 첫 단어의 시간이고end는 마지막 문장의[ends …]시간입니다 (원본 비디오 초). - 눈높이.
"$PY" "$KIT/reel.py" frame <video> <구간 내 시간> frame.jpg를 실행한 다음 이미지를 확인합니다. 눈금자는 캔버스 픽셀 단위이며, 눈의 y 좌표를 읽습니다. 이것이eye_y입니다 (세로: 일반 프레이밍의 경우 약 700800; 가로: 약 350450). 가로에서는 얼굴 중심의 x 좌표도 읽습니다: 이것이face_x입니다. - 스펙. 클립 옆에
<clip name>.explainer.json을 작성합니다 (필드 아래 참조). 스펙 내 경로는 스펙 파일 기준 상대 경로입니다. 모든 시간은start로부터의 초 또는 기준이 되는 단어입니다 (예:"viral","viral#2"(두 번째 등장),"viral+0.2"). 단어를 선호하세요:start를 이동해도 올바르게 유지됩니다. - 빌드.
"$PY" "$SKILL_DIR/build.py" <spec.json>을 실행합니다. 구간을 자르고, 화자를 분리하고(프레임당 약 0.1초), HyperFrames로 렌더링하고<out>.sheet.jpg를 씁니다. - 확인. 시트를 확인합니다. 빨간색은 플랫폼이 가리는 영역입니다. 다음 경우 스펙을 수정하고 다시 빌드합니다:
- 제목이나 시각 자료가 빨간 영역에 있는 경우
- 자막이 입을 가리거나 빨간 하단 영역에서 80px 이내인 경우 (
caption_top이동) - 자막이 구간 밖의 단어를 표시하는 경우 (
start또는end를 문장 경계로 이동) - 머리가 패널 위로 튀어나오지 않는 경우 (
eye_y이동) - 이미지가 누락되었거나 찌그러진 경우
- 전달 mp4 경로와 각 시각 자료가 보여주는 내용을 한 줄로 설명합니다.
스펙
{
"video": "my-clip.mp4", "start": 21.4, "end": 25.66, "out": "my-clip.speaker.mp4",
"title": "Steal what *works*",
"eye_y": 750,
"visual": {
"type": "compare",
"left": {"label": "Another niche", "images": ["theirs-1.jpg", "theirs-2.jpg", "theirs-3.jpg"], "at": 0.3,
"chip": "14× viral", "chip_at": "viral", "swipe_at": ["carousel", 2.3]},
"right": {"label": "Your niche", "at": "outside", "reveal_at": "recreate",
"image": "my-photo.jpg", "text": "the best *ai tools*\nto use when\nyou're *young and broke*"},
"arrow_at": "and"
},
"keys": ["viral", "outside", "recreate"],
"caption_top": 1420
}
title: 1~4 단어. 악센트 색상을 위해 한 단어를*...*로 감쌉니다.visual.type: "compare"는 전후 비교입니다:- 왼쪽 카드는 1~3개의 이미지를 보여주고
swipe_at에서 이미지를 전환합니다. - 오른쪽 카드는 점선 "?"로 시작합니다. 화살표가
arrow_at에서 그려지고, 그 다음 카드가reveal_at에서 나타납니다. - 오른쪽 카드는 단순한
image이거나,image와text로 구성된 캐러셀 커버입니다 (*word*는 악센트 필 위에 표시되고,\n은 줄 바꿈).
- 왼쪽 카드는 1~3개의 이미지를 보여주고
- 각 카드는 이미지 대신 텍스트 카드가 될 수 있습니다:
"big": "*Pro*\ntools", "small": "what pros use". 사용자에게 이미지가 없을 때 사용합니다. 화자가 가리키는 좌우 비교에 적합한 선택입니다. visual.type: "list":{"type": "list", "items": [{"text": "Find a *viral* post", "at": "find"}, ...]}. 최대 4개의 번호 행, 각각 말할 때 나타납니다.keys: 악센트 필 위에 표시할 단어들. 의미를 전달하는 2~4개를 선택합니다. 단어가 말해질 때마다 강조 표시됩니다.- 가로 전용:
face_x(패널 내 얼굴 중앙 정렬),side("right"기본값, 또는"left"),scale(0.9: 화자가 그려지는 크기). caption_top: 자막 상단의 y 좌표: 세로 1420 (하단이 1500 이상 유지), 가로 850 (패널 위에 위치; 하단이 960 이상 유지).
취향
- 클립당 하나의 요점. 구간이 두 가지 요점을 포함한다면, 두 개의 explainer를 만드세요.
- 각 시각 자료를 해당 단어가 말해지는 시점에 나타내세요. 어떤 것도 말해지기 전에 나타나서는 안 됩니다. 제목은 예외입니다: 첫 프레임부터 표시됩니다.
- 세로: 상단 시각 자료를 y 330
760 사이에 유지하세요 (제목은 그 위, 약 210에 위치). 가로: 제목은 y 110에, 시각 자료는 y 270830 사이에 패널 옆에 위치합니다. 텍스트와 그래픽은 빨간 영역 밖에 있어야 합니다. 화자 패널은 빨간 영역에 걸쳐도 괜찮습니다. - 화자가 왼쪽과 오른쪽을 가리키는 경우
compare를 사용하세요. 카드는 그들이 가리키는 위치에 배치됩니다. - 사용자 자신의 이미지를 사용하세요. 다른 사람의 게시물에 대한 숫자나 결과를 임의로 만들지 마세요. "14× viral"과 같은 칩은 사용자가 말하거나 제공한 내용이어야 합니다.